Présentation

Amazon API Gateway est un service entièrement géré qui permet aux développeurs de créer, publier, gérer, surveiller et sécuriser facilement des API quelque soit l’échelle.

Activez cette intégration pour visualiser dans Datadog toutes vos métriques dʼAPI Gateway.

Configuration

Installation

Si vous ne l’avez pas déjà fait, configurez l’intégration Amazon Web Services.

Collecte de métriques

1. Sur la page de l’intégration AWS, vérifiez que API Gateway est activé dans l’onglet Metric Collection.

2. Ajoutez les autorisations suivantes à votre stratégie IAM Datadog afin de récupérer les tags personnalisés appliqués aux étapes API Gateway :

   • apigateway:GET
   • tag:GetResources

3. Installez l’intégration Datadog/Amazon API Gateway.

Chacune des métriques récupérées à partir d’AWS se voit assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s’y limiter, le hostname et les groupes de sécurité.

Remarque : si vous avez activé les métriques CloudWatch détaillées, vous devez les activer pour toutes les ressources ou toutes les routes d’une étape. Sinon, les valeurs agrégées dans Datadog seront incorrectes.

APM

Pour activer la journalisation API Gateway :

1. Accédez à API Gateway dans votre console AWS.

2. Sélectionnez l’API souhaitée et accédez à la section Stages.

3. Dans l’onglet Logs, activez Enable CloudWatch Logs et Enable Access Logging.

4. Sélectionnez le niveau INFO afin de récupérer l’ensemble des requêtes.

5. Assurez-vous que le nom de votre groupe CloudWatch commence par api-gateway.

6. Sélectionnez le format JSON (les formats CLF et CSV sont également pris en charge), et ajoutez ce qui suit dans le champ Log format :

   {
       "apiId": "$context.apiId",
       "stage": "$context.stage",
       "requestId":"$context.requestId",
       "ip":"$context.identity.sourceIp",
       "caller":"$context.identity.caller",
       "user":"$context.identity.user",
       "requestTime":$context.requestTimeEpoch,
       "httpMethod":"$context.httpMethod",
       "resourcePath":"$context.resourcePath",
       "status":$context.status,
       "protocol":"$context.protocol",
       "responseLength":$context.responseLength
   }
   

Envoi de logs à Datadog

1. Si vous ne l’avez pas déjà fait, configurez la fonction AWS Lambda de collecte de logs avec Datadog.
2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur sur le groupe de logs CloudWatch qui contient vos logs API Gateway depuis la console AWS. Sélectionnez le groupe de logs CloudWatch correspondant, ajoutez un nom de filtre (vous pouvez toutefois laisser le filtre vide) et ajoutez le déclencheur.

Accédez ensuite à la page Logs pour commencer à explorer vos logs.

Données collectées

Métriques

Événements

L’intégration Amazon APIP Gateway n’inclut aucun événement.

Checks de service

L’intégration Amazon API Gateway n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.