Amazon API Gateway

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 d’abord l’intégration Amazon Web Services.

Collecte de métriques

1. Dans le carré d’intégration AWS, assurez-vous que l’option API Gateway est cochée dans la section concernant la collecte des métriques.

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. Configurez l’intégration Datadog/AWS API Gateway.

Collecte de logs

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 d’inclure apigateway dans le nom de votre groupe Cloudwatch.

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 :

   {
       "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
   }
   

Envoyer des 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 dans la console AWS sur le groupe de logs Cloudwatch qui contient vos logs API Gateway :
   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 section Log de Datadog pour commencer à explorer vos logs !

Données collectées

Métriques

Chacune des métriques récupérées à partir d’AWS se verra 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é.

Événements

L’intégration AWS API Gateway n’inclut aucun événement.

Checks de service

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

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.