requête le type de données métrique

Lorsque des métriques sont signalées à New Relic via l' API métrique (y compris à partir d'une intégration qui utilise cette API), les données sont signalées comme type de donnéesMetric et sont disponibles pour l'interrogation.

Ce document explique :

• Comment visualiser et requêter vos métriques
• Exemple de requête métrique
• Comment requêter plusieurs métriques avec des caractères génériques
• Comment explorer les données métriques

requête APM intervalle de temps métrique data

APM rapporte un type spécifique de données que nous appelons données d'intervalle de temps métrique. Pour savoir comment effectuer une requête, voir requête intervalle de temps métrique data.

Pour plus d'informations sur d'autres types de métriques, consultez types de données métriques.

Visualisez et requêtez vos métriques

Vous pouvez utiliser NRQL pour requêter vos données métriques dans le générateur de requêtes ou en utilisant notre API NerdGraph.

Pour requête a métrique, vous pouvez utiliser le format de requête suivant :

FROM Metric SELECT function(metric_name) WHERE attribute=value FACET attribute TIMESERIES

Pour plus d'informations sur les fonctions prises en charge pour les types de données métriques, voir structure de données métrique.

Ajoutez les noms des métriques que vous souhaitez représenter graphiquement avec la fonction de valeur appropriée dans la clause SELECT . Les clauses WHERE et FACET peuvent être utilisées avec des valeurs d'attribut. N'oubliez pas d'inclure le mot-clé TIMESERIES si vous souhaitez représenter les données sous forme de graphique.

Cet exemple montre comment vous pouvez représenter graphiquement l'utilisation du processeur en secondes pour le cluster foo . Cette requête décompose l'utilisation du processeur par conteneur, étant donné une métrique count nommée container_cpu_usage_seconds_total avec l'attribut containerName et clusterName:

FROM Metric SELECT sum(container_cpu_usage_seconds_total) 
WHERE clusterName = 'foo' 
FACET containerName 
TIMESERIES

Si vous souhaitez connaître l'utilisation du processeur par minute (le taux de variation), vous pouvez ajouter la fonction de taux à la requête ci-dessus.

FROM Metric SELECT rate(sum(container_cpu_usage_seconds_total), 1 minute) 
WHERE clusterName = 'foo' 
FACET containerName 
TIMESERIES

Voir un exemple de requête métrique

Les exemples précédents illustrent les formes de base de requêtes métriques, mais NRQL peut également être utilisé pour représenter graphiquement, explorer et analyser des données métriques.

FROM Metric 
SELECT latest(container_memory_usage_bytes), latest(container_spec_memory_limit_bytes) 
WHERE containerName = 'inventory' 
TIMESERIES

FROM Metric 
SELECT (latest(container_spec_memory_limit_bytes) - latest(container_memory_usage_bytes)) 
  / latest(container_spec_memory_limit_bytes) 
  * 100 
  AS '% Memory Available' 
WHERE containerName = 'inventory' 
TIMESERIES

FROM Metric 
SELECT filter(
  latest(container_memory_usage_bytes), 
  WHERE containerName = 'discovery') 
+ filter(
  latest(container_memory_usage_bytes), 
  WHERE containerName = 'my-proxy') 
AS 'Total (k8s)' 
WHERE clusterName = 'my-cluster' AND podName LIKE 'my-pilot-%' 
TIMESERIES

FROM Metric SELECT * WHERE metricName = 'container_fs_usage_bytes' LIMIT 20 RAW

requête plusieurs métriques avec caractères génériques

Les caractères génériques sont représentés dans NRQL par le caractère % . Si vous souhaitez interroger plusieurs métriques qui utilisent une convention de dénomination standard, vous pouvez utiliser la fonctionnalité générique pour renvoyer des résultats pour chacune d'entre elles sans avoir à spécifier chaque nom de métrique individuellement.

Les caractères génériques peuvent vous aider à :

• métrique agrégée ensemble et tracer les résultats
• FACET résultats par nom de métrique dans un graphique
• Rechercher et représenter graphiquement toutes les métriques correspondant à une convention de dénomination donnée

Les caractères génériques sont particulièrement utiles si vous ajoutez ultérieurement de nouvelles métriques correspondant à une convention de dénomination existante. En utilisant % au lieu d'écrire chaque nom de métrique dans votre requête, vous n'aurez pas à réécrire la requête lorsque vous ajouterez de nouvelles métriques.

Disons que vous avez plusieurs algorithmes qui effectuent une tâche similaire. Vous pouvez définir les métriques suivantes, qui montrent la durée des différents algorithmes :

• myNeatProcess.algorithm1.duration
• myNeatProcess.algorithm2.duration
• myNeatProcess.algorithm3.duration

Si utilisé dans une requête, myNeatProcess.%.duration renverra des résultats pour les trois algorithmes ci-dessus. Si vous créez ultérieurement de nouveaux algorithmes nommés algorithm4, algorithm5 et algorithm6, la même requête renverra des résultats pour les six algorithmes.

FROM Metric 
SELECT average(myNeatProcess.%.duration) 
FACET metricName TIMESERIES

FROM Metric 
SELECT average(myNeatProcess.%.duration) 
TIMESERIES

FROM Metric 
SELECT myNeatProcess.algorithm1.duration / sum(myNeatProcess.%.duration) 
TIMESERIES

Renvoyer les résultats pour les champs individuels en utilisant getField()

Il existe plusieurs types de données Metric (par exemple, gauge et count) et chaque type a plusieurs fields associés. Pour plus de détails sur les types de champs disponibles, voir getField().

Vous pouvez utiliser getField() pour extraire ces champs. Par exemple, si vous souhaitez utiliser une valeur unique dans une métrique pour effectuer une comparaison dans une clause WHERE, vous pouvez utiliser getField(metricName, field) ou la syntaxe abrégée metricName[field].

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND getField(apm.service.transaction.duration, total) / getField(apm.service.transaction.duration, count) > 2

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND apm.service.transaction.duration[total] / apm.service.transaction.duration[count] > 2

FROM Metric 
SELECT uniques(metricName) 
WHERE getField(%, type) = 'gauge'

FROM Metric 
SELECT uniques(metricName) 
WHERE %[type] = 'gauge'

Explorer les données métriques

Les fonctions NRQL keyset et uniques peuvent être utilisées avec l'attribut metricName (disponible sur toutes les métriques) pour effectuer des tâches telles que répertorier toutes les métriques disponibles dans votre compte ou découvrir l'attribut disponible sur une métrique particulière.

FROM Metric SELECT uniques(metricName)

FROM Metric SELECT uniques(metricName) WHERE hostname = 'host1.mycompany.com'

FROM Metric SELECT keyset() WHERE metricName = METRIC_NAME