Docs
DocumentationQuery ReferenceAPI Reference
Open Console→→
DocumentationQuery ReferenceAPI Reference

Platform overview

What is Axiom?QuickstartArchitectureFeatures
Fundamentals
Datasets
Edge deployments
Limits
Performance
Optimize usage
Requirements
Semantic conventions
Glossary
Tour
SecurityRoadmap

Send data

Reference architecturesMethods

Understand data

Console
Query
Builder
Editor
Query results
Visualize
Traces
Metrics
Correlations
Save queries
Stream
Dashboard
Create
Elements
Create
Configure
Element types
Gauge
Heatmap
Log stream
Monitor list
Note
Pie chart
Scatter plot
Statistic
Table
Time series
Sections
Configure
Filter
Monitor
Overview
View status
Configure
Examples
Monitor types
Anomaly
Match
New values
Threshold
Alerting
Overview
Configure
Notifier types
Amp
ChatGPT Workspace Agent
Claude Code
Cursor
Custom Webhook
Discord
Email
incident.io
Jira Service Management
Microsoft Teams
Opsgenie
PagerDuty
Slack
Annotations
Command Menu
Manage
Datasets
Overview
Views
Virtual fields
Access
RBAC
Tokens
CLI
Organization
Labels
Audit log
Settings
Usage and billing
Profile
Extend
Overview
AWS Lambda
AWS PrivateLink
Cloudflare Workers
Cloudflare Logpush
Convex
Grafana
Hex
Netlify
Supabase
Tailscale
Terraform
Unkey
Vercel
Intelligence
Overview
Spotlight
AI agents
Overview
MCP Server
Overview
Tools
Query cost limits
Agent-created orgs
Skills
Overview
Axiom alerting
Build dashboards
Control costs
SRE
Translate SPL to APL
Splunk
Overview
Splunk app
Install and configure
Commands
Traces
Examples
Portal
How it works
Set up standard mode
Set up transparent mode
Observability Cloud
OCSF data
OCSF as CIM
SPL command support
Examples
Monitor and troubleshoot

Use cases

ObservabilityProduct analytics
OCSF security data
Overview
Send data
Query data
LLM observability
Overview
Use Vercel AI SDK
Manual instrumentation
OpenAI Agents SDK
GenAI attributes
Redaction policies

Miscellaneous

LLMs
Overview
List of docs pages
Full docs
Query reference
FAQs
Legal
Acceptable use policy
Axiom for Startups terms
Committed use terms
Cookies
Data processing
HIPAA
Partner agreement
Partner program guide
Privacy policy
SLA
Terms of service
Terms of use
Understand data/Console

Create dashboard elements

This section explains how to create dashboard elements.

Dashboard elements are the different visual elements that you can include in your dashboard to display your data and other information. For example, you can track key metrics, logs, and traces, and monitor real-time data flow.

You can create the following dashboard elements:

  • Filter bar
  • Gauge
  • Heatmap
  • Log stream
  • Monitor list
  • Note
  • Pie
  • Scatter
  • Statistic
  • Table
  • Time series
  • Top list
  • Spacer
  • Visualize

To organize related dashboard elements into collapsible groups, create dashboard sections.

Create dashboard elements

  1. Create a dashboard or open an existing dashboard.
  2. Click Edit dashboard.
  3. Click Add element in the top right corner.
  4. Choose the dashboard element from the menu (Chart, Data, Other, or Section).
  5. For charts, select one of the following:
    • Click Builder to create your chart using a visual query builder.
    • Click Editor to create your chart using the Axiom Processing Language (APL). Create a chart in the same way you create a chart in the Editor.
  6. Optional: Configure chart options.
  7. Optional: Set a custom time range that’s different from the dashboard’s time range.
  8. Click Save.

The new element appears in your dashboard. In the page header, click Save dashboard to save your changes to the dashboard.

Create a Visualize chart

Use Visualize to choose which fields from an APL query to plot on a dashboard.

  1. Create a dashboard or open an existing dashboard.
  2. Click Edit dashboard.
  3. Open Add element > Chart > Visualize and select a chart type.
  4. Create a query using Builder or Editor, and then click Run.
  5. Select the fields to plot in X-axis and Y-axis. For chart options and an example, see Create a chart from query results.
  6. Click Save.
  7. Click Save dashboard.

Create chart using visual query builder

Use the query builder to create or edit queries for the selected dataset:

Query builder
└Query builder

This component is a visual query builder that eases the process of building visualizations and segments of your data.

This guide walks you through the individual sections of the query builder.

Time range

Click the time range button, then Custom, to select a common time range or enter specific start and end timestamps:

Time range
└Time range
  • Use the Quick range items to quickly select popular ranges
  • Use the Start date and End date inputs to select specific times
  • Click Apply to use the selected time range

