Importe o dashboard Real-Time Metrics

Você pode importar um dashboard do Grafana que mostra em gráficos requisições, cache, métodos HTTP e status codes do Real-Time Metrics e os principais request URIs, user agents e hosts do Real-Time Events. Para o dashboard que o plugin da Azion instala, consulte Importe o dashboard pré-configurado do Grafana.

O dashboard é um modelo JSON de oito painéis distribuídos em duas linhas do dashboard. A linha Metrics lê o dataset httpMetrics da API GraphQL do Real-Time Metrics. A linha Events lê workloadEvents, um dataset do Real-Time Events, de um segundo endpoint. O Grafana precisa de um data source para cada endpoint.

Pré-requisitos

• Uma instância do Grafana em que você pode importar um dashboard.
• O plugin GraphQL Data Source (fifemon-graphql-datasource) nessa instância. Todos os painéis do dashboard usam esse plugin, não o plugin da Azion para Grafana.
• Um personal token. Para criar um, consulte Como criar um personal token.
• Uma aplicação com requisições nos últimos dois dias, o intervalo em que o dashboard abre.

Adicione um data source para os painéis de métricas

Os cinco painéis da linha Metrics enviam suas queries para https://api.azion.com/v4/metrics/graphql. Não use https://api.azionapi.net/metrics/graphql: esse host responde 403 com uma página de erro em HTML.

Para adicionar o data source de métricas no Grafana:

O Grafana salva o data source e executa um teste contra o endpoint. Sem o header Authorization, o endpoint responde 401 com {"detail": "Authentication credentials were not provided."}.

Adicione um data source para os painéis de eventos

Os três painéis da linha Events consultam workloadEvents, um dataset do Real-Time Events. O endpoint de métricas não atende esse dataset e responde 400:

As mesmas queries rodam sem alteração em https://api.azion.com/v4/events/graphql, com o mesmo personal token.

Para adicionar o data source de eventos no Grafana:

O Grafana salva o segundo data source. Cada linha do dashboard passa a ter um endpoint que atende o seu dataset.

Importe o modelo do dashboard

O modelo do dashboard abre nos últimos dois dias (now-2d a now), no fuso horário do navegador, sem atualização automática. Ele não declara entradas de data source. Cada painel indica o seu data source por um UID fixo: loKOM5K4k na linha Events e d863aedd-0f4f-48e4-ae94-bf0bc73120a6 na linha Metrics. O modelo também define uma variável host oculta que nenhuma query de painel usa.

O modelo do dashboard:

Para importar o dashboard no Grafana:

O Grafana lista o dashboard como Dashboard Exemple - Azion, o título que o modelo define. Ele tem três linhas recolhidas: uma Row title vazia, Events e Metrics.

Conecte cada painel ao seu data source

Os painéis do dashboard importado mantêm os UIDs de data source do modelo, e esses UIDs não correspondem aos data sources que você adicionou. Conecte cada painel ao data source que atende a linha dele.

Para conectar um painel no Grafana:

Repita os passos para cada um dos oito painéis. Cada painel passa então a enviar a sua query ao próprio endpoint, para o intervalo do dashboard.

Ajuste o painel Logs ao intervalo do dashboard

O painel Logs, na linha Metrics, executa a query CountRowsByHost, que conta as linhas de httpMetrics de cada host. A query fixa o intervalo de 2023-03-22T17:03:00 a 2023-03-22T18:05:00. Esse intervalo retorna um array httpMetrics vazio, então o painel não mostra nenhuma linha, qualquer que seja o intervalo que você escolha no dashboard.

A query editada substitui o intervalo fixo pelas variáveis do dashboard ${__from:date:iso} e ${__to:date:iso}, como fazem os outros painéis:

Para editar a query no Grafana:

O Grafana preenche as duas variáveis com o intervalo do dashboard. Para os últimos dois dias, o endpoint de métricas responde com uma linha por host, com a maior contagem primeiro:

Cada count é o número de linhas de httpMetrics registradas para aquele host no intervalo.

Verifique os painéis

Cada painel consulta um dataset e mostra nos gráficos os campos desta tabela. Quando um painel mostra os seus campos para o intervalo do dashboard, o data source dele funciona.

Os três painéis da linha Events contam os valores de host de cada grupo e mantêm 10 grupos com limit: 10. A linha orderBy: [count_DESC] dessas queries está comentada, então a query não pede os maiores grupos primeiro.

Em Status Codes, um campo de classe conta somente os status codes daquela classe que não têm campo próprio. Por exemplo, requestsStatusCode2xx retorna 0 quando todas as respostas 2xx são 200, que requestsStatusCode200 conta. Para os campos por código, consulte Detalhe as requisições por status code.

Para o tipo e o significado de cada campo de httpMetrics, consulte Campos da API GraphQL do Real-Time Metrics.

Próximos passos