Metrics
The Apstra Flow collector 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. See the Prometheus documentation to learn more.
This topic describes the type of statistics you can retrieve from the
/metrics
endpoint in Apstra Flow.
app_info
app_info
statistic shows the
application details. For example:
app_info{arch="arm64",cpus="8",env="native",hostname="M1-MacBook-Pro.local",os="darwin",run_id="b1214e11-198f-43e7-81f1-c9986e9b3ff7"} 1
Label | Description |
---|---|
arch |
The environment running the application. |
cpus |
The number of available CPUs. |
env |
Native install or Docker install. |
hostname |
The name of machine. |
os |
The operating system running the application. |
run_id |
The application ID. |
License Units
The license_units
statistic shows details on your Apstra
license. For example:
license_units{account_id="",expiration="0",level="0",riskiq_disabled="false"} 1
This record contains the following labels:
Label | Description |
---|---|
account_id |
The license account ID. |
expiration |
The license expiration date. |
level |
The license level. |
riskiq_disabled |
riskiq is disabled for the license. |
Flow UDP Server
udp_server_packet_queue_util
The udp_server_packet_queue_util
statistic shows the utilization
of the packet queue that stores received packets waiting to be processed. For
example:
udp_server_packet_queue_util{application="flowcoll"} 0
This record contains the following label:
Label | Description |
---|---|
application |
The name of the application. |
udp_server_packets_received_total
The udp_server_packets_received_total
statistic shows the total
count of packets received by the UDP server. For example:
udp_server_packets_received_total{application="flowcoll",port="9995"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
port |
The port on which the UDP server listens. |
udp_server_bytes_received_total
The udp_server_bytes_received_total
statistic provides the total
count of bytes received by the UDP server.
udp_server_bytes_received_total{application="flowcoll",port="9995"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
Name of the application. |
port |
Port on which the UDP server listens. |
Processor
record_queue_util
The record_queue_util
statistic shows the ratio of the
record queue size divided by its capacity. For example:
record_queue_util{application="flowcoll"} 0
This record contains the following label:
Label | Description |
---|---|
application |
The name of the application. |
OpenSearch Output
- outputs_records_received_total
- outputs_records_sent_total
- outputs_bulk_requests_total
- outputs_bulk_requests_errored_total
- outputs_records_errored_total
outputs_records_received_total
The outputs_records_received_total
statistic shows the total
number of records received by the output. For example:
outputs_records_received_total{application="flowcoll",namespace="default",output="opensearch"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
namespace |
The name of the namespace. |
output |
The name of the output. |
outputs_records_sent_total
The outputs_records_sent_total
statistic shows the total number
of records sent by the output. For example:
outputs_records_sent_total{application="flowcoll",namespace="default",output="opensearch"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
namespace |
The name of the namespace. |
output |
The name of the output. |
outputs_bulk_requests_total
The outputs_bulk_requests_total
statistic shows the total count
of bulk requests sent by the output. For example:
outputs_bulk_requests_total{application="flowcoll",namespace="default",output="opensearch"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
namespace |
The name of the namespace. |
output |
The name of the output. |
outputs_bulk_requests_errored_total
The outputs_bulk_requests_errored_total
statistic shows the
total count of errored bulk requests. For example:
outputs_bulk_requests_errored_total{application="flowcoll",namespace="default",output="opensearch"} 0The outputs_bulk_requests_errored_total
record provides the following labels:
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
namespace |
The name of the namespace. |
output |
The name of the output. |
outputs_records_errored_total
The outputs_records_errored_total
statistic shows the total
count of errored records. For example:
outputs_records_errored_total{application="flowcoll",namespace="default",output="opensearch"} 0
This record contains the following labels:
Label | Description |
---|---|
application |
The name of the application. |
namespace |
The name of the namespace. |
output |
The name of the output. |