Compare period

When a time series visualization is selected, such as count, the Compare period menu is enabled and it’s possible to select a historical time to compare the results of your time range to.

For example, to compare the last hour’s average response time to the same time yesterday, select 1 hr in the time range menu, and then select Custom > -1 day from the Compare period menu:

Compare period menu
└Compare period menu

The results look like this:

Compare period chart
└Compare period chart

The dotted line represents results from the comparison period. To include the comparative totals table, set Output to Chart and results table.

When you add a field to the group by clause, the comparison values appear for each group.

Compare period chart grouped by field
└Compare period chart grouped by field

Visualizations

Axiom provides powerful visualizations that display the output of running aggregate functions across your dataset. The Add aggregation menu in the Summarize row allows you to add these visualizations and, where required, input their arguments:

Visualizations menu
└Visualizations menu

You can select a visualization to add it to the query. If a visualization requires an argument (such as the field and/or other parameters), the menu allows you to select eligible fields and input those arguments. Press Enter to complete the addition.

Click an aggregation in the Summarize row to edit it at any time.

Learn about supported visualizations

Filters

Use the filter menu to attach filter clauses to your search.

Axiom supports AND/OR operators at the top-level as well as one level deep. This means you can create filters that would read as status == 200 AND (method == get OR method == head) AND (user-agent contains Mozilla or user-agent contains Webkit).

Filters are divided up by the field type they operate on, but some may apply to more than one field type.

List of filters

String fields

  • Equals
  • Does not equal
  • Exists
  • Does not exist
  • Starts with
  • Does not start with
  • Ends with
  • Does not end with
  • Contains
  • Does not contain
  • Has
  • Does not have
  • Matches regex
  • Does not match regex

Number and timespan fields

  • Equals
  • Does not equal
  • Exists
  • Does not exist
  • Greater than
  • At least
  • Less than
  • At most

Boolean fields

  • Equals
  • Does not equal
  • Exists
  • Does not exist

Array fields

  • Contains
  • Does not contain
  • Has
  • Does not have
  • Exists
  • Does not exist

Group by (segmentation)

When visualizing data, it can be useful to segment data into specific groups to more clearly understand how the data behaves.

Use the by control in the Summarize row to add one or more fields to group events by:

Group by
└Group by

Other options

Order

By default, Axiom automatically chooses the best ordering for results. However, you can manually set the desired order through this menu.

Limit

By default, Axiom chooses a reasonable limit for the query that has been passed in. However, you can control that limit manually through this component.

Change element’s position

To change element’s position on the dashboard, drag the title bar of the chart.

Change element size

To change the size of the element, drag the bottom-right corner.

Set custom time range

You can set a custom time range for individual dashboard elements that’s different from the dashboard’s time range. For example, the dashboard displays data about the last 30 minutes but individual dashboard elements display data for different time ranges. This can be useful for visualizing the same chart or statistic for different time periods, among others.

To set a custom time range for a dashboard element:

  1. In the top right of the dashboard element, click Options > Edit.
  2. In the top right above the chart, click .
  3. Click Custom.
  4. Choose one of the following options:
    • Use the Quick range items to quickly select popular time ranges.
    • Use the Custom start/end date fields to select specific times.
  5. Click Save.

Axiom displays the new time range in the top left of the dashboard element.

Set custom time range in APL

To set a custom time range for dashboard elements created with APL, you can use the procedure above or define the time range in the APL query:

  1. In the top right of the dashboard element, click Options > Edit.
  2. In the APL query, specify the custom time range using the where operator. For example:
    APL
    | where _time > now(-6h)
  3. Click Run query to preview the result.
  4. Click Save.

Axiom displays in the top left of the dashboard element to indicate that its time range is defined in the APL query and might be different from the dashboard’s time range.

Set custom comparison period

You can set a custom comparison time period for individual dashboard elements that’s different from the dashboard’s. For example, the dashboard compares against data from yesterday but individual dashboard elements display data for different comparison periods.

To set a custom comparison period for a dashboard element:

  1. In the top right of the dashboard element, click Options > Edit.
  2. In the top right above the chart, click Compare period.
  3. Click Custom.
  4. Choose one of the following options:
    • Use the Quick range items to quickly select popular comparison periods.
    • Use the Custom time field to select specific comparison periods.
  5. Click Save.

Axiom displays the new comparison period in the top left of the dashboard element.

Was this page helpful?
Suggest edits on GitHub
PreviousCreate dashboardsNextConfigure dashboard elements
On this page
Create dashboard elementsCreate a Visualize chartCreate chart using visual query builderTime rangeCompare periodVisualizationsFiltersList of filtersGroup by (segmentation)Other optionsOrderLimitChange element’s positionChange element sizeSet custom time rangeSet custom time range in APLSet custom comparison period