Agent Status Telemetry

The Agent Status telemetry captures the agent's operational heartbeat, providing a clear snapshot of runtime health. It reports key metrics such as CPU utilization, memory footprint, cache performance, flow table activity, packet throughput, and overall uptime, all in a single, structured record. These metrics give you immediate insight into how the engine performs under current network conditions.

Requirements

Install and configure the Netify Agent
Install and configure a Sink Plugin for receiving the telemetry
Install and configure the Core Plugin and add stream-stats to types

Source: Core Plugin
Plugin Release: 1.0.20

Optimizations

Time-series analysis transforms these records into actionable insights. Early detection of patterns like abnormal CPU growth or cache lag allows teams to preemptively resolve bottlenecks, preserving high-quality detection and total flow visibility.

Attributes

agent_version

string

Semantic version of the running Netify Agent.

build_version

string

Full agent build string including platform and enabled feature flags.

cpu_cores

integer

Number of CPU cores available to the agent process.

cpu_system

number

Current cumulative system CPU usage reported by the agent.

cpu_system_prev

number

Previous system CPU usage sample.

cpu_user

number

Current cumulative user CPU usage reported by the agent.

cpu_user_prev

number

Previous user CPU usage sample.

dhc_status

boolean

Status flag for the DNS hint cache subsystem.

fhc_status

boolean

Status flag for the flow hash cache subsystem.

flow_count

integer

Current number of tracked flows.

flow_count_prev

integer

Previous tracked flow count sample.

flows_active

integer

Number of active flows.

flows_expired

integer

Number of flows that have expired.

flows_expiring

integer

Number of flows currently in the process of expiring.

flows_in_use

integer

Number of flow table entries currently in use.

flows_purged

integer

Number of flows purged by maintenance routines.

maxrss_kb

integer

Current high-water resident set size in kilobytes.

maxrss_kb_prev

integer

Previous high-water resident set size sample in kilobytes.

memrss_kb

integer

Current resident memory usage in kilobytes.

memrss_kb_prev

integer

Previous resident memory usage sample in kilobytes.

tcm_kb

integer

Current TCMalloc-managed memory in kilobytes.

tcm_kb_prev

integer

Previous TCMalloc-managed memory sample in kilobytes.

timestamp

integer

Unix epoch timestamp (seconds) when the status record was generated.

type

string

Telemetry record type. Always agent_status.

update_imf

integer

Internal update indicator for incremental maintenance/metrics refresh.

update_interval

integer

Status publication interval in seconds.

uptime

integer

Agent uptime in seconds.

Agent Status Attributes - Example

{
  "agent_version": "5.2.0",
  "build_version": "Netify Agent/5.2.0-...",
  "cpu_cores": 8,
  "cpu_system": 3.148931,
  "cpu_system_prev": 3.134846,
  "cpu_user": 6.237091,
  "cpu_user_prev": 6.206476,
  "dhc_status": true,
  "fhc_status": true,
  "flow_count": 140,
  "flow_count_prev": 135,
  "flows_active": 55,
  "flows_expired": 21,
  "flows_expiring": 0,
  "flows_in_use": 120,
  "flows_purged": 11,
  "maxrss_kb": 85504,
  "maxrss_kb_prev": 85504,
  "memrss_kb": 84508,
  "memrss_kb_prev": 84380,
  "tcm_kb": 48141,
  "tcm_kb_prev": 48076,
  "timestamp": 1772661775,
  "type": "agent_status",
  "update_imf": 1,
  "update_interval": 15,
  "uptime": 1740
}