---
name: azion-customize-a-grafana-log-table
description: >-
  Build a Grafana panel that renders Azion event records as a table, choosing the dataset, the fields, and the time path the panel orders by.
---

# Customize a Grafana log table

With the Azion data source plugin, you can build a Grafana dashboard panel that shows the Azion data you need. This page covers the panel itself: the data source, the query, the five fields that shape the result, and the visualization type.

Connecting Grafana to your account is a separate task. For more information, refer to [Install the Azion plugin for Grafana](/en/documentation/guides/platform/observability/integrate-grafana/).

---

## Prerequisites

- A Grafana instance running on your machine. To install one, refer to the [Azion Grafana plugin repository](https://github.com/aziontech/grafana-plugin).
- The Azion plugin installed on that instance and authorized. For more information, refer to [Install the Azion plugin for Grafana](/en/documentation/guides/platform/observability/integrate-grafana/).
- A query that returns the [Real-Time Events](/en/documentation/platform/real-time-events/) data you want the panel to show.

---

## Build the panel

A panel holds one query and one visualization type. The five fields below map the fields the query returns onto the visualization.

To add a panel that reads Azion data, in Grafana:

1. **Open the dashboard list**

   Select **Dashboards**. The dashboard page opens.

2. **Create a dashboard**

   Beside the search bar, *search*, select **New** > **New Dashboard**.

3. **Select Add visualization**

4. **Select the data source**

   On the **Data source** dropdown, select *Azion*.

5. **Enter the query**

   In the code box, enter the query the panel runs. For example queries, refer to [GraphQL API](/en/documentation/devtools/graphql/overview/).

6. **Complete the panel fields**

   Five fields complete the setup. Which ones you fill depends on the visualization type and on what the panel shows:

   - **Data path**: enter the value `Events`.
   - **Time path**: enter a timestamp. The field is dot-delimited.
   - **Time format**: enter a time format in [moment.js format](https://momentjs.com/docs/#/parsing/string/).
   - **Group by**: use this field when you want the data grouped in aggregated form.
   - **Alias by**: use this field to change the value and the name a field carries in the legend.

7. **Select the visualization type**

   On the **Visualization** list, select the type the panel uses. To read raw event records in large volume, or a top X query, Azion recommends the *Table* type. You can combine it with other types of charts and graphs.

8. **Select Save**

Grafana saves the panel, and the dashboard shows the data the query returns.

---

## Grafana documentation

- [Create and use dashboards](https://grafana.com/docs/grafana/latest/dashboards/)
- [Grafana dashboard best practices](https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/best-practices/)
- [Add and manage variables](https://grafana.com/docs/grafana/latest/dashboards/variables/)
- [Configuring time series in ISO8601](https://momentjs.com/docs/#/parsing/string/)
- [Configuring time series in custom format](https://momentjs.com/docs/#/parsing/string-format/)
- [Visualizations](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/)
- [Configuring a legend](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/configure-legend/)
- [Configuring value mappings](https://grafana.com/docs/grafana/latest/panels-visualizations/configure-value-mappings/)

---

## Trademarks

[Grafana Cloud](https://grafana.com/products/cloud/) is a trademark of Grafana Labs. Azion is not affiliated with, endorsed by, or sponsored by Grafana Labs or its affiliates.

---

## Next steps

- [Build a Grafana query against Azion data](/en/documentation/guides/platform/observability/best-practices-grafana.md): Write the query the panel runs, and the fields it has to return.
- [Real-Time Events fields](/en/documentation/devtools/graphql/gql-real-time-events-fields.md): Every field each dataset carries, so the panel maps the right one onto each column.
- [Data sources](/en/documentation/platform/real-time-events/data-sources.md): The data sources a query can read, and what each one records.
- [Install the Azion plugin for Grafana](/en/documentation/guides/platform/observability/integrate-grafana.md): Install the plugin and authorize it against your account.