---
name: azion-install-the-azion-plugin-for-grafana
description: >-
  Install the Azion data source plugin on a local Grafana instance and connect it to your Azion account with a personal token.
---

# Install the Azion plugin for Grafana

You can install the Azion data source plugin on a local Grafana instance and connect it to your Azion account from Grafana. The plugin shows data from your applications on Azion as charts and tables in Grafana dashboards. It reads [Real-Time Metrics](/en/documentation/platform/real-time-metrics/) and [Real-Time Events](/en/documentation/platform/real-time-events/) through the [GraphQL API](/en/documentation/devtools/graphql/overview/), and you build each dashboard from GraphQL queries.

Grafana dashboards complement the charts that Real-Time Metrics shows in Azion Console. Use them for top X metrics such as IP addresses or blocked countries, security metrics, specific status codes, and customized alerts.

---

## Prerequisites

- An Azion account. To create one, go to the [Azion Console sign-up page](https://console.azion.com/signup).
- A personal token for your account. To create one, refer to [Personal tokens](/en/documentation/guides/platform/account-and-billing/personal-tokens/).
- One or more [applications](/en/documentation/platform/applications/) on your account, with traffic.
- A Grafana instance that you run locally. For Grafana itself, refer to [Grafana](https://grafana.com/).

---

## Install the plugin

The Azion plugin installs on a local Grafana instance, and that instance must allow unsigned plugins. The plugin repository holds the installation instructions.

To install the plugin on your local Grafana instance:

Follow the local installation instructions in the [Azion plugin repository](https://github.com/aziontech/grafana-plugin/blob/dev/README.md#install-azion-plugin-on-local-grafana-install-locally). The repository itself is [aziontech/grafana-plugin](https://github.com/aziontech/grafana-plugin).

After the installation, the Azion plugin is available in the plugin list of your Grafana instance.

---

## Create the Azion data source

A data source connects the Azion plugin to your account. Grafana authenticates every query of the data source with your personal token.

To create the data source in Grafana:

1. **Open the plugin list**

   In the Grafana menu, go to **Administration** > **Plugins**.

2. **Find the Azion plugin**

   In **Search**, enter `Azion`.

3. **Select the Azion card**

4. **Select Create an Azion data source**

   Grafana opens the configuration page of the new data source.

5. **Name the data source**

   In the **Settings** tab, enter a descriptive **Name**.

6. **Add your personal token**

   In **Personal Token**, enter the personal token of your Azion account.

7. **Save and test the data source**

   Select **Save & test**. Grafana saves the data source and runs a quick test of the authentication.

The authentication test passes, and the Azion data source is saved in your Grafana instance. Your Grafana dashboards use it to query Real-Time Metrics and Real-Time Events.

---

## Next steps

- [Import the pre-built Grafana dashboard](/en/documentation/guides/platform/observability/azion-plugin-grafana-pre-built-dash.md): Import the Data Transferred dashboard that the Azion plugin ships, with no further setup.
- [Build a custom Grafana dashboard](/en/documentation/guides/platform/observability/azion-plugin-grafana-custom-dash.md): Add panels that run your own GraphQL queries through the Azion data source.
- [Real-Time Metrics fields](/en/documentation/devtools/graphql/gql-real-time-metrics-fields.md): Find the datasets and fields that a panel query can select.
- [Real-Time Events overview](/en/documentation/platform/real-time-events.md): Find the event data that the Azion data source also queries.