Overview

Composite metrics queries enhance your monitoring and analysis capabilities by allowing dynamic tagging of metrics at query time. This simplifies the process of adding new tags to your metrics, and requires no code changes. Use composite metrics queries to enable more meaningful and actionable insights from your metric data.

Using composite metrics queries, you can accomplish the following:

• Build context-rich dashboards. Use Reference Tables to append more contextual tags such as team or organization to your metrics.
• Simplify troubleshooting. Alias opaque tag values (for example, IDs or codes) to human-readable values, reducing cognitive effort and resolution time.
  
  

Setup

1. Create any metric query with space aggregation (one or more tags are selected to group by).

2. Select the Join button (next to the Formulas button) as shown below:

3. Specify the type of join and the reference table that you want to join with your metrics.

4. Define the join condition with the existing tag from your query (for example, team) and the column in your reference table to be used for the join.

5. Select columns from the reference table to represent the aliased or new tags that you want to add to your existing query.

Further reading

Additional helpful documentation, links, and articles:

Reference TablesDOCUMENTATION