Découvrez NerdGraph : notre API GraphQL

NerdGraph est notre API au format GraphQL qui vous permet d'interroger les données New Relic et de configurer certaines fonctionnalités New Relic . Après avoir créé un compte New Relic gratuit et installé l'un de nos services monitoring , vous pouvez commencer à utiliser NerdGraph.

Qu'est-ce que NerdGraph ?

NerdGraph est l'une des nombreuses API de New Relic. NerdGraph est l'API que nous recommandons pour interroger les données New Relic et pour effectuer certaines configurations spécifiques (en savoir plus sur les fonctionnalités). NerdGraph fournit une API interface unique pour renvoyer des données à partir des différentes API et microservices de New Relic. Au fil du temps, d’autres fonctionnalités de configuration seront ajoutées à NerdGraph.

Important

NerdGraph n'est pas utilisé pour l'ingestion de données. Pour cela, vous utiliserez nos API d'ingestion de données.

NerdGraph est construit à l'aide de GraphQL, un format d'API open source qui vous permet de demander exactement les données nécessaires, sans sur-extraction ni sous-extraction.

Exigences

Avant de commencer :

Vous avez besoin d'un compte New Relic , et avec ce compte, vous pouvez accéder à votre API que vous devez inclure avec la requête et les mutations.
Le type d'utilisateur et les rôles attribués peuvent affecter vos autorisations NerdGraph. Pour plus de détails, voir Facteurs affectant l’accès.

Point de terminaison

Les points de terminaison d'API que vous utilisez dépendent de la région de votredata center :

Point de terminaison principal : https://api.newrelic.com/graphql
Point de terminaison pour les comptes utilisant data center de l'UE : https://api.eu.newrelic.com/graphql

Pour accéder au point de terminaison, vous pouvez effectuer des appels à partir de votre code, utiliser l'explorateur d'API NerdGraph ou exécuter une commande curl similaire à celle-ci :

bash

$curl -X POST https://api.newrelic.com/graphql \
>     -H 'Content-Type: application/json' \
>     -H 'API-Key: YOUR_NEW_RELIC_USER_KEY' \
>     -d '{ "query":  "{ requestContext { userId apiKey } }" }'

Utiliser l'explorateur d'API NerdGraph

Un moyen simple d'expérimenter l'API NerdGraph est d'utiliser l'explorateur d'API NerdGraph. Pour obtenir de l'aide pour démarrer avec cet outil, consultez le didacticiel NerdGraph API Explorer.

Fonctionnalité NerdGraph

Les fonctionnalités de NerdGraph peuvent être divisées en deux catégories principales :

Querying data. Vous pouvez récupérer des données à diverses fins, notamment les utiliser dans un workflow programmatique ou créer une applicationNew Relic pour des visualisations de données personnalisées.
Configuring features. Il existe une variété de configurations disponibles et d'autres seront ajoutées au fil du temps. Vous pouvez effectuer des opérations telles que l'ajout d'étiquettes, la configuration de la charge de travail ou la personnalisation des « métriques dorées ».

Vous pouvez utiliser NerdGraph pour renvoyer et configurer une large gamme de données. Une façon de voir ce que NerdGraph peut faire est de commencer à créer une requête et à explorer le schéma à l'aide de l'explorateur NerdGraph.

Voici quelques-unes des fonctionnalités NerdGraph les plus couramment utilisées :

Obtenez des données sur votre entité de monitoring
vos données de requête en utilisant NRQL (notre langage de requête)
Créer un dashboard

Voici tous nos documents NerdGraph disponibles :

Sujet	Tutoriels
Gestion de compte	Gérer les comptes Gérer les utilisateurs Gérer les groupes d'utilisateurs Créer et gérer APIclé (clés d'ingest de données et clés utilisateur)
Alertes	Pour les alertes New Relic : voir tous les tutoriels liés aux alertes Pour la corrélation des alertes : configuration de la topologie pour la corrélation incident
agent	Agent APM configuration
	Installer agent de navigateur et configurer monitoring Instrumenter plusieurs applications à l'aide packageNPM
Suivi des changements	Suivre les modifications à l'aide de NerdGraph Suivre les modifications à l'aide de la CLI
Dashboards	Créer et gérer un dashboard Dashboards: graphiques et widgets Exporter le dashboard vers d’autres comptes Exporter le dashboard sous forme de fichiers Gérer le dashboard partagé en externe Gérer les graphiques partagés en externe
Intégrations cloud (AWS, Azure, GCP)	Configurer l'intégration cloud
Gestion des données	Convertir les données d'événement en données métriques Rétention des données données de streaming export Supprimer les données
Tracing distribué	Qequête traçage données distribuées Configurer le Infinite Tracing
Entité	Obtenir des données sur l'entité de monitoring Comprendre les relations et les dépendances entre entités (utilisées pour créer des cartes de services) requêter et configurer les "métriques dorées" (entités métriques importantes)
Gestion des logs	Gérer les partitions de données log Gérer les règles d'analyse des log Gérer l'expression d'obfuscation et les règles
Monitoring de l’activité mobile	Créer une nouvelle application mobile Récupérer un jeton d'application Exemples de configuration
New Relic	Créer une application New Relic
Interrogation et graphiques	Exécutez une requête NRQL de vos données Exécuter une requête sur plusieurs comptes Qequête asynchrone et de plus longue durée
Cartes de pointage	Créer et gérer des tableaux de bord et leurs règles
Indexation des données RAG	Améliorer NRAI avec RAG
Niveaux de service	Configurer et gérer le niveau de service
Monitoring synthétique	Gérez votre moniteur
étiqueter	Ajouter et gérer les tags
Équipes	Créez vos équipes
Workloads	Afficher et configurer la charge de travail

Terminologie NerdGraph

Les termes suivants proviennent de GraphQL, le format API utilisé par NerdGraph.

Terme	Définition
Qequêtes et mutations	Il existe deux classes d'opérations GraphQL : Les requêtes sont requests de base utilisées uniquement pour récupérer des données. Ces requêtes ne sont pas statiques, ce qui signifie que vous pouvez demander plus ou moins de données, selon vos besoins. Pour chaque requête, vous pouvez spécifier exactement les données que vous souhaitez récupérer, à condition qu'elles soient prises en charge par le schéma. Les mutations sont requests qui exécutent une action, comme la création d'une ressource ou la modification configuration. Les mutations nécessitent le mot-clé `mutation`, ainsi que le `name` de la mutation.
Type	Les données dans GraphQL sont organisées en types. Les types peuvent être des scalaires (comme des chaînes, des nombres ou des booléens) ou des types d'objets. Un type d'objet est un type personnalisé composé d'une collection de champs. Par exemple, un type d’objet appelé `User` peut représenter un utilisateur dans un système.
Champ	Un champ représente une information sur un type d'objet qui peut être interrogé. Les champs peuvent être des scalaires, des listes ou des objets. Par exemple, un type d’objet `User` pourrait avoir un champ de chaîne appelé `name`.
Interface	Une interface est un type abstrait qui représente une collection de champs communs que d'autres types d'objets peuvent `implement`.

Cette traduction automatique est fournie pour votre commodité.