Important
Activez l' intégrationAWS CloudWatch Metric Streams pour monitorer toutes les métriques CloudWatch de vos services AWS, y compris l'espace de nommage personnalisé. L’intégration individuelle n’est plus notre option recommandée.
L'intégration de New Relic Infrastructure inclut une intégration permettant de signaler vos données Amazon API Gateway à New Relic. Ce document explique comment activer cette intégration et décrit les données qui peuvent être signalées.
Conseil
Les métriques API Gateway v1 sont disponibles exclusivement via l'intégration d'interrogation API pour Amazon API Gateway. Les métriques API Gateway v2 sont diffusées via le flux de métriques CloudWatch.
Caractéristiques
API Gateway d'Amazon est un service entièrement géré qui vous permet de créer, publier, maintenir, monitorer et sécuriser des API à n'importe quelle échelle. Avec l'intégration de New Relic API Gateway, vous obtenez davantage de données sur le fonctionnement de votre couche API en coulisses. Vous recevrez des données métriques sur le nombre d'appels d'API, les requests traitées, le nombre d'erreurs, les nombres de latences, etc.
Vous pouvez monitorer et alerter sur vos données API Gateway directement depuis New Relic, interroger les données et créer un dashboard.
Exigences
API Gateway n'enverra pas les métriques « Nombre d'appels par ressource », « Erreur 4xx par ressource » et « Erreurs 5xx par ressource » à moins que vous n'ayez explicitement activé les métriques CloudWatch détaillées.
Conseil
L'activation de ces mesures peut ajouter des frais supplémentaires à la tarification de votre compte Amazon CloudWatch .
Pour activer les métriques CloudWatch, utilisez l’une de ces options :
- Accédez à la console de gestion AWS, sélectionnez l’option Settings pour CloudWatch, puis sélectionnez l’option permettant d’activer les métriques CloudWatch détaillées.
- Appelez l’action
stage:updatede l’API REST Amazon API Gateway pour mettre à jour la propriétémetricsEnabledentrue.
Activer l'intégration
Pour activer cette intégration, suivez les procédures standard pour connecter les services AWS à New Relic.
configuration et sondage
Vous pouvez modifier la fréquence d'interrogation et filtrer les données à l'aide des options de configuration.
Informations d'interrogation par défaut pour l'intégration de la passerelle API Amazon :
- Intervalle d'interrogation de New Relic : 5 minutes
- Intervalle de données Amazon CloudWatch : 1 minute
Rechercher et utiliser des données
Pour trouver vos données d’intégration dans l’UI de l'infrastructure, accédez à one.newrelic.com > All capabilities > Infrastructure > AWS et sélectionnez l’un des liens d’intégration API Gateway.
Vous pouvez interroger et explorer vos données en utilisant le type d'événement ApiGatewaySample .
Pour en savoir plus sur l’utilisation de vos données, consultez Comprendre et utiliser les données d’intégration.
données métriques
Cette intégration de New Relic Infrastructure collecte les données Amazon API Gateway suivantes :
métrique | Description |
|---|---|
| Le nombre d'erreurs côté client capturées |
| Le nombre d’erreurs côté serveur capturées. |
| Le nombre de requests traitées à partir du cache API. |
| Le nombre de requests traitées depuis le backend lorsque la mise en cache de l'API est activée. |
| Le nombre d'appels aux méthodes API. |
| Le temps en millisecondes entre le moment où API Gateway relaie une requête au backend et le moment où elle reçoit une réponse du backend. |
| Le temps en millisecondes entre le moment où API Gateway reçoit une demande d'un client et le moment où elle renvoie une réponse au client. La latence inclut la latence d'intégration et d'autres frais généraux de la passerelle API. |
Dimensions
Vous pouvez utiliser les dimensions du tableau suivant pour filtrer les métriques API Gateway.
Dimensions | Description |
|---|---|
| Filtre les métriques API Gateway pour une API du nom d'API spécifié. |
| Filtre les métriques API Gateway pour une méthode API de l'API, de l'étape, de la ressource et de la méthode spécifiées. |
| Filtre les métriques API Gateway pour une étape d'API de l'API et de l'étape spécifiées. |