::nsmcp::LogErrorSummaryTool![[i]](/resources/acs-subsite/ZoomIn16.gif)
create ... \
[ -adminExample (default "") ] \
[ -adminSummary (default "") ] \
[ -description (default "Summarize selected system-log severities in a time window; defaults to Error, Fatal and Bug. Set severities to ["Warning"] for warning analysis or combine Warning with Error/Fatal/Bug. Severity labels are logging classifications, not an independent incident assessment. Canonicalizes duplicate-parameter warnings, ranks up to 512 counted groups before the output limit, and distinguishes ungroupedRecords from omittedGroupRecords. Reports physical repeat markers and suppressed-occurrence accounting without assigning suppressed events to the marker window. Completed duplicate groups can include bounded, address-free access-cache correlation; missing evidence and User-Agents are unknown, not proof of human or bot activity. Returns grouped counts, first/last occurrence, redacted examples and coverage. Prefer this for daily error summaries instead of paging all log_errors records. Defaults to today in UTC; period today/yesterday may use an explicit timezone, or use lastMinutes or from/to (exclusive end). Current log only; rotations are not examined. coverage.logBounds reports first/last file-order and earliest/latest observed epoch timestamps and offsets across all timestamped severities, not just matching errors. coverage.rotation distinguishes configured signal/filename settings from unknown schedule and last verified rotation time. Observed bounds never certify complete window coverage. Returns explicit severityTotals independently of maxGroups. coverage.unrecognizedRecords counts unrecognized system-log entries; coverage.unrecognizedExamples provides up to five redacted examples with byte offsets. Expected ns:sched unlock/hold traces are omitted. Other stderr mutex traces have coverage.mutexTraceRecords and mutexTraceGroups with counts, minimum/maximum/mean seconds, offsets and maximum-duration thread; mutexTraceUngroupedRecords accounts for the 128-group bound. These groups aggregate all scanned traces, not just the five untimestampedExamples. Do not infer a file-wide distribution from examples or call a duration proof of contention. Short startup entries are reported separately via shortLogRecords. Recognizes PostgreSQL diagnostics with grouped DETAIL/HINT/CONTEXT via postgresRecords and postgresExamples. Neighboring timestamps are explicitly labeled inferred-neighbors; they are contextual bounds, not guaranteed event times. These diagnostic counters cover the scanned file; inferred times never enter window totals. Mutex traces are not errors; untimestamped Error/Fatal/Bug entries are reported as unknownTimeErrors rather than included in window totals. Scans the current file in resumable chunks with fixed bounds; running jobs report progress.examinedBytes and progress.sourceBytes. Runs asynchronously: poll log_results with jobHandle until complete; the completed result is the summary and has no record pages. Grouping is heuristic and bounded; report ungroupedRecords and coverage limitations.") ] \
[ -inputSchema (default "
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"today",
"yesterday"
]
},
"timezone": {
"type": "string"
},
"lastMinutes": {
"type": "integer",
"minimum": 1,
"maximum": 10080
},
"from": {
"type": "integer",
"minimum": 0
},
"to": {
"type": "integer",
"minimum": 1
},
"maxGroups": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"severities": {
"type": "array",
"minItems": 1,
"maxItems": 4,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"Warning",
"Error",
"Fatal",
"Bug"
]
}
}
},
"additionalProperties": false
}
") ] \
[ -name (default "log_error_summary") ] \
[ -outputSchema (default "") ] \
[ -permission (default "diagnostics.logs.read") ] \
[ -service:required service:required ]
Defined in /usr/local/ns/tcl/nsmcp/log-summary.tclClass Relations
- class: ::nx::Class
- superclass: ::nsmcp::Tool
Methods (to be applied on instances)
