Object ::nsmcp::history (public)

 ::nsmcp::ServerHistory ::nsmcp::history

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

• ::nsmcp::history validate /arguments/
• ::nsmcp::history execute /context/ /arguments/
• ::nsmcp::history permission
• ::nsmcp::history name
• ::nsmcp::history describe

Testcases:

No testcase defined.

Source code:

namespace eval ::nsmcp {}
::nsf::object::alloc ::nsmcp::ServerHistory ::nsmcp::history {set :adminExample {}
   set :adminSummary {}
   set :command ::ns_stats
   set :description {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.}
   set :inputSchema {{} object {type string object properties object {mode object {type string string enum array {0 string records 1 string summary} default string records} lastMinutes object {type string integer minimum number 1 maximum number 1440 default number 10} period object {type string string enum array {0 string previous-hour}} from object {type string integer minimum number 0 description string {Inclusive Unix epoch seconds}} to object {type string integer minimum number 1 description string {Exclusive Unix epoch seconds}} limit object {type string integer minimum number 1 maximum number 100 default number 100} cursor object {type string integer minimum number 0 description string {Paging timestamp in microseconds; requires explicit from/to}}} additionalProperties boolean false}}
   set :name server_history
   set :outputSchema {}
   set :permission diagnostics.runtime.read}

XQL Not present:

Generic, PostgreSQL, Oracle