Axiom Datasource Plugin for Grafana
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
Before using this plugin, two steps are required:
- Create an account at app.axiom.co.
- Generate a persontal token from Axiom profile settings
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.
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
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
grafana-cli plugins install axiomhq-axiom-datasource
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.
- Enter the previously generated Personal Token and the Organization ID, available in the profile settings in Axiom. The Organization ID is the unique identifier associated with your organization. In the image below the
og id
isaxiom-rkbj
- 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 visualiazations from metrics and logs stored in Axiom.
- Create a new panel in Grafana by clicking on Add visualization
- Select the Axiom data source.
- Use the query editor to choose the desired metrics, dimensions, and filters.
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.
- 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.
-
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.