New Relic Query Language (NRQL) est un langage de type SQL permettant d’effectuer une requête sur vos données New Relic. Le même langage de requête qui alimente les graphiques et dashboards intégrés de New Relic est à votre disposition, afin que vous puissiez créer les vues et les alertes dont votre équipe a besoin.
Voici une vidéo pour vous aider à vous familiariser avec l’utilisation de 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.
Ce que vous pouvez faire avec NRQL
Utilisez NRQL pour :
- Créez des graphiques qui montrent le débit de transaction, les taux d’erreur, ou la latence au fil du temps
- Répondre à une question spécifique à des fins de dépannage ou d'analyse commerciale
- Examinez un problème de performances en interrogeant les événements et attributs spécifiques impliqués
- Configurer des alertes basées sur NRQL qui se déclenchent lorsqu’une métrique franchit un seuil
- Effectuez des requêtes d’API pour vos données New Relic par exemple, en utilisant notre API NerdGraph.
NRQL fonctionne aussi bien pour les requêtes de base (récupération de lignes brutes de données d’événements) que pour les résultats calculés, tels que les entonnoirs basés sur la façon dont les utilisateurs interagissent avec votre site ou application.
Conseil
New Relic utilise NRQL en interne pour alimenter les graphiques, et les dashboard de la plateforme New Relic. Ce même langage de requête est à votre disposition.
Types de données interrogeables
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
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.
Où utiliser NRQL
NRQL est disponible sur toute la plateforme :
Accédez au générateur de requêtes via le tiroir Query your data en bas de n’importe quelle page New Relic pour exécuter des requêtes et créer des graphiques personnalisés.
Vous pouvez exécuter une requête NRQL dans le générateur de requêtes au sein de la plateforme. Cette requête NRQL affiche un nombre de spans de tracing distribué classés par leurs noms d’entité.
Les alertes basées sur NRQL sont le principal type d’alerte dans New Relic. Pour en créer un, accédez à one.newrelic.com > All capabilities > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition, cliquez sur NRQL, et ensuite sur Next, define thresholds.
Vous pouvez également utiliser NRQL avec notre API NerdGraph. Cela vous permet d’exécuter des requêtes multicomptes et des requêtes asynchrones qui ne sont pas disponibles dans l’interface utilisateur.
Structure de requête NRQL
NRQL suit une syntaxe structurée, basée sur des clauses. Voici une requête NRQL qui compte toutes les transactions de la dernière heure :
SELECT count(*) FROM Transaction SINCE 1 hour agoVoici le détail de toutes les clauses disponibles :
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 | Les noms de types de données et les noms d’attributs sont sensibles à la casse. Les clauses et fonctions NRQL ne sont pas sensibles à la casse. |
Syntaxe pour les chaînes | NRQL utilise des guillemets simples pour désigner les chaînes de caractères. L’exemple suivant montre la syntaxe : |
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. |
Pour plus d’informations, consultez notre référence NRQL pour vous aider à créer votre requête.
Prochaines étapes
- Fonctionnement de NRQL (exécution des requêtes, fraîcheur des données, et limites)
- Graphiques et dashboards avec NRQL (visualisez les résultats de votre requête)
- Tutoriel NRQL guidé (guide pratique pour les nouveaux utilisateurs)
- Référence NRQL (syntaxe complète, clauses, et fonctions)