Affichez et interrogez vos données Prometheus

Pour interroger et visualiser les métriques collectées pour votre intégration Prometheus OpenMetrics ou d'écriture à distance avec New Relic, vous pouvez utiliser NRQL. Vous pouvez également traduire votre requête de style PromQL en NRQL en utilisant Grafana ou le générateur de requêtes.

Toutes les métriques pour Docker et Kubernetes sont stockées dans le type Metric .

Attribut par défaut pour l'intégration OpenMetrics

Par défaut, l'attribut suivant sera ajouté à toutes les métriques pour l'intégration Docker et Kubernetes :

Kubernetes: Si le scraper Kubernetes s'exécute dans , New Relic ajoute également l'attribut suivant à toutes les métriques :

Attribut par défaut pour l'intégration d'écriture à distance

Par défaut, l'attribut suivant sera ajouté aux métriques d'écriture à distance Prometheus :

Exemples de requêtes NRQL

Lorsque vous créez une requête, sachez qu'il n'y a aucun lien entre les métriques, l'entité et l'attribut. Utilisez la requête NRQL suivante pour savoir quelles métriques sont disponibles et quels attributs sont présents sur ces métriques :

FROM Metric SELECT uniques(metricName)

FROM Metric SELECT uniques(metricName) WHERE instrumentation.provider='prometheus' 
AND instrumentation.name='remote-write'

FROM Metric SELECT uniques(metricName) WHERE instrumentation.provider='prometheus' 
AND instrumentation.name='remote-write' AND instrumentation.source='<ds>'

FROM Metric SELECT uniques(metricName) WHERE scrapedEndpoint='<ep>'

FROM Metric SELECT uniques(metricName) WHERE clusterName='<cn>'

FROM Metric SELECT uniques(metricName) WHERE namespaceName='<ns>'

FROM Metric SELECT uniques(metricName) WHERE podName='<pod>'

FROM Metric SELECT keyset() WHERE metricName='<mn>'

FROM Metric SELECT uniques(<attribute>) WHERE metricName='<mn>' AND podName='<pod>'

Pour plus d'informations sur les facettes, les séries chronologiques et la sélection temporelle, consultez la documentation NRQL.

Construire la requête

Pour créer une requête de style PromQL, consultez notre documentation sur les fonctionnalités PromQL prises en charge.

Obtenir des valeurs métriques

Pour obtenir des valeurs métriques brutes :

FROM Metric SELECT <metricName> WHERE <attribute>='<value>'

Copier

Obtenez un tableau de la métrique

Pour obtenir un graphique de la métrique avec un agrégateur de average, min, max ou sum:

FROM Metric SELECT <aggregator>(<metricname>) WHERE <attribute>='<value>' TIMESERIES

Copier

requête compteur métriques (deltas)

Actuellement, l'intégration calcule les deltas pour les métriques de compteur. C'est pourquoi la requête sur les métriques du compteur affichera les deltas du compteur au lieu de la valeur absolue du compteur.

Afficher les clients Redis connectés par pod avec OpenMetrics

Docker:

Cet exemple suppose que vous récupérez Redis exportateur. Pour afficher le nombre de clients Redis connectés par point de terminaison dans un cluster :

FROM Metric SELECT latest(redis_connected_clients) WHERE clusterName='my-cluster' 
FACET scrapedEndpoint TIMESERIES

Copier

Kubernetes:

Cet exemple suppose que vous disposez Redis d'un pod avec Redis l'exportateur installé. Pour afficher le nombre de clients Redis connectés par pod dans l'espace de nommage par défaut :

FROM Metric SELECT latest(redis_connected_clients) WHERE namespaceName='default' FACET podName TIMESERIES

Copier

Docker

Cet exemple suppose que vous récupérez un exportateur de nœuds pour Docker et que vous souhaitez utiliser OpenMetrics. Pour visualiser la mémoire moyenne disponible pour tous les points de terminaison grattés dans un cluster:

FROM Metric SELECT average(node_memory_MemFree_bytes) WHERE clusterName='my-cluster'

Copier

Kubernetes

Pour afficher l'utilisation moyenne de la mémoire pour tous les pods d'un Kubernetes déployé à l'aide d'OpenMetrics :

FROM Metric SELECT average(container_memory_usage_bytes) 
WHERE deploymentName='my-app-deployment' AND namespaceName='default'

Copier

Afficher les données dans New Relic

Lorsque vous interrogez les données, vous pouvez afficher les résultats dans l'interface utilisateur de New Relic. Vous pouvez également visualiser les données sous forme de graphiques, d'histogrammes, etc.

Pour afficher les résultats de la requête NRQL pour les données de votre intégration Prometheus :

1. Dans New Relic, développez le générateur de requêtes en cliquant sur la barre en bas.
2. Ouvrez le menu du générateur de requêtes en cliquant sur les trois points à côté de l’action Copier votre lien de requête, puis sélectionnez PromQL.
3. Dans le traducteur, entrez votre requête PromQL. Il est automatiquement traduit en une requête NRQL.
4. Cliquez sur Submit.

Pour plus d'informations, consultez notre documentation sur le générateur de requêtes.

Générer un histogramme et calculer le centile

En utilisant l'écriture à distance Prometheus ou la version 2.0.0 et supérieure de l'intégration Prometheus OpenMetrics (POMI), vous pouvez générer un histogramme et calculer le centile à partir de vos données. Pour l'histogramme Prometheus , un bucket <basename>_bucket{le="42"} sera envoyé comme métrique <basename>_bucket et la dimension sera {histogram.bucket.le="42"}.

NRQL dispose de deux fonctions qui fonctionnent sur l'histogramme Prometheus ingéré via l'écriture à distance ou l'intégration Prometheus OpenMetrics (à partir de la version 2.0.0) : bucketPercentile() et histogram(). Les liens incluent des exemples de requêtes.