The Apdex score helps you understand how the response time of a service compares to the predefined response time threshold. See Configure Apdex Settings for details.
You can query data, create charts, and create alerts using the
Use the basic or advanced query format.
- Basic apdex() queries are simple to use and don’t require
hs()(histograms query) knowledge. These queries give you results for a specific application and service.
- Advanced apdex() queries let you specify advanced
hs()queries. You can also query Apdex data for more than one application or service.
apdex([T, | T, 4T,] application=<application_name>, service=<service_name>)
apdex([T, | T, 4T,] <histogram_series>) apdex(application=<application_name>, service=<service_name>, <histogram_series>)
||Name of the application you want to see data for.|
||Name of the service you want to see data for.|
Tolerating threshold. If you don't specify the value, the Wavefront service uses T*4.
Note: We don't save the value you define for the tolerating threshold (4T).The values are in microseconds. For example, if you enter 800, it indicates 800 microseconds.
You can use the basic or advanced
apdex() function to query the Apdex score. Tanzu Observability by Wavefront derives the Apdex score for each service. Therefore, you must specify the service you want to get the Apdex data.
The basic queries use
hs(tracing.aggregated.derived.*.duration.micros.m) as the underlying query to get the Apdex scores. See Aggregated RED Metrics. Basic queries only give you the Apdex score for a given service. Therefore, you need to specify the application and service filters.
The advanced queries let you customize the
hs() functions. You can get the Apdex score for more than one application using the advanced queries. Therefore, you can create alerts to find out when the Apdex score of the services in an application are below a specific range.
If histogram data is in milliseconds, you need to add the threshold value to the apdex function and divide the threshold value by 1000 to ensure that the threshold value is in milliseconds too.
apdex( T/1000, <histogram_series_in_milliseconds>)
Here’s how you can use these queries:
- Use a basic query to get the Apdex score of the
shoppingservice over time.
- Use an advanced query to return the Apdex score of all the services that send data to the Wavefront service every 30 minutes.
apdex(align(30m, merge(hs(tracing.aggregated.derived.*.duration.micros.m), application, service)))
- Use an advanced query to get the Apdex score of the
shoppingservice for the given time window (1vw). Let’s use a gauge chart.
apdex(align(1vw, merge(hs(tracing.aggregated.derived.*.m, application=beachshirts, service=delivery))))
The Wavefront service rounds the Apdex score to 2 decimal points so that it is easy for you to interpret the score. You need to update the gauge chart settings to get the color to value mapping and round the value to 2 decimal points.
- Get an overview of how the Apdex score is calculated and Configure Apdex Settings.
- Use apdexLatency() to query the satisfied threshold (T) and toleration threshold (4T) of a service.