---

Class ::nsmcp::LogErrorSummaryTool

::nsmcp::LogErrorSummaryTool create ... \
           [ -description (default "Summarize system-log Error, Fatal and Bug records in a time window, with 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. Recognizes stderr mutex traces and short startup entries separately via coverage.mutexTraceRecords, shortLogRecords and untimestampedExamples. 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 "{} object {type string object properties object {
        period object {type string string enum array {0 string today 1 string yesterday}}
        timezone object {type string string}
        lastMinutes object {type string integer minimum number 1 maximum number 10080}
        from object {type string integer minimum number 0}
        to object {type string integer minimum number 1}
        maxGroups object {type string integer minimum number 1 maximum number 50}
    } additionalProperties boolean 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.tcl

Class Relations

• class: ::nx::Class
• superclass: ::nsmcp::Tool

::nx::Class create ::nsmcp::LogErrorSummaryTool \
     -superclass ::nsmcp::Tool

---