> ## Documentation Index
> Fetch the complete documentation index at: https://axiom.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://axiom.co/docs/feedback

```json
{
  "path": "/query-data/visualizations",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Visualize

> Learn how to run powerful aggregations across your data to produce insights that are easy to understand and monitor.

Visualizations are powerful aggregations of your data to produce insights that are easy to understand and monitor. With visualizations, you can create and obtain data stats, group fields, and observe methods in running deployments.

This page introduces you to the visualizations supported by Axiom and some tips on how best to use them.

<Info>
  The visualizations explained on this page are only available for APL queries.

  To visualize metrics data, see [MPL language features](/mpl/introduction).
</Info>

## `count`

The `count` visualization counts all matching events and produces a time series chart.

#### Arguments

This visualization doesn’t take an argument.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`count` overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/count.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=501a8a338f01a20573fb83a9a3872acc" alt="`count` overview" width="2402" height="1478" data-path="doc-assets/shots/count.png" />
</Frame>

## `distinct`

The `distinct` visualization counts each distinct occurrence of the distinct field inside the dataset and produce a time series chart.

#### Arguments

`field: any` is the field to aggregate.

#### Group-By Behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`distinct` overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/distinct.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=fc9a55bfb19333925c5107d600c56d04" alt="`distinct` overview" width="2400" height="1462" data-path="doc-assets/shots/distinct.png" />
</Frame>

## `avg`

The `avg` visualization averages the values of the field inside the dataset and produces a time series chart.

#### Arguments

`field: number` is the number field to average.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`avg` overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/average.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=41dadddd853e77b4fd1f64669ee9b0bb" alt="`avg` overview" width="2344" height="1408" data-path="doc-assets/shots/average.png" />
</Frame>

## `max`

The `max` visualization finds the maximum value of the field inside the dataset and produces a time series chart.

#### Arguments

`field: number` is the number field where Axiom finds the maximum value.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="max overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/max.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=894d69acfbca08b045644fc2950a06fd" alt="max overview" width="2280" height="1504" data-path="doc-assets/shots/max.png" />
</Frame>

## `min`

The `min` visualization finds the minimum value of the field inside the dataset and produces a time series chart.

#### Arguments

`field: number` is the number field where Axiom finds the minimum value.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`min` overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/min.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=5d4483de3d846a0c681bbfdcb92c62f8" alt="`min` overview" width="2208" height="1500" data-path="doc-assets/shots/min.png" />
</Frame>

## `sum`

The `sum` visualization adds all the values of the field inside the dataset and produces a time series chart.

#### Arguments

`field: number` is the number field where Axiom calculates the sum.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`sum` overview">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/sum.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=5273bdf4914fc55767900877c8ad87f6" alt="`sum` overview" width="2280" height="1534" data-path="doc-assets/shots/sum.png" />
</Frame>

## `percentiles`

The `percentiles` visualization calculates the requested percentiles of the field in the dataset and produces a time series chart.

#### Arguments

* `field: number` is the number field where Axiom calculates the percentiles.
* `percentiles: number [, ...]` is a list of percentiles , each a float between 0 and 100. For example, `percentiles(request_size, 95, 99, 99.9)`.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a horizontal bar chart, allowing for visual comparison across the groups.

<Frame caption="`percentile` overview">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/percentile.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=ef8f946be13269a5c796aa5819312764" alt="`percentile` overview" width="2204" height="1492" data-path="doc-assets/shots/percentile.png" />
</Frame>

## `histogram`

The `histogram` visualization buckets the field into a distribution of N buckets, returning a time series heatmap chart.

#### Arguments

* `field: number` is the number field where Axiom calculates the distribution.
* `nBuckets` is the number of buckets to return. For example, `histogram(request_size, 15)`.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series histogram. Hovering over a group in the totals table shows only the results for that group in the histogram.

<Frame caption="`histogram` overview">
  <img src="https://mintcdn.com/axiom/ht_bivVnbPw26JRw/doc-assets/shots/histogram.png?fit=max&auto=format&n=ht_bivVnbPw26JRw&q=85&s=e59e27e6c0c9ee091650899934a4b1cd" alt="`histogram` overview" width="2134" height="1472" data-path="doc-assets/shots/histogram.png" />
</Frame>

## `topk`

The `topk` visualization calculates the top values for a field in a dataset.

#### Arguments

* `field: number` is the number field where Axiom calculates the top values.
* `nResults` is the number of top values to return. For example, `topk(method, 10)`.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`topk` overview">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/topk.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=66ea66bdadd73fcd33cd0d035b6b388b" alt="`topk` overview" width="2304" height="1190" data-path="doc-assets/shots/topk.png" />
</Frame>

## `variance`

The `variance` visualization calculates the variance of the field in the dataset and produces a time series chart.
The `variance` aggregation returns the sample variance of the fields of the dataset.

#### Arguments

`field: number` is the number field where Axiom calculates the variance.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`variance` overview">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/variance.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=2476633274f6229bc8d1bc14684ca9a8" alt="`variance` overview" width="2380" height="1606" data-path="doc-assets/shots/variance.png" />
</Frame>

## `stddev`

The `stddev` visualization calculates the standard deviation of the field in the dataset and produces a time series chart.
The `stddev` aggregation returns the sample standard deviation of the fields of the dataset.

#### Arguments

`field: number` is the number field where Axiom calculates the standard deviation.

#### Group-by behaviour

The visualization produces a separate result for each group plotted on a time series chart.

<Frame caption="`stddev` overview">
  <img src="https://mintcdn.com/axiom/6UXjyyx-ZiWeEcux/doc-assets/shots/stdev.png?fit=max&auto=format&n=6UXjyyx-ZiWeEcux&q=85&s=76817573f5a7456a2d4ed5859f421a2a" alt="`stddev` overview" width="2380" height="1624" data-path="doc-assets/shots/stdev.png" />
</Frame>
