Plugins 〉Axiom
Axiom
Instantly visualize Axiom data in Grafana
The Grafana data source plugin is the easiest way to query event data from Axiom directly in Grafana dashboards.
Requirements
This plugin has the following requirements:
- An Axiom account
- An Axiom advanced API token with read permission
Configuration
- Add a new data source in Grafana
- Select the Axiom data source plugin
- Enter your Axiom advanced API token
- Confirm the Edge URL for your Axiom deployment. The default is
https://us-east-1.aws.edge.axiom.co - Save and test the data source
Upgrading from v0.6.x to v0.7.0
v0.7.0 no longer supports Personal token plus Org ID authentication. If an existing data source still uses a Personal token and Org ID, update it to use an Axiom API token before upgrading so dashboards using that data source continue to authenticate.
v0.7.0 uses Edge URL for query operations. Existing v0.6.x data sources that only have an API URL and API token continue to work: when neither edge nor edgeURL is configured, the plugin defaults edgeURL to https://us-east-1.aws.edge.axiom.co at config load.
No manual migration is required for data sources that should use the default edge endpoint. If your Axiom deployment uses a different edge endpoint, update the data source:
- In Grafana, open Connections > Data sources > Axiom
- Set Edge URL to the edge endpoint for your Axiom deployment
- Save and test the data source
If the data source is provisioned and should use a non-default edge endpoint, add edgeURL under jsonData:
jsonData:
apiHost: https://api.axiom.co
edgeURL: https://your-edge.example.com
Data sources that already used the legacy edge setting continue to be migrated automatically to edgeURL.
Visualizing data
The Axiom data source plugin provides a custom editor to query and visualize event data from Axiom.
- Create a new panel in Grafana
- Select the Axiom data source
- Use the query editor to filter, transform and analyze your data
Metric series labels
For MPL metric queries, Grafana legends use the metric name plus the tag set by default. To make legends easier to scan, the plugin uses tag values as the leading label when tags are present, for example 200 | POST | /checkout {status=200, method=POST, route=/checkout}.
You can control the full legend dynamically from your query by adding a __label tag. The plugin uses the __label value as the series label and hides the normal {tag=value} suffix from the legend, while still leaving those labels available in Grafana:
extend __label = "${`k8s.pod.name`}"
Installation
Installation on Grafana Cloud
For more information, visit the docs on plugin installation.
Installation with Grafana CLI
grafana-cli plugins install axiomhq-axiom-datasource
Installation with Docker
- Add the plugin to your
docker-compose.ymlorDockerfile - Set the environment variable
GF_INSTALL_PLUGINSto include the plugin
GF_INSTALL_PLUGINS="axiomhq-axiom-datasource"
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Install on Grafana Cloud
Plugins can be installed directly from within your Grafana instance or automated using the Cloud API or Terraform.
Learn more about plugin installationMarketplace plugins
This is a paid plugin developed by a marketplace partner. To purchase an entitlement, sign in first, then fill out the contact form.
Get this plugin
This is a paid for plugin developed by a marketplace partner. To purchase entitlement please fill out the contact us form.
What to expect:
- Grafana Labs will reach out to discuss your needs
- Payment will be taken by Grafana Labs
- Once purchased the plugin will be available for you to install (cloud) or a signed version will be provided (on-premise)
Thank you! We will be in touch.
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Data Source
Use the grafana-cli tool to install Axiom from the commandline:
grafana-cli plugins install The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
Changelog
0.7.0
- Add support for MPL queries in panels and variables, including the MPL editor, metric selectors, tag lookup resources, and chart-width forwarding.
- Migrate queries to the v2 query model with explicit
kindandqueryfields while preserving runtime migration for legacy saved APL queries. - Return Grafana-native frames for APL time series, logs, traces, generic tables, and logs-volume results.
- Improve metric series display names with tag-derived labels and
__labellegend overrides. - Upgrade Grafana frontend dependencies and plugin SDK support for newer Grafana versions and React 19.
- Fix edge URL handling and datasource credentials validation.
- Fix provisioned dashboard query shape, APL/MPL variable query editing, Kusto/MPL editor initialization, empty-query execution, and trace/log frame normalization.
Breaking changes
- Personal tokens are no longer allowed; datasource authentication now requires API tokens. Existing data sources that still use a Personal token with Org ID must be updated to use an API token before upgrading, otherwise dashboards backed by those data sources will fail authentication after upgrade.
Edge URLis now required in the plugin config and is used for all query operations. To preserve compatibility for existing v0.6.x data sources that only haveapiHostand an API token, the plugin defaultsedgeURLtohttps://us-east-1.aws.edge.axiom.cowhen neitheredgenoredgeURLis configured. Users with a different edge endpoint should update the datasource setting or setjsonData.edgeURLin provisioning. LegacyjsonData.edgevalues continue to be migrated automatically.
0.6.4
- Add support for regional edge query endpoints and explicit edge URLs.
- Add smart edge URL path handling for custom query endpoints.
- Bump
axiom-goto v0.29.0, including support forHTTP_PROXY,HTTPS_PROXY, andNO_PROXYenvironment variables. - Upgrade the Grafana Go SDK.
- Update release automation for the current Grafana plugin build, signing, and attestation flow.
0.6.3
- Update Grafana plugin SDK to v12
- Fix datasource settings to expect injected Grafana settings that are not strings
0.5.1
- fix(repeat panels): use scopedVars for query by @schehata in #69
0.5.0
- feat: bump frontend-workers/apl by @kevinehosford in #64
- fix(monaco): update hash and re-add copy step by @kevinehosford in #67
- use tabular-row format by @schehata in #66
- Bump fast-loops from 1.1.3 to 1.1.4 by @dependabot in #65
- Bump micromatch from 4.0.5 to 4.0.8 by @dependabot in #68
- Bump braces from 3.0.2 to 3.0.3 by @dependabot in #63
0.4.0
- Added support for advanced API tokens by @schehata (#59)
- Deprecate usage of Personal Tokens by @schehata (#59)
- Upgraded axiom-go to version v0.17.8
0.3.1
- Show the URL config field in plugin settings by @schehata in #58
0.3.0
- fix: Run queries concurrently to speed up panels with many queries by @jahands in #40
- testing: provide a datasource & dashboard for quick testing by @schehata in #57
0.2.0
- feat: replace plugin screenshots by @dominicchapman in #29
- Add placeholder, query shortcut to QueryEditor by @bahlo in #30
- Fix totals switch when submitting via keybinding by @bahlo in #31
- Fix history bugs by @bahlo in #32
0.1.9
- switch to using call resource functionality by @mschoch in #23
- handle totals table groups same as series by @mschoch in #24
- fix: mismatch between values and fields arrays and longToWide on … by @a-khaledf in #21
- docs: update README by @dominicchapman in #25
- feat: revise Axiom logo for light background by @dominicchapman in #26
- fix handling of fields with escaped dots by @mschoch in #28
