L'API métrique de New Relic peut être utilisée pour envoyer des données métriques à New Relic à partir de diverses sources. Cette API permet aux métriques de certaines de nos intégrations et exportateurs d'entrer dans New Relic.
Vous souhaitez tester notre API métrique ? Créez un compte New Relic gratuitement ! Aucune carte de crédit requise.
Qu'est-ce que l'API métrique ?
L'API métrique est un moyen d'intégrer des données métriques dans New Relic. L'API fonctionne en envoyant une requête POST à notre point de terminaison HTTP avec une charge JSON contenant les données métriques.
L'API métrique est la manière dont les métriques sont ingérées à partir de certaines de nos intégrations, y compris notre exportateuropen source (comme DropWizard et Prometheus). L'API métrique est également utilisée par nos SDK de télémétrie, qui sont des outils spécifiques au langage qui facilitent l'utilisation de nos API d'ingestion de données.
L'API métrique peut être utilisée pour :
- Signaler les données métriques à New Relic sans agent New Relic.
- Intégrez des données métriques à partir d'un open source outil, d'une bibliothèque ou framework d'un ou développé en interne.
- Contrôlez entièrement les données métriques que vous envoyez, y compris la résolution et les dimensions associées.
- Exploitez la puissance de NRQL, le langage de requête de New Relic, pour interroger vos données métriques.
- Configurez des alertes pour vos données métriques.
Exigences
Assurez-vous que la connectivité sortante sur le port TCP 443 est autorisée sur la plage CIDR qui correspond à votre région. La méthode de configuration préférée consiste à utiliser le nom DNS metric-api.newrelic.com ou metric-api.eu.newrelic.com.
Vous aurez besoin d'un New Relic pour le compte New Relic auquel vous souhaitez envoyer des données. Pour plus d'informations sur les limites et les attributs restreints, consultez les exigences et limites de l'API métrique.
Démarrer
Si nous ne disposons pas d'une intégration ou d' quickstart existant qui répond à vos besoins en matière de rapports métriques, vous avez deux options :
- Utilisez nos SDK de télémétrie, qui sont des outils spécifiques à chaque langue qui vous aident à nous envoyer des métriques et d'autres données.
- Utilisez directement l'API métrique.
Trouvez et utilisez vos données
Vous pouvez trouver les données envoyées via l'API métrique (y compris depuis les intégrations qui utilisent cette API) à ces emplacements :
À partir de one.newrelic.com, sélectionnez Explorer et recherchez votre service.
En interrogeant le type de données
Metric. Par exemple, vous pouvez utiliser NRQL pour exécuter :SELECT * FROM MetricPour en savoir plus sur les requêtes, consultez les exemples de requêtes métriques. Pour plus d'informations sur les requêtes en général, voir requête data.
Alerte sur les données métriques
Pour alerter sur les métriques créées avec l'API métrique, utilisez la condition d'alerte NRQL : Sélectionnez la catégorie NRQL lors de la définition de votre condition, puis utilisez la syntaxe de requête NRQL FROM Metric ... pour l'exprimer. Lorsque vous créez ces conditions d'alerte, utilise automatiquement les données de granularité les plus fines disponibles (les points de données métriques brutes) pour évaluer les alertes.
Rétention des données
Tous les points de données métriques bruts seront conservés pendant 30 jours. Toutes les données agrégées supplémentaires dérivées des points de données métriques brutes (par exemple, les cumuls d'une minute) seront conservées pendant 13 mois. Toute modification de la durée de conservation au-delà de ces périodes peut entraîner des frais à votre charge.
Dépannage
Voir Résoudre les problèmes d'un événement NrIntegrationError .