L'APM de New Relic attribue des identifiants aux entités liées à une application. Ils sont utilisés pour collecter des informations sur le fonctionnement et les performances de différents points de vue. Ces identifiants peuvent être renvoyés via l'API REST de New Relic.
Les identifiants peuvent inclure :
- identifiant d'application
$APP_ID
pour chaque application instrumentée - ID hôte
$HOST_ID
pour chaque hôte - ID d'instance
$INSTANCE_ID
s'il existe plusieurs instances de l'application
Pour répertorier l'un de ces identifiants dans l'explorateur d'API New Relic, vous avez besoin d'une clé API.
Utiliser l'explorateur d'API
- Allez au API Explorer.
- Dans la liste déroulante Servers , choisissez une URL d’API basée aux États-Unis ou dans l’UE.
- Cliquez sur Authorize, entrez votre clé API utilisateur et cliquez à nouveau sur Authorize .
- Développez l’une des fonctions API disponibles : GET, PUT, DELETE.
- (Facultatif) Ajoutez des valeurs Parameters pour votre appel d'API afin de filtrer la réponse (reportez-vous à l'UI pour les descriptions et les exigences de la v2).
- Dans la liste déroulante Media type , choisissez un format pour votre demande : JSON ou XML.
- Cliquez sur Try it out, puis sur Execute.
Lister les identifiants des produits
Pour renvoyer une liste de tous les identifiants de produit pour un produit particulier :
- Cliquez sur la liste déroulante
GET /applications.json
. - Cliquez sur Try it out, puis sur Execute.
- Parcourez la réponse pour afficher tous les identifiants de produit.
Une fois que vous avez localisé un ID de produit spécifique, copiez-le pour plus tard dans votre autre appel d'API REST.
Liste des identifiants d'application
Chaque application monitorée par unagent se voit attribuer un nom. Un $APP_ID
unique est également associé à ce nom. Le $APP_ID
est fondamental pour récupérer des informations sur vos applications. Pour plus d'informations sur l'affichage et l'utilisation du $APP_ID
et sur l'obtention des données récapitulatives, voir Affichage de l'ID de votre application.
ID de la liste des hôtes
Le $HOST_ID
est utilisé pour obtenir des données APM pour un hôte spécifique exécutant une application. Un serveur physique peut avoir plusieurs hôtes. Par exemple, un programme de serveur Web exécuté sur un serveur physique peut être configuré pour avoir plus d'un hôte virtuel.
Les identifiants de l'hôte et du serveur physique ne sont pas les mêmes. Chaque ID hôte est unique et représente des éléments différents.
Utilisez le $HOST_ID
pour récupérer le récapitulatif métrique de l'hôte ainsi que les valeurs d'intervalle de temps métrique spécifiques. Pour plus d’informations sur les métriques disponibles :
- Allez à rpm.newrelic.com.
- Accédez à l’ explorateur d’API, puis sélectionnez le nom de votre compte dans la liste déroulante Select an account .
- Accédez à la page Application host de l'explorateur d'API à l'adresse rpm.newrelic.com/api/explore/application_hosts/names.
Liste d'identifiants d'instance
La signification de l'ID d'instance dépend de l'agent de langage New Relic utilisé. Vous pouvez répertorier cet ID à partir de l'API REST. Pour Java, vous pouvez également afficher l'ID d'instance (JVM) à partir de la page Overview d'APM.
agent | L'ID d'instance représente |
---|---|
Go | Le programme Go sur l'hôte faisant rapport au nom de l'application |
Java | Une machine virtuelle Java (JVM) |
.NET | Pour l'agent pour .NET Framework, c'est le |
Node.js | Un processus de travail |
PHP | L'agent démon |
Ruby | Un processus de travail Ruby individuel |
Python | Les processus maître et ouvrier |
Vous pouvez récupérer le récapitulatif métrique pour l'instance ainsi que les valeurs d'intervalle de temps métrique spécifiques à l'aide du INSTANCE_ID
. Pour plus de détails sur les métriques disponibles, utilisez la page d’instance d’application REST API Explorer .
Exemple de listeAPI REST application
L'exemple suivant montre comment localiser toutes les informations d'ID d'une application à l'aide de APP_ID
. Si vous avez un compte UE, le point de terminaison commence par https://api.eu.newrelic.com
.
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i \> -d 'filter[ids]=1441' <----<<<< APP_ID
L'exemple de sortie résultant s'exécute sur cinq serveurs. Un serveur héberge deux hôtes virtuels pour un total de six hôtes. La sortie comprend une section links
répertoriant les application_instances
et application_hosts
de l'application.
{ "applications": [ { "id": 1441, <----<<<< APP_ID "name": "RPM Combined Production", "language": "ruby", "health_status": "green", "reporting": true, "last_reported_at": "2015-11-10T23:19:47+00:00", "application_summary": { . . . }, "end_user_summary": { . . . }, "settings": { . . . }, "links": { "application_instances": [ <---<<<< INSTANCE_ID list 21790, 24810, 27948, 35120, 35121, 35122, 186288, 247253, 247254, 247255, 247256 ], "application_hosts": [ <---<<<< HOST_ID list 21788, 24808, 34966, 186283, 247245, 286551 ] } } ],. . .