AWS X-Ray monitoring Intégration

New Relic propose une intégration pour générer des rapports sur vos données AWS X-Ray. Ce document explique comment activer cette intégration et décrit les données qui peuvent être signalées.

Activer l'intégration

Pour activer l'intégration d'AWS X-Ray, suivez les procédures standard pour connecter les services AWS à l'infrastructure.

Une fois que vous avez connecté avec succès votre compte AWS à New Relic :

Allez à one.newrelic.com > All capabilities > Infrastructure, puis cliquez sur AWS.
Cliquez sur Manage Services pour sélectionner l’intégration AWS que vous souhaitez activer.
Cochez la case à côté de AWS X-Ray.
Cliquez sur Save.

configuration et sondage

Vous pouvez modifier la fréquence d'interrogation et filtrer vos données à l'aide des options de configuration.

Voici les informations d’interrogation par défaut pour l’intégration AWS X-Ray :

Intervalle d'interrogation de New Relic : 5 minutes

Conseil

Veuillez patienter jusqu'à 20 minutes pour que votre première trace apparaisse. Étant donné que les traces sont collectées une fois terminées et une seule fois par intervalle d'interrogation, les données trace X-Ray sont considérablement en retard par rapport au temps réel et ne doivent pas être utilisées pour l'alerte.

Important

un intervalle d'interrogation supérieur à 5 minutes peut entraîner une perte de trace. New Relic laisse tomber des données de trace datant de plus de 20 minutes. De même, les traces de longue durée sont susceptibles d’être incomplètes. Monitoring de X-Ray collecte uniquement les traces terminées et les intervalles dans une trace datant de plus de 20 minutes sont supprimés.

Rechercher et utiliser des données

New Relic signale les segments X-Ray comme des donnéesSpan . Une fois cette intégration activée, vous devriez voir la trace AWS X-Ray apparaître dans le tracing distribué.

Pour filtrer vos spans, vous pouvez utiliser l'attribut newRelic.ingestPoint . Cet attribut est défini sur xray.polling pour toutes les plages de X-Ray.

Voici un exemple de requête NRQL pour vérifier l'ingestion de X-Ray :

SELECT count(*) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' TIMESERIES

Voici un exemple de requête NRQL pour corréler les données X-Ray avec des performances API spécifiques :

SELECT average(duration.ms) FROM Span WHERE newRelic.ingestPoint = 'xray.polling' 
AND http.url LIKE 'https://yourdomanin.com/api/v1/endpoint%' SINCE 1 month ago 
LIMIT MAX TIMESERIES 1 day

Utilisation de politiques IAM personnalisées

Si vous utilisez une stratégie IAM personnalisée lors de la connexion de votre compte AWS à l'agent d'infrastructure, votre stratégie personnalisée aura besoin des autorisations suivantes pour que l'intégration AWS X-Ray fonctionne :

xray:BatchGet*
xray:Get*

Fonctions X-Ray et Lambda

La fonction Lambda nécessite une certaine configuration pour utiliser X-Ray. Consultez la section Utilisation AWS X-Ray dans le guide des développeurs AWS Lambda .

En particulier, notez que le rôle d’exécution de votre fonction Lambda aura besoin d’autorisations supplémentaires pour enregistrer des données dans X-Ray.

Fonctions X-Ray et Steps

Les machines d'état AWS Step Function sont des applications distribuées et peuvent être monitorées avec X-Ray. Le tracing de X-Ray doit être explicitement activé pour que X-Ray capture les données des machines à états à fonction pas à pas.

Assurez-vous d'activer le tracing X-Ray pour toute fonction Lambda dans votre machine d'état ainsi que pour la machine d'état dans son ensemble.

Cette traduction automatique est fournie pour votre commodité.