L'API REST de New Relic vous permet de récupérer des données et de les envoyer vers les outils de New Relic, ainsi que de configurer des fonctionnalités et d'effectuer des opérations de suppression. Vous pouvez également utiliser l'API Explorer pour comprendre les données à votre disposition via l'API REST, pour obtenir la commande cURL et pour voir les réponses JSON.
Installation
La structure de commande de l'API REST suit ce modèle :
La commande GET peut également être un POST ou DELETE, selon l'intention de la requête.
Pour comprendre l’espace réservé, continuez à lire.
Conseil
Nos exemples utilisent curl comme outil de ligne de commande commun pour extraire les données d'intervalle de temps métrique de l'API REST. Cependant, vous pouvez utiliser n'importe quelle méthode pour effectuer vos requests REST. Les commandes curl incluent les URL cibles, les informations d'en-tête et les données pertinentes pour tout mécanisme de demande.
URL
L'appel d'API nécessite une URL pour spécifier l'emplacement à partir duquel les données seront accessibles. Vous devez remplacer l'espace réservé URL par l'URL appropriée qui changera en fonction du type de données demandées. En général, l'URL suit ce modèle :
https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.jsonLe $APP_ID spécifie l'application ou le produit exact pour lequel les données sont demandées. Les informations suivant ce paramètre varieront en fonction de la demande de données.
Si vous avez un compte dans la région UE, l'URL est :
api.eu.newrelic.com/v2/applications/$APP_ID/metrics/data.jsonConseil
Vous pouvez récupérer des données XML au lieu de JSON en remplaçant .json par .xml.
Clé API $API_KEY
L'API New Relic nécessite une clé API utilisateur: la clé utilisateur est également utilisée pour notre API NerdGraph.
Dans nos exemples d'API REST, nous empruntons l'espace réservé à la clé API $API_KEY à la programmation shell Unix. Assurez-vous de remplacer cette variable et d’autres variables spécifiques à l’utilisateur lors de la formation d’appels.
Détails de la requête (PAYLOAD)
Le PAYLOAD contient les détails de la requête, qui définissent :
- Le nom de la métrique que vous souhaitez interroger et la valeur que vous souhaitez récupérer
- La plage de temps définie pour la récupération des métriques
- (Facultatif) : La moyenne des données d'intervalle de temps métrique en utilisant le résumé
Exemples
Consultez les documents suivants pour obtenir des exemples de cas d’utilisation de l’API REST :
- ExemplesAPM (comment récupérer des données d'intervalle de temps métrique à partir de ).
- exemples de navigateur (comment récupérer des données d'intervalle de temps métrique à partir de ). L'API REST renvoie uniquement le script de l'agent de de navigateur Lite. Pour plus d'informations, consultez ce tableau comparant les types Lite, Pro et Pro+SPA.
- Exemples d'alertes d'infrastructure
- exemples d'alertes (créer une condition d'alerte et configurer un canal de notification, et plus encore).