Voici quelques exemples d'utilisation de New Relic REST API (v2) pour obtenir les noms de métriques et les valeurs moyennes pour un identifiant d'application et une clé spécifiques.API Les exemples montrent également différentes plages de temps.
Lors de l'acquisition de données, les valeurs renvoyées peuvent être affectées par la période que vous spécifiez et la manière dont les données sont stockées. Pour plus d'informations, voir Extraction de données d'intervalle de temps métrique.
Lister tous les identifiants d'application
Vous pouvez également utiliser le REST API Explorer de New Relic pour obtenir les mêmes données d'intervalle de temps métrique pour les informations de votre application que cet exemple.
Pour afficher tous les ID de vos applications, utilisez la commande suivante.
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i
- Remplacez
$API_KEY
par votre clé API.
La sortie sera un ensemble de données où l'élément est une application et les données qui lui sont associées. Par exemple, voici les deux premiers éléments pour l'ID d'application 96785 (« GreatTimes simulation ») et 1622 (« GreatTimes Prod ») :
{ "applications": [ { "id": 96785, "name": "GreatTimes Staging", "language": "ruby", "health_status": "gray", ... }, { "id": 1622, "name": "GreatTimes Prod", "language": "ruby", "health_status": "green", ... } ]}
Lister les identifiants d'application par nom
Pour afficher l'ID d'une application spécifique si vous connaissez le nom, remplacez le nom de $NAME
et $API_KEY
par votre clé API dans la commande suivante :
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i \> -d "filter[name]=$NAME"
Le résultat sera le même que celui indiqué dans l'exemple de liste de tous les ID d'application, mais uniquement pour l'application spécifique.
lignes directrices pour l'inscription des noms métriques
Lister les noms métriques disponibles pour votre application peut être une opération très intensive et ne doit être utilisée qu'en cas de nécessité. Lister un grand nombre de noms métriques peut avoir un effet néfaste sur votre réactivité, ainsi que sur celle d'autres utilisations et peut conduire à invoquer une protection contre les surcharges.
Suivez ces directives pour optimiser votre utilisation :
Liste des noms métriques | Lignes directrices |
---|---|
noms métriques | Réfléchissez bien aux noms métriques dont vous avez besoin. Si vous connaissez une partie du nom de la métrique, utilisez le filtre |
Cache | Une fois que vous avez obtenu vos noms métriques, pensez à mettre en cache cette liste pour une utilisation future. Dans la plupart des cas, les noms métriques ne sont pas volatils et peuvent être réutilisés, ce qui permet de gagner du temps de traitement. |
Listez les noms métriques pour votre application
Pour afficher les noms métriques disponibles pour votre application:
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \> -H "Api-Key:$API_KEY" -i
- Remplacez
$API_KEY
par votre clé API.
Le résultat sera similaire à ce qui suit. Ceci montre deux des nombreux noms métriques disponibles et leurs valeurs. Ces listes peuvent être longues. Veuillez tenir compte des directives pour répertorier vos noms métriques.
{ "metrics": [ { "name": "ActiveRecord/Account/create", "values": [ "average_response_time", "calls_per_minute", "call_count", "min_response_time", "max_response_time", "average_exclusive_time", "average_value", "requests_per_minute", "standard_deviation" ] }, ... { "name": "Apdex/members/destroy", "values": [ "s", "t", "f", "count", "score", "value", "threshold", "threshold_min" ] }, ... ]}
Filtrez la sortie du nom de votre métrique, pour renvoyer une liste plus petite, en spécifiant le filtre name=
comme ceci :
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \> -H "Api-Key:$API_KEY" -i \> -d "name=Controller/welcome/index"
- Remplacez
$API_KEY
par votre clé API.
Obtenez les valeurs des données d'intervalle de temps métrique de votre application
Pour visualiser les données d'intervalle de temps métrique de votre application:
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \> -H "Api-Key:$API_KEY" -i \> -d 'names[]=EndUser&values[]=call_count&values[]=average_response_time&summarize=true'