---

Class ::nsmcp::ServerHistory

::nsmcp::ServerHistory create ... \
           [ -adminExample (default "") ] \
           [ -adminSummary (default "") ] \
           [ -command (default "::ns_stats") ] \
           [ -description (default "Query persisted ns_stats intervals for the authenticated server. For peak analysis use mode summary: up to 1000 samples per call aggregated into at most 128 metric series with ranges, unweighted sample means and peak interval bounds; cumulative counters are excluded. more=true requires following nextArguments; never treat sampling rates as one-second peaks. mode records (default) retains raw paging. Defaults to the last 10 completed minutes, with 100 records per page. Use lastMinutes, period previous-hour, or explicit from/to (Unix seconds; half-open interval, at most 24 hours). Return records, referenced topologies, persistence status and coverage including gaps, restarts, evictions and write failures. Never assume complete coverage from record count. Follow nextArguments unchanged for stable paging. Intermediate coverage describes a page; final coverage with windowExamined=true examines the entire requested window independently of cursor, including earlier-page gaps and resets. Inspect complete and incompleteReasons. storage reports global oldest/newest retained times, sample count and SQLite used/allocated bytes for retention sizing. Does not enable sampling or persistence. Requires separately configured ns_stats SQLite history. Process metrics remain process-wide.") ] \
           [ -inputSchema (default "
        {
            "type": "object",
            "properties": {
                "mode": {"type": "string", "enum": ["records", "summary"], "default": "records"},
                "lastMinutes": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1440,
                    "default": 10
                },
                "period": {
                    "type": "string",
                    "enum": [
                        "previous-hour"
                    ]
                },
                "from": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Inclusive Unix epoch seconds"
                },
                "to": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Exclusive Unix epoch seconds"
                },
                "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "default": 100
                },
                "cursor": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Paging timestamp in microseconds; requires explicit from/to"
                }
            },
            "additionalProperties": false
        }
    ") ] \
           [ -name (default "server_history") ] \
           [ -outputSchema (default "") ] \
           [ -permission (default "diagnostics.runtime.read") ]

Defined in /usr/local/ns/tcl/nsmcp/stats-tools.tcl

Class Relations

• class: ::nx::Class
• superclass: ::nsmcp::StatsTool

---