Class ::nsmcp::AccessAnalytics

::nsmcp::AccessAnalytics[i] create ... \
           [ -database:required database:required ] \
           [ -evictionLimit:integer (default "64") ] \
           [ -maxLineBytes:integer (default "65536") ] \
           [ -maxReadBytes:integer (default "16777216") ] \
           [ -maxRows:integer (default "2000000") ] \
           [ -maxSeconds:integer (default "2") ] \
           [ -mutex (default "") ] \
           [ -parser (default "::nsmcp::accessRecordParser") ] \
           [ -path:required path:required ] \
           [ -retentionSeconds:double (default "86400") ]

Defined in /usr/local/ns/tcl/nsmcp/access-analytics.tcl

Class Relations

  • class: ::nx::Class[i]
  • superclass: ::nsmcp::AccessLogIngestor[i]
  • subclass: ::nsmcp::UnifiedAccessAnalytics[i]

Methods (to be applied on instances)

  • correlateWarnings (scripted, public)

     <instance of nsmcp::AccessAnalytics[i]> correlateWarnings samples \
        redactor

    Correlate bounded warning examples with retained access records. Use the existing start-time index only; do not scan raw logs or trigger ingestion or historical backfill. Peer addresses are never selected.

    Parameters:
    samples (required)
    Up to three dictionaries with requestIdentifier and timestamp; optional system-log User-Agent fields take precedence over the cached agent.
    redactor (required)
    Redactor object applied before returning diagnostic evidence.
    Returns:
    Rooted JSON triples with sampled evidence and explicit missing and ambiguous counts.

    Testcases:
    No testcase defined.
  • summary (scripted, public)

     <instance of nsmcp::AccessAnalytics[i]> summary options

    Summarize stored access traffic in one database snapshot. Compute coverage and aggregates together under the instance mutex, closing the session on every exit.

    Parameters:
    options (required)
    Tcl dictionary containing the operation options.
    Returns:
    The summary dictionary with aggregates and explicit coverage.

    Testcases:
    No testcase defined.
  • validateWindow (scripted, public)

     <instance of nsmcp::AccessAnalytics[i]> validateWindow options

    Validate summary windows and access-record filters. Keep supported filter options separate while the superclass validates time and bucket bounds.

    Parameters:
    options (required)
    Tcl dictionary containing the operation options.
    Returns:
    The normalized options dictionary, including retained filters.

    Testcases:
    No testcase defined.