::nsmcp::Object ::nsmcp::Object dict getdef ::nsmcp::AccessLogIngestor ::nsmcp::AccessLogIngestor ingest ingestLocked init initial locateRecent recentState refresh retentionCutoff sample summaryLocked validateWindow ::nsmcp::AccessLogIngestor->::nsmcp::Object ::nsmcp::AccessAnalytics ::nsmcp::AccessAnalytics accumulate correlateWarnings drop ingestLocked init maintain peerSchema publish rejected state summary validateWindow ::nsmcp::AccessAnalytics->::nsmcp::AccessLogIngestor ::nsmcp::UnifiedAccessAnalytics ::nsmcp::UnifiedAccessAnalytics correlateWarnings ingest ingestionStatus init initializeSource peerSchema refresh refreshLocked retain retentionStatus retentionTick retireLegacy state summary summaryLocked ::nsmcp::UnifiedAccessAnalytics->::nsmcp::AccessAnalytics

Class ::nsmcp::AccessLogIngestor

::nsmcp::AccessLogIngestor[i] create ... \
           [ -maxLineBytes:integer (default "65536") ] \
           [ -maxReadBytes:integer (default "16777216") ] \
           [ -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::Object[i]
  • subclass: ::nsmcp::AccessAnalytics[i]

Methods (to be applied on instances)

  • ingest (scripted, public)

     <instance of nsmcp::AccessLogIngestor[i]> ingest [ from ] \
    [ allowHistory ]

    Ingest a bounded portion of the configured access logs. Validate the starting timestamp and serialize ingestion with the instance mutex; historical work is optional.

    Parameters:
    from (optional)
    Earliest epoch-second timestamp to ingest; empty uses the default recent window.
    allowHistory (optional, defaults to "false")
    Whether this pass may process historical sources. Defaults to 'false'.
    Returns:
    The ingestion result returned by the locked ingestion pass.

    Testcases:
    No testcase defined.

  • refresh (scripted, public)

     <instance of nsmcp::AccessLogIngestor[i]> refresh

    Run the scheduled bounded ingestion callback. Permit historical work and log ingestion failures without allowing a scheduler exception to escape.

    Returns:
    An empty callback result.

    Testcases:
    No testcase defined.

  • validateWindow (scripted, public)

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

    Validate and resolve an access-summary time window. Apply supported-option checks, timestamp bounds and bucket-size limits before querying the cache.

    Parameters:
    options (required)
    Tcl dictionary containing the operation options.
    Returns:
    The normalized window-options dictionary.

    Testcases:
    No testcase defined.