Skip to main content
Version: development

Flow Metrics

Aperture Agents emit an OpenTelemetry stream for flow data, which provides a comprehensive view of individual requests or features within services. This stream contains high-cardinality attributes that represent key attributes of the requests and features, allowing for a detailed analysis of system performance and behavior. The stream can be stored and visualized in Aperture Cloud, or ingested into popular OLAP databases such as Apache Druid.

Dimension Columns

Common

NameTypeExample ValuesDescriptionFlow Control Integrations
aperture.sourcesinglesdk, envoyAperture Flow sourceSDKs, Envoy
aperture.decision_typesingleDECISION_TYPE_ACCEPTED, DECISION_TYPE_REJECTEDDecision type taken by policySDKs, Envoy
aperture.reject_reasonsingleREJECT_REASON_NONE, REJECT_REASON_RATE_LIMITED, REJECT_REASON_NO_TOKENS, REJECT_REASON_NOT_SAMPLEDReject reason of the decision taken by policySDKs, Envoy
aperture.rate_limitersmulti-value"policy_name:s1, component_id:18, policy_hash:5kZjj"Rate limiters matched to the trafficSDKs, Envoy
aperture.dropping_rate_limitersmulti-value"policy_name:s1, component_id:18, policy_hash:5kZjj"Rate limiters dropping the trafficSDKs, Envoy
aperture.load_schedulersmulti-value"policy_name:s1, component_id:13, policy_hash:5kZjj"Concurrency limiters matched to the trafficSDKs, Envoy
aperture.dropping_load_schedulersmulti-value"policy_name:s1, component_id:13, policy_hash:5kZjj"Concurrency limiters dropping the trafficSDKs, Envoy
aperture.samplersmulti-value"policy_name:s1, component_id:18, policy_hash:5kZjj"Samplers matched to the trafficSDKs, Envoy
aperture.dropping_samplersmulti-value"policy_name:s1, component_id:18, policy_hash:5kZjj"Samplers dropping the trafficSDKs, Envoy
aperture.workloadsmulti-value"policy_name:s1, component_id:13, workload_index:0, policy_hash:5kZjj"Workloads matched to the trafficSDKs, Envoy
aperture.dropping_workloadsmulti-value"policy_name:s1, component_id:13, workload_index:0, policy_hash:5kZjj"Workloads dropping the trafficSDKs, Envoy
aperture.flux_metersmulti-values1Flux Meters matched to the trafficSDKs, Envoy
aperture.flow_label_keysmulti-valuehttp.host, http.method, http.request.header.content_lengthFlow labels matched to the trafficSDKs, Envoy
aperture.classifiersmulti-value"policy_name:s1, classifier_index:0"Classifiers matched to the trafficSDKs, Envoy
aperture.classifier_errorsmulti-value"[ERROR_NONE, ERROR_EVAL_FAILED, ERROR_EMPTY_RESULTSET, ERROR_AMBIGUOUS_RESULTSET, ERROR_MULTI_EXPRESSION, ERROR_EXPRESSION_NOT_MAP], policy_name:s1, classifier_index:0"Encountered classifier errors for specified policySDKs, Envoy
aperture.servicesmulti-values1.demoapp.svc.cluster.local, s2.demoapp.svc.cluster.localServices to which metrics referSDKs, Envoy
aperture.control_pointsingletype:TYPE_INGRESS, type:TYPE_EGRESSControl point to which metrics referSDKs, Envoy
aperture.flow.statussingleOK, ErrorDenotes OK or Error across all protocolsSDKs, Envoy
response_receivedsingletrue, falseDesignates whether a response was receivedSDKs, Envoy

HTTP

NameTypeExample ValuesDescriptionFlow Control Integrations
http.status_codesingle200, 429, 503HTTP status code of the responseEnvoy
http.request_content_lengthsingle0, 53Length of the HTTP request content in bytesEnvoy
http.response_content_lengthsingle201, 77Length of the HTTP response content in bytesEnvoy
http.methodsingleGET, POSTHTTP method of the responseEnvoy
http.targetsingle/requestTarget endpoint of the responseEnvoy
http.hostsingles1.demoapp.svc.cluster.local, s2.demoapp.svc.cluster.localHost address of the responseEnvoy
http.schemesinglehttpHTTP scheme of the responseEnvoy
http.flavorsingle1.1HTTP protocol versionEnvoy
{user-defined-labels}Configured through ClassifierEnvoy

SDK

NameTypeExample ValuesDescriptionFlow Control Integrations
aperture.cache_lookup_statussingleHIT, MISSResult of result cache lookupSDKs
aperture.cache_operation_statussingleSUCCESS, ERRORResult of result cache operationSDKs
aperture.global_cache_lookup_statusesmulti-valueHIT, MISSResults of global cache lookupsSDKs
aperture.global_cache_operation_statusesmulti-valueSUCCESS, ERRORResults of global cache operationsSDKs
{user-defined-labels}Explicitly passed through FlowStart call in SDKsSDKs

Metric Columns

NameTypeUnitDescription
workload_duration_ms_sumfloatmsSum of duration of the workload
workload_duration_ms_minfloatmsMin of duration of the workload
workload_duration_ms_maxfloatmsMax of duration of the workload
workload_duration_ms_sumOfSquaresfloatmsSum of squares of duration of the workload
workload_duration_ms_datasketchquantilesDoubleSketchmsDatasktech of Duration of the workload
flow_duration_ms_sumfloatmsSum of duration of the flow
flow_duration_ms_minfloatmsMin of duration of the flow
flow_duration_ms_maxfloatmsMax of duration of the flow
flow_duration_ms_sumOfSquaresfloatmsSum of squares of duration of the flow
flow_duration_ms_datasketchquantilesDoubleSketchmsSum of Aperture's processing duration
aperture_processing_duration_ms_minfloatmsMin of Aperture's processing duration
aperture_processing_duration_ms_maxfloatmsMax of Aperture's processing duration
aperture_processing_duration_ms_sumOfSquaresfloatmsSum of squares of Aperture's processing duration
aperture_processing_duration_ms_datasketchquantilesDoubleSketchmsDatasktech of Aperture's processing duration
http.request_content_length_sumintbytesSum of length of the HTTP request content
http.request_content_length_minintbytesMin of length of the HTTP request content
http.request_content_length_maxintbytesMax of length of the HTTP request content
http.request_content_length_sumOfSquaresintbytesSum of squares of length of the HTTP request content
http.response_content_length_sumintbytesSum of length of the HTTP response content
http.response_content_length_minintbytesMin of length of the HTTP response content
http.response_content_length_maxintbytesMax of length of the HTTP response content
http.response_content_length_sumOfSquaresintbytesSum of squares of length of the HTTP response content