Skip to main content

Logs

Overview​

The SPIRL server outputs logs in JSON format to help monitor and troubleshoot server operations.

Loggers​

server.agentServer​

Logs for the server that receives agent connections.

  • gRPC server operations for agent API requests
  • SVID issuance and identity exchange

server.agentServer.session​

Logs for the agent session manager (nested under agentServer).

  • Session creation, verification, and management
  • Agent authentication workflows

server.ingestServiceSink​

Events collection logger. Events include agent check-ins, SVID issuance, and federation link polling.

  • Buffering and forwarding events to the Control Plane ingest service

server.subsystems​

Subsystem manager logger.

  • Lifecycle events (start/stop) for all managed subsystems
  • Management of components like
    • agentServer: primary gRPC server that handles requests from agents
    • statusCollector: collects operational status events and sends them to the Control Plane for persistence
    • federationPoller: polls federation links to fetch and update trust bundles
    • bundleLoader: synchronizes trust bundles into a cache

server.crbackend​

Custom Resource backend logger.

  • Kubernetes CR-based object store operations
  • Storing and retrieving data objects

server.configWatcher​

Configuration watcher logger.

  • Detects configuration changes

server.configUpdater​

Configuration updater logger.

  • Updating the configuration cache with new snapshots
  • Applying configuration overrides