Migrer vers NRQL

Listez les noms métriques pour votre application

Pour afficher les noms métriques disponibles pour votre application:

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE appId = '$APP_ID' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

Vous pouvez également filtrer en utilisant le nom de l'application :

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE appName = '$APP_NAME' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

Ou en utilisant un agent spécifique (hôte) :

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE realAgentId = '$AGENT_ID' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

Obtenez les valeurs des données d'intervalle de temps métrique de votre application

L'API REST v2 accepte une liste de noms de métriques et une liste de valeurs pour récupérer des données d'intervalle de temps métrique.

Les noms des métriques sont les mêmes, vous pouvez les filtrer avec le champ metricTimesliceName dans votre requête NRQL .

Chaque valeur d'API peut être mappée à une fonction NRQL, vous pouvez vous référer au tableau ci-dessous.

Exemple, pour la requête API suivante :

$
curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json" \
>
     -H "X-Api-Key:$API_KEY" -i \
>
     -d 'names[]=HttpDispatcher&values[]=average_call_time&values[]=call_count'

Vous utiliseriez la requête suivante :

SELECT count(newrelic.timeslice.value) AS call_count, 
       average(newrelic.timeslice.value) * 1000 AS average_call_time
FROM Metric
WHERE appId = $APP_ID AND metricTimesliceName = 'HttpDispatcher'

Si la fonction inclut $TIME_WINDOW_IN_SECONDS, cela signifie que vous devez la remplacer par la fenêtre temporelle que vous souhaitez interroger.

Par exemple, si vous interrogez une fenêtre temporelle de 30 minutes, vous remplacerez $TIME_WINDOW_IN_SECONDS par 1800.

Apdex métriques

Métriques des utilisateurs finaux et des appareils mobiles

Ces métriques renverront le même résultat que celui que vous obtiendriez à partir de l'API REST v2, mais certains résultats peuvent différer de ce que vous voyez sur l'UI de New Relic. En effet, l'UI utilise des événements au lieu de données d'intervalle de temps. Si vous souhaitez obtenir les mêmes résultats que l'UI, vous devez interroger directement l'événement.

Séries chronologiques et résumés

Par défaut, l'API REST renvoie une série de valeurs de données métriques basées sur. Pour obtenir la moyenne de ces valeurs, vous devez inclure &summarize=true dans votre appel d'API.

Dans NRQL, c'est le contraire. Vous obtenez un résumé par défaut et vous pouvez obtenir la série chronologique en ajoutant TIMESERIES à votre requête.

Une autre différence est que la fenêtre temporelle par défaut de l’API REST est de 30 minutes, alors que dans NRQL, elle est de 1 heure.

requête multiple métrique

Vous pouvez toujours interroger plusieurs métriques à la fois avec NRQL, voici un exemple :

SELECT
    filter(1000 * average(newrelic.timeslice.value), WHERE metricTimesliceName = 'HttpDispatcher') AS average_response_time,
    filter(count(newrelic.timeslice.value), WHERE metricTimesliceName = 'Errors/all') AS error_count,
    filter(average(newrelic.timeslice.value), WHERE metricTimesliceName = 'Memory/Heap/Max') AS used_mb_by_host
FROM Metric
WHERE appName = '$APP_NAME'
SINCE 1 day ago