---
name: azion-instale-o-plugin-da-azion-para-grafana
description: >-
  Instale o plugin de data source da Azion em uma instância local do Grafana e conecte-o à sua conta Azion com um personal token.
---

# Instale o plugin da Azion para Grafana

Você pode instalar o plugin de data source da Azion em uma instância local do Grafana e conectá-lo à sua conta Azion pelo Grafana. O plugin mostra os dados das suas aplicações na Azion como gráficos e tabelas em dashboards do Grafana. Ele lê [Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/) e [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/) pela [API GraphQL](/pt-br/documentacao/devtools/graphql/visao-geral/), e você cria cada dashboard a partir de queries GraphQL.

Os dashboards do Grafana complementam os gráficos que Real-Time Metrics mostra no Azion Console. Use-os para métricas top X, como endereços IP ou países bloqueados, para métricas de segurança, para status codes específicos e para alertas personalizados.

---

## Pré-requisitos

- Uma conta Azion. Para criar uma, acesse a [página de cadastro do Azion Console](https://console.azion.com/signup).
- Um personal token da sua conta. Para criar um, consulte [Personal tokens](/pt-br/documentacao/guias/plataforma/conta-e-billing/personal-tokens/).
- Uma ou mais [aplicações](/pt-br/documentacao/plataforma/applications/) na sua conta, com tráfego.
- Uma instância do Grafana que você executa localmente. Para o Grafana em si, consulte [Grafana](https://grafana.com/).

---

## Instale o plugin

O plugin da Azion é instalado em uma instância local do Grafana, e essa instância precisa permitir plugins não assinados. O repositório do plugin contém as instruções de instalação.

Para instalar o plugin na sua instância local do Grafana:

Siga as instruções de instalação local no [repositório do plugin da Azion](https://github.com/aziontech/grafana-plugin/blob/dev/README.md#install-azion-plugin-on-local-grafana-install-locally). O repositório em si é [aziontech/grafana-plugin](https://github.com/aziontech/grafana-plugin).

Após a instalação, o plugin da Azion fica disponível na lista de plugins da sua instância do Grafana.

---

## Crie o data source da Azion

Um data source conecta o plugin da Azion à sua conta. O Grafana autentica cada query do data source com o seu personal token.

Para criar o data source no Grafana:

1. **Abra a lista de plugins**

   No menu do Grafana, acesse **Administration** > **Plugins**.

2. **Encontre o plugin da Azion**

   Em **Search**, digite `Azion`.

3. **Selecione o card Azion**

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

   O Grafana abre a página de configuração do novo data source.

5. **Dê um nome ao data source**

   Na aba **Settings**, digite um **Name** descritivo.

6. **Adicione o seu personal token**

   Em **Personal Token**, digite o personal token da sua conta Azion.

7. **Salve e teste o data source**

   Selecione **Save & test**. O Grafana salva o data source e executa um teste rápido da autenticação.

O teste de autenticação é aprovado e o data source da Azion fica salvo na sua instância do Grafana. Seus dashboards do Grafana o usam para consultar Real-Time Metrics e Real-Time Events.

---

## Próximos passos

- [Importe o dashboard pré-configurado do Grafana](/pt-br/documentacao/guias/plataforma/observabilidade/azion-plugin-grafana-dash-pre-configurado.md): Importe o dashboard Data Transferred que acompanha o plugin da Azion, sem configuração adicional.
- [Crie um dashboard personalizado no Grafana](/pt-br/documentacao/guias/plataforma/observabilidade/azion-plugin-grafana.md): Adicione painéis que executam as suas próprias queries GraphQL pelo data source da Azion.
- [Campos do Real-Time Metrics](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-metrics.md): Encontre os datasets e os campos que a query de um painel pode selecionar.
- [Visão geral de Real-Time Events](/pt-br/documentacao/plataforma/real-time-events.md): Encontre os dados de eventos que o data source da Azion também consulta.