Amazon API Gateway

Crawler

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.

Implémentation

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 la journalisation Cloudwatch ainsi que l’option Access logging.
4. Sélectionnez le niveau INFO afin de vérifier que vous disposez de l’ensemble des requêtes.
5. Assurez-vous d’inclure « apigateway » dans le nom de votre groupe de logs Cloudwatch.

6. Sélectionnez le format JSON (les formats CLF et CSV sont également pris en charge). Nous vous recommandons d’ajouter ce qui suit dans le champ 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 Lambda de collecte de logs AWS 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.