Le langage de requête New Relic (NRQL) est un outil puissant que vous pouvez utiliser pour interroger et comprendre presque n'importe quel type de données, mais il peut sembler écrasant à première vue. Ne t'inquiète pas! Voici quelques informations pour vous donner une compréhension fondamentale de NRQL, y compris ce que c'est, comment l'utiliser et quelques trucs et astuces qui vous aideront à tirer le meilleur parti de votre requête. Une fois que vous avez découvert NRQL, vous pouvez capturer et interpréter vos données, ce qui vous permet de décomposer la situation dans son ensemble en éléments facilement compréhensibles et de vous aider à identifier les problèmes au fur et à mesure qu'ils surviennent.
Voici une vidéo rapide pour vous aider à vous familiariser avec l'utilisation NRQL en vous montrant comment trouver une requête à partir d'un dashboard et la modifier dans le générateur de requêtes. Pour des informations plus détaillées sur les requêtes, y compris une liste de clauses, de fonctions et d'exemples de requêtes, consultez notre référence NRQL .
Qu'est-ce que NRQL ?
NRQL est un acronyme du langage de requête New Relic. C'est un langage de requête similaire à ANSI SQL (voir la syntaxe), et vous pouvez l'utiliser pour récupérer des données New Relic détaillées afin d'obtenir des informations détaillées sur vos applications, vos hôtes et vos activités importantes pour votre entreprise. NRQL peut vous aider à :
- Créer un nouveau graphique
- Répondre à une question spécifique à des fins de dépannage ou d'analyse commerciale
- Configurer des alertes basées sur NRQL (notre type d'alerte principal et le plus puissant)
- Effectuer une requête API sur les données New Relic (par exemple, en utilisant notre API NerdGraph )
Vous pouvez utiliser NRQL pour créer des requêtes simples, telles que la récupération de lignes de données sous forme de tableau brut qui donne des informations détaillées sur un événement individuel. Vous pouvez également utiliser NRQL pour exécuter des calculs puissants sur les données avant qu'elles ne vous soient présentées, comme la création d'entonnoirs basés sur la façon dont l'utilisateur final interagit avec votre site ou votre application.
Nous utilisons NRQL en coulisses pour générer de nombreux graphiques et tableaux de bord dans nos expériences d'interface utilisateur organisées :
Nous créons de nombreux graphiques et visualisations dans New Relic à l'aide de NRQL. Vous pouvez afficher la requête d'un graphique, puis la modifier pour créer votre propre graphique personnalisé afin de commencer rapidement à utiliser NRQL.
Où pouvez-vous utiliser NRQL ?
Vous pouvez utiliser NRQL sur la plateforme pour accéder à vos données. Ces endroits incluent :
Conseil
NRQL est l’un des nombreux moyens d’interroger les données New Relic. Pour en savoir plus sur toutes les options de requête, consultez requêter vos données.
Comment est structuré NRQL ?
Si vous êtes déjà familiarisé avec l’écriture de requêtes SQL, vous serez heureux de savoir que NRQL présente de nombreuses similitudes. Voici une description rapide de la structure d’une requête NRQL :
SELECT function(attribute) [AS 'label'][, ...]
FROM data type
[WHERE attribute [comparison] [AND|OR ...]][AS 'label'][, ...]
[FACET attribute | function(attribute)]
[LIMIT number]
[SINCE time]
[UNTIL time]
[WITH TIMEZONE timezone]
[COMPARE WITH time]
[TIMESERIES time]Voici les règles suivies par NRQL :
NRQL rule | Détails |
|---|---|
Valeurs requises | Les clauses |
Taille de la chaîne de requête | La chaîne de requête doit être inférieure à 4 Ko. |
Sensibilité à la casse |
|
Syntaxe pour les chaînes | NRQL utilise des guillemets simples pour désigner les chaînes. Par exemple: |
Noms d'événement et d'attributs personnalisés non standards | Les événements que nous signalons par défaut ont des noms qui contiennent des caractères alphanumériques, des deux points ( |
Coercition du type de données | Nous ne prenons pas en charge le type de données « coercition ». Pour plus d'informations, voir Conversion de type de données. |
Si vous avez besoin de plus d'informations, vous pouvez consulter notre référence NRQL pour vous aider à créer votre requête.
Quelles données pouvez-vous interroger avec NRQL?
NRQL vous permet d'interroger presque tous les types de données télémétriques, notamment :
Données d'événement de tous les produits New Relic. Voici quelques exemples :
- Événement APM, comme
Transaction - monitoring des navigateurs événement, comme
PageView - monitoring des applications mobiles événement, comme
Mobile - infrastructure événement, comme
ProcessSample - Synthétique événement, comme
SyntheticCheck - événement personnalisé, comme ceux rapportés par l'API événement
- Événement APM, comme
intervalle de temps métrique data (métriques rapportées par APM)
Le type de données
Metric(métriques signalées par l'API métrique et les sources de données qui utilisent cette API)Le type de données
Span(des données de tracing distribué)Le type de données
Log(données issues de nos capacités de gestion des log )
Conseil
Certaines données, comme les relations entre les entités monitorées, ne sont pas disponibles via NRQL mais sont disponibles à l'aide de notre API NerdGraph.
Prêt à en savoir plus ? Nous avons des informations sur la façon d'utiliser NRQL et sur la façon d'utiliser les graphiques et les tableaux de bord avec NRQL. Si vous souhaitez plutôt commencer à utiliser NRQL, accédez directement à notre didacticiel guidé NRQL.