Para consultar e visualizar as métricas coletadas para seu Prometheus OpenMetrics ou integração de gravação remota com New Relic, você pode usar NRQL. Você também pode traduzir sua consulta estilo PromQL para NRQL usando Grafana ou o criador de consulta.
Todas as métricas para Docker e Kubernetes são armazenadas no tipo Metric
.
Atributo padrão para a integração OpenMetrics
Por padrão, o seguinte atributo será adicionado a todas as métricas para integração Docker e Kubernetes :
Atributo padrão\ (toda integração) | Descrição |
---|---|
| O nome do cluster fornecido na configuração do raspador. |
| O nome desta integração ( |
| A versão da integração; por exemplo, |
| O nome da própria métrica. |
| O tipo do tipo New Relic |
| O tipo de métrica da métrica Prometheus |
| O URL do endpoint está sendo copiado. |

Kubernetes: Se o scraper estiver sendo executado no Kubernetes, New Relic também adiciona o seguinte atributo a todas as métricas:
Atributo adicional Kubernetes | Descrição |
---|---|
| Nome da implantação, se estiver raspando um pod. |
| Os rótulos do Kubernetes do objeto que está sendo copiado, prefixados por |
| Nome do namespace. |
| Nome do nó onde o pod que está sendo copiado está em execução, se aplicável. |
| Nome do pod que está sendo copiado, se aplicável. |
| Nome do serviço que está sendo copiado, se aplicável |
Atributo padrão para integração de gravação remota
Por padrão, o seguinte atributo será adicionado à métrica de gravação remota do Prometheus:
Atributo padrão\ (toda integração) | Descrição |
---|---|
| Um rótulo fornecido pelo usuário especificado como um parâmetro de URL de gravação remota do Prometheus. O valor fornecido deve ser exclusivo, pois se destina a diferenciar os servidores Prometheus de origem no momento da consulta. Não especificado por padrão. |
| O nome do ponto de ingestão do New Relic ( |
|
|
|
|
| Um identificador fornecido pelo usuário para a origem dos dados do Prometheus que corresponde ao valor de |
| Usado para identificar a versão da API de gravação remota; por exemplo, |
Exemplos de consulta NRQL
Ao construir uma consulta, esteja ciente de que não há vinculação entre métrica, entidade e atributo. Utilize a seguinte consulta NRQL para saber quais as métricas disponíveis e quais os atributos presentes nestas métricas:
Para obter mais informações sobre facetas, séries temporais e seleção de tempo, consulte a documentação do NRQL.
Crie a consulta
Para construir uma consulta no estilo PromQL, consulte nossa documentação sobre recurso PromQL compatível.
Visualizar dados no New Relic
Ao consultar os dados, você pode visualizar os resultados na interface New Relic . Você também pode visualizar os dados como gráficos, histograma, etc.
Para visualizar os resultados da consulta NRQL para os dados da sua integração com o Prometheus:
- No New Relic, expanda o criador de consulta clicando na barra na parte inferior.
- Abra o menu criador de consulta clicando nos três pontos ao lado da ação Copiar seu link de consulta e selecione PromQL.
- No tradutor, insira sua consulta PromQL. Ele é traduzido automaticamente para uma consulta NRQL.
- Clique em Submit.
Para mais informações, consulte nossa documentação do criador de consulta.
Gerar histograma e calcular percentil
Usando a gravação remota do Prometheus ou versão 2.0.0 e superior da integração Prometheus OpenMetrics (POMI), você pode gerar histograma e calcular percentil a partir de seus dados. Para o histograma do Prometheus, um balde <basename>_bucket{le="42"}
será enviado como a métrica <basename>_bucket
e a dimensão será {histogram.bucket.le="42"}
.
NRQL possui duas funções que funcionam no histograma do Prometheus ingerido via gravação remota ou na integração do Prometheus OpenMetrics (a partir da versão 2.0.0): bucketPercentile()
e histogram()
. Os links incluem exemplos de consulta.