Filter metrics#
Overview#
Introduction#
A Packet Inspector 1 filter exposes metrics that you can scrape using Prometheus.
Note
Some metrics are not available in all versions of Aspen Mesh.
Metric endpoint configuration#
Envoy proxy metrics are available at the following endpoint.
Port |
Endpoint |
|---|---|
15090 |
/stats/prometheus |
Metric types#
Metric types are defined by Prometheus. Learn about Prometheus metric types.
Diameter communication#
About Diameter communication#
In the Diameter protocol, the client opens the communication, but both the client and server can send requests and receive answers.
Diameter communication diagram#
This diagram shows the components involved in Diameter communication and defines the downstream and upstream directions referred to in the Diameter metrics:
Envoy terminology#
This table defines Envoy terminology used in the Diameter filter metrics:
Term |
Definition |
|---|---|
Downstream host |
A client-side entity that connects to an Envoy proxy. |
Upstream host |
A server-side entity that an Envoy proxy connects to. |
Metrics#
envoy_aspenmesh_packet_inspector_requests_total_backpressure_dropped (1.14.6-am1 and later)#
Description#
The number of gRPC requests that were dropped in the filter due to excess outstanding requests to the aggregator service
Type#
Counter
envoy_aspenmesh_packet_inspector_requests_total_dropped#
Description#
The number of gRPC requests dropped between a filter and the aggregator service due to connection issues
Type#
Counter
envoy_aspenmesh_packet_inspector_requests_total_sent#
Description#
The number of gRPC requests sent by a filter to the aggregator service
Type#
Counter
envoy_aspenmesh_packet_inspector_stream_error#
Description#
The number of attempts to start an gRPC stream between a filter and the aggregator service that resulted in an error
Type#
Counter
envoy_aspenmesh_packet_inspector_stream_reset#
Description#
The number of times an active gRPC stream between a filter and the aggregator service was reset
Type#
Counter
envoy_aspenmesh_packet_inspector_stream_start#
Description#
The number of gRPC streams started between a filter and the aggregator service
Type#
Counter
envoy_f5_diameter_connections_established_total (1.14.6-am1 and later)#
Description#
The number of established Diameter connections that have been observed by a filter
Type#
Counter
envoy_f5_diameter_downstream_answers_total (1.14.6-am1 and later)#
Description#
The number of Diameter Answer messages received by a filter from the downstream host
Type#
Counter
envoy_f5_diameter_downstream_buffer_discards_total (1.14.6-am6 only)#
Description#
The number of times a filter discarded all or part of a downstream data buffer due to traffic that was not recognized as Diameter. When a filter discards data, the delivery to the server is not affected, but the filter does not forward the data to the aggregator service.
Type#
Counter
envoy_f5_diameter_downstream_parse_failures_total (1.14.6-am6 only)#
Description#
The number of downstream Diameter messages received by a filter whose key Attribute-Value Pair (AVP) payloads the filter wasn’t able to parse. When a filter can’t parse a downstream message, the delivery to the server is not affected, and the filter forwards the potentially incomplete message to the aggregator service.
Type#
Counter
envoy_f5_diameter_downstream_partial_messages_total (1.14.6-am1 and later)#
Description#
The number of partial Diameter messages received by a filter from the downstream host. Additional data from the socket is required to complete a full Diameter message.
Type#
Counter
envoy_f5_diameter_downstream_requests_total (1.14.6-am1 and later)#
Description#
The number of Diameter Request messages received by a filter from the downstream host
Type#
Counter
envoy_f5_diameter_grpc_requests_backpressure_dropped_total (1.14.6-am1 and later)#
Description#
The number of Diameter messages that were dropped in the filter due to excess outstanding requests to the aggregator service
Type#
Counter
envoy_f5_diameter_grpc_requests_dropped_total (1.14.6-am1 and later)#
Description#
The number of Diameter messages that were dropped in a filter. This is likely due to an issue connecting to the aggregator service.
Type#
Counter
envoy_f5_diameter_grpc_requests_sent_total (1.14.6-am1 and later)#
Description#
The number of Diameter messages that were sent as gRPC requests to the aggregator service. This does not imply that they were successfully received by the aggregator service.
Type#
Counter
envoy_f5_diameter_grpc_stream_resets_total (1.14.6-am1 and later)#
Description#
The number of times the gRPC stream between a filter and the aggregator service was reset
Type#
Counter
envoy_f5_diameter_grpc_stream_starts_total (1.14.6-am1 and later)#
Description#
The number of times a gRPC stream was started from a filter to the aggregator service
Type#
Counter
envoy_f5_diameter_upstream_answers_total (1.14.6-am1 and later)#
Description#
The number of Diameter Answer messages received by a filter from the upstream host
Type#
Counter
envoy_f5_diameter_upstream_buffer_discards_total (1.14.6-am6 only)#
Description#
The number of times a filter discarded all or part of an upstream data buffer due to traffic that was not recognized as Diameter. When a filter discards data, the delivery to the client is not affected, but the filter does not forward the data to the aggregator service.
Type#
Counter
envoy_f5_diameter_upstream_parse_failures_total (1.14.6-am6 only)#
Description#
The number of upstream Diameter messages received by a filter whose key Attribute-Value Pair (AVP) payloads the filter wasn’t able to parse. When a filter can’t parse an upstream message, the delivery to the client is not affected, and the filter forwards the potentially incomplete message to the aggregator service.
Type#
Counter
envoy_f5_diameter_upstream_partial_messages_total (1.14.6-am1 and later)#
Description#
The number of partial Diameter messages received by a filter from the upstream host. Additional data from the socket is required to complete a full Diameter message.
Type#
Counter
envoy_f5_diameter_upstream_requests_total (1.14.6-am1 and later)#
Description#
The number of Diameter Request messages received by a filter from the upstream host
Type#
Counter