To create a query you must add at least one metric and optional attributes.
Metrics are quantifiable values, such as the number of tickets, replies to tickets, and agent or customer wait times.
Attributes are non-quantifiable values, such as ticket ID, ticket tags, and assignee names.
There are many metrics and attributes that you can use for each Zendesk product. For information about these metrics and attributes, see Metric and attribute reference.
You add metrics in the Metrics panel of Query Builder. Explore automatically uses the sum of the metric's data. You can change how your metric is calculated by clicking the metric, then selecting a new aggregator, for example, an average value. For details, see Changing metric aggregators.
You can also select whether the metric results are measured in different size or colors, on a separate axis and visualization, or as datatips.
To add a metric to your query click Add in the Metrics panel. Your metric results will automatically appear on your query.
This section contains the following topics:
Measuring results by color and size
You can measure a metric's results in a color gradient or with different display sizes.
In the image below, Agent Replies has been added as a color-encoded metric. At the upper-right of the chart, you can see how results are distributed in the color gradient.
In the image below, Replies has been added as a size-encoded metric. At the upper-right of the chart you can see how results are distributed in the different sizes. Size-encoding options cannot be edited.
- In the Metrics panel, click the Color-encoding icon () or the Size-encoding icon ().
- Select the metric you want to color-encode, or size-encode..
- Click the chart configuration icon ().
- Click Colors.
- From the Color encoding drop-down list, choose a new style.
Adding a metric as a secondary axis
On some chart types, you can add a metric as a dual axis, or secondary axis. This is an easy way to compare metrics with different scales and separate results that would be difficult to analyze.
In the image, the Unresolved Unreplied Tickets metric uses a much smaller scale than the Agent Replies and Tickets metrics. As the image below shows, the results from this metric are difficult to view.
To make data easier to view, you can add Unresolved Unreplied Tickets as a dual axis. This displays the metric by its own scale and visualization as displayed below:
- In the Metrics panel, click the dual axis icon ().
- Select the metric you want to use for the dual axis.
Displaying a metric's result as a trend line
Similar to a dual axis, you can add a metric as a trend line to separate results. You can also display the trend for each metric by adding trend lines in Chart configuration> Trend line.
- In the Metrics panel, click the trend line icon ().
- Select the metric you want to add as a trend line.
You can edit trend line options, including hiding and displaying values in Chart configuration>Trend line.
Restricting metric results to datatips
If you do not want a particular metric to display on the query, but still want users to be able to see the data, you can add the metric as a datatip. Any results from the metric added as a datatip will appear when a user hovers over a data point. For more information on adding and customizing datatips, see Adding datatips to queries.
In the image below, only the replies metric is visible on the report, but when a viewer hovers over a data point, they can see the corresponding number of tickets results.
To add a metric as a datatip
- At the bottom of Metrics, click the datatips icon ().
- Select the metric you want to display as a datatip.
Using comparison lines to highlight metric results
Comparison lines can highlight multiple metric results for one value. When you add a comparison line, you can hover over any data point to view all results for the same X axis location. Comparison lines are useful when your attribute has several values, but your screen size cannot display each label.
- In the chart configuration menu (), select Datatips.
- Select Comparison line from the Mode drop-down list.
Attributes slice your data by non-quantifiable values. They can also be used to select or exclude results from your chart. You can choose values to display by clicking on the attribute after it is added.
Columns slice your results by the attribute's values in one chart. To add an attribute to the Columns panel, click Add, then select an attribute.
Below is an example with the attribute Ticket Created - Month added as a column.
If you add an attribute to the Rows panel, you can see individual charts for each of your attribute's values without selecting or excluding results. You can view a value using the Row Selector to the left your chart.
Below is an example of a report with the Ticket Status attribute added as a row. The value Closed is selected in the row selector.
Attributes added as filters enable you to select or exclude values to include in the query results. Results are filtered to the values you select, but the attribute names do not appear on your query. Instead, all your applied filters are listed underneath your report. This list includes any result manipulations you create.
For example, the results below are filtered by the Open ticket status, but the attribute name is not displayed on the report.
Similar to rows, attributes added to the Explosions panel break your report into individual charts based on the attribute's values. Unlike rows, explosions show all charts side-by-side. This provides a simple way to compare results, but if your attribute has several values, you should consider selecting values to display or using rows.