Metrics
NetObserv SNMP exposes the /metrics
endpoint to provide Prometheus-compatible statistics related to its performance and the resources it uses.
The endpoint returns data in a Prometheus text-based exposition format. Please refer to the Prometheus documentation to learn more.
Statistics
This section describes the statistics that can be retrieved from the /metrics
endpoint.
app_info
app_info
provides application details. The following is an example of an app_info
record:
app_info{arch="arm64",cpus="8",env="native",hostname="M1-MacBook-Pro.local",os="darwin",run_id="b1214e11-198f-43e7-81f1-c9986e9b3ff7"} 1
The app_info
data provides the following labels:
Label | Description |
---|---|
arch | environment running application |
cpus | number of cpus available |
env | native install or Docker |
hostname | name of machine |
instance_name | name of the collector instance |
os | operating system running application |
run_id | run id of application |
license_units
license_units
provides license details. The following is an example of a license_units
record:
license_units{account_id="",expiration="0",level="0"} 1
The license_units
record provides the following labels:
Label | Description |
---|---|
account_id | account id of license. |
expiration | license expiration date. |
instance_name | name of the collector instance |
level | license level. |
Polling
The following metrics are provided by the device poller.
snmp_input_poll_total
snmp_input_poll_total
provides the total count of device polls.
snmp_input_poll_total{application="snmpcoll",instance_name="default",poll_type="get"} 1
The snmp_input_poll_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
poll_type | SNMP poll operation type |
snmp_input_poll_err_total
snmp_input_poll_err_total
provides the total count of device poll errors.
snmp_input_poll_err_total{application="snmpcoll",instance_name="default",err="GenErr"} 1
The snmp_input_poll_err_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
err | SNMP poll error |
snmp_input_devices_scheduled_total
snmp_input_devices_scheduled_total
provides the total count of devices that are currently scheduled to be polled.
snmp_input_devices_scheduled_total{application="snmpcoll",instance_name="default"} 1
The snmp_input_devices_scheduled_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
snmp_input_objects_scheduled_total
snmp_input_objects_scheduled_total
provides the total count of objects that are currently scheduled to be polled.
snmp_input_objects_scheduled_total{application="snmpcoll",instance_name="default"} 2
The snmp_input_objects_scheduled_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
Processing
The following metrics are provided by the record processor.
snmp_processor_records_total
snmp_processor_records_total
provides the total count of records processed.
snmp_processor_records_total{application="snmpcoll",instance_name="default"} 2
The snmp_processor_records_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
snmp_processor_records_err_total
snmp_processor_records_err_total
provides the total count of records that errored during processing.
snmp_processor_records_err_total{application="snmpcoll",instance_name="default"} 0
The snmp_processor_records_err_total
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |
snmp_processor_record_queue_util
snmp_processor_record_queue_util
provides the record queue size to capacity ratio (queue utilization).
snmp_processor_record_queue_util{application="snmpcoll",instance_name="default"} 0
The snmp_processor_record_queue_util
record provides the following labels:
Label | Description |
---|---|
application | name of the application. |
instance_name | name of the collector instance |