--- name: azion-crie-um-dashboard-personalizado-no-grafana description: >- Adicione um painel do Grafana que plota dados de Real-Time Metrics pelo data source da Azion, mapeie os campos da resposta e salve o dashboard. --- # Crie um dashboard personalizado no Grafana Você pode criar o seu próprio dashboard no Grafana, com painéis que enviam queries GraphQL para [Real-Time Metrics](/pt-br/documentacao/plataforma/real-time-metrics/) pelo plugin de data source da Azion. Cada painel plota os dados que você escolhe na query dele. Para importar o dashboard Data Transferred já pronto, consulte [Importe o dashboard pré-configurado do Grafana](/pt-br/documentacao/guias/plataforma/observabilidade/azion-plugin-grafana-dash-pre-configurado/). ## Pré-requisitos - Uma instância local do Grafana com o plugin da Azion instalado e um data source da Azion criado. Para configurar os dois, consulte [Instale o plugin da Azion para Grafana](/pt-br/documentacao/guias/plataforma/observabilidade/integrar-grafana/). - Uma [aplicação](/pt-br/documentacao/plataforma/applications/) que atendeu requisições no intervalo de tempo que o painel plota. --- ## Adicione um painel que consulta Real-Time Metrics Um painel contém uma query GraphQL, e o data source da Azion a envia para a API de Real-Time Metrics. A query desta página lê o dataset `httpMetrics`, que registra as requisições das suas aplicações. Ela retorna os dados transferidos por minuto ao longo de 24 horas: ```graphql query DataTransferredOverTime { httpMetrics( limit: 2000 filter: { tsRange: { begin: "2026-01-01T12:00:00.000Z", end: "2026-01-02T12:00:00.000Z" } } groupBy: [ts] orderBy: [ts_ASC] ) { ts dataTransferredIn dataTransferredOut dataTransferredTotal } } ``` Substitua os valores de `begin` e `end` pelo intervalo de tempo que você quer plotar. Sem `limit`, a API retorna 10 linhas, então `limit: 2000` mantém todos os minutos de um intervalo de 24 horas. A query retorna uma linha para cada minuto que teve tráfego, em ordem cronológica: ```json { "data": { "httpMetrics": [ { "ts": "2026-01-01T13:04:00Z", "dataTransferredIn": 13094.0, "dataTransferredOut": 2649889.0, "dataTransferredTotal": 2662983.0 }, { "ts": "2026-01-01T13:06:00Z", "dataTransferredIn": 7470.0, "dataTransferredOut": 986551.0, "dataTransferredTotal": 994021.0 }, … ] } } ``` Os valores estão em bytes, e `dataTransferredTotal` é a soma de `dataTransferredIn` e `dataTransferredOut`. Para todos os campos do dataset, consulte [Campos da API GraphQL do Real-Time Metrics](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-metrics/#workloadmetrics). Para adicionar o painel no Grafana: 1. **Abra os dashboards** No menu do Grafana, selecione **Dashboards**. 2. **Crie um dashboard** Selecione **New** > **New Dashboard**. 3. **Adicione um painel** No card **Add panel**, selecione **Add a new panel**. 4. **Selecione o data source da Azion** Na lista **Data source**, selecione **Azion**. 5. **Cole a query** Na caixa de código da query, cole a query `DataTransferredOverTime`. A pré-visualização do painel lê as linhas da query pelo data source da Azion. > **dica** > > Para começar a partir de um gráfico de Real-Time Metrics no Azion Console, abra o menu **More options** do gráfico e selecione **Copy query**. O texto copiado contém a query em `# QUERY` e os valores das variáveis dela em `# VARIABLES`. Escreva cada valor na query no lugar da variável correspondente antes de colá-la. Para os passos, consulte [Exporte os dados e a query de um gráfico](/pt-br/documentacao/guias/plataforma/observabilidade/analisar-metricas/). --- ## Mapeie os campos da resposta Cinco campos opcionais indicam ao painel como ler as linhas que a query retorna. Os campos de que um painel precisa dependem da visualização dele e do que o gráfico mostra. Os cinco campos recebem estes valores: | Campo | O que recebe | | --------------- | ------------------------------------------------------------------------------------------------------------------------------ | | **Data path** | O valor `Metrics`. | | **Time path** | O caminho até o timestamp de cada linha, delimitado por pontos. A query `DataTransferredOverTime` retorna o timestamp em `ts`. | | **Time format** | O formato desse timestamp, escrito no formato moment.js. | | **Group by** | O campo que agrupa os dados agregados em séries. | | **Alias by** | O nome e o valor que um campo mostra na legenda. | --- ## Escolha uma visualização e salve A visualização define como o painel desenha as linhas. Uma query agrupada por `ts`, como `DataTransferredOverTime`, retorna uma linha por bucket de tempo. Para concluir o painel no Grafana: 1. **Selecione uma visualização** Na lista **Visualization**, selecione um tipo de visualização. Por exemplo: **Time series**. 2. **Salve o dashboard** Selecione **Save** para aplicar a configuração. O dashboard mantém o painel com a query, o mapeamento de campos e a visualização dele. --- ## Próximos passos - [Exporte os dados e a query de um gráfico](/pt-br/documentacao/guias/plataforma/observabilidade/analisar-metricas.md): Copie a query por trás de qualquer gráfico de Real-Time Metrics e use-a novamente em um painel. - [Campos do Real-Time Metrics](/pt-br/documentacao/devtools/graphql/campos-gql-real-time-metrics.md): Todos os datasets e campos que a query de um painel pode selecionar, com o tipo de cada um. - [Importe o dashboard pré-configurado do Grafana](/pt-br/documentacao/guias/plataforma/observabilidade/azion-plugin-grafana-dash-pre-configurado.md): Adicione ao Grafana o dashboard Data Transferred já pronto, sem escrever uma query. - [Queries](/pt-br/documentacao/devtools/graphql/queries.md): Filtros, agregações, agrupamento e ordenação para as queries que os seus painéis enviam.