Connect Axiom with Grafana
Learn how to extend the functionality of Grafana by installing the Axiom data source plugin.
Data visualisation
What is a Grafana data source plugin?
Grafana is an open-source tool for time-series analytics, visualization, and alerting. It’s frequently used in DevOps and IT Operations roles to provide real-time information on system health and performance.
Data sources in Grafana are the actual databases or services where the data is stored. Grafana has a variety of data source plugins that connect Grafana to different types of databases or services. This enables Grafana to query those sources from display that data on its dashboards. The data sources can be anything from traditional SQL databases to time-series databases or metrics, and logs from Axiom.
A Grafana data source plugin extends the functionality of Grafana by allowing it to interact with a specific type of data source. These plugins enable users to extract data from a variety of different sources, not just those that come supported by default in Grafana.
Prerequisites
- Create an Axiom account.
- Create a dataset in Axiom where you send your data.
- Create an API token in Axiom with permissions to create, read, update, and delete datasets.
Install the Axiom Grafana data source plugin on Grafana Cloud
-
In Grafana, click Administration > Plugins in the side navigation menu to view installed plugins.
-
In the filter bar, search for the Axiom plugin
-
Click on the plugin logo.
-
Click Install.
Add new layer
When the update is complete, a confirmation message is displayed, indicating that the installation was successful.
- The Axiom Grafana Plugin is also installable from the Grafana Plugins page
Add new layer
Install the Axiom Grafana data source plugin on local Grafana
The Axiom data source plugin for Grafana is open source on GitHub. It can be installed via the Grafana CLI, or via Docker.
Install the Axiom Grafana Plugin using Grafana CLI
Install Via Docker
- Add the plugin to your
docker-compose.yml
orDockerfile
- Set the environment variable
GF_INSTALL_PLUGINS
to include the plugin
Example:
GF_INSTALL_PLUGINS="axiomhq-axiom-datasource"
Configuration
-
Add a new data source in Grafana
-
Select the Axiom data source type.
Add new layer
-
Enter the previously generated API token.
-
Save and test the data source.
Build Queries with Query Editor
The Axiom data source Plugin provides a custom query editor to build and visualize your Axiom event data. After configuring the Axiom data source, start building visualizations from metrics and logs stored in Axiom.
- Create a new panel in Grafana by clicking on Add visualization
Build queries
- Select the Axiom data source.
Axiom data source
- Use the query editor to choose the desired metrics, dimensions, and filters.
Axiom Query Editor
Benefits of the Axiom Grafana data source plugin
The Axiom Grafana data source plugin allows users to display and interact with their Axiom data directly from within Grafana. By doing so, it provides several advantages:
- Unified visualization: The Axiom Grafana data source plugin allows users to utilize Grafana’s powerful visualization tools with Axiom’s data. This enables users to create, explore, and share dashboards which visually represent their Axiom logs and metrics.
Data visualisation
- Rich Querying Capability: Grafana has a powerful and flexible interface for building data queries. With the Axiom plugin, and leverage this capability to build complex queries against your Axiom data.
Rich querying
-
Customizable Alerting: Grafana’s alerting feature allows you to set alerts based on your queries’ results, and set up custom alerts based on specific conditions in your Axiom log data.
-
Sharing and Collaboration: Grafana’s features for sharing and collaboration can help teams work together more effectively. Share Axiom data visualizations with others, collaborate on dashboards, and discuss insights directly in Grafana.
Rich querying
Was this page helpful?