Información general

Amazon API Gateway es un servicio totalmente gestionado que facilita a los desarrolladores la creación, la publicación, el mantenimiento, la monitorización y la protección de API a cualquier escala.

Habilita esta integración para ver todas tus métricas de API Gateway en Datadog.

Configuración

Instalación

Si aún no lo has hecho, configura la integración de Amazon Web Services.

Recopilación de métricas

1. En la página Integración de AWS, asegúrate de que API Gateway está activada en la pestaña Metric Collection.

2. Añade los siguientes permisos a tu política de IAM de Datadog para que se apliquen etiquetas personalizadas a las etapas de API Gateway:

   • apigateway:GET
   • tag:GetResources

3. Instala la integración Datadog - Amazon API Gateway.

A cada una de las métricas recuperadas de AWS se le asignan las mismas etiquetas (tags) que aparecen en la consola de AWS, donde se incluyen el nombre del host y los grupos de seguridad, entre otras cosas.

Nota: Si has activado las métricas CloudWatch detalladas, debes activarlas para todos los recursos y las rutas que componen una Stage. De lo contrario, los valores agregados en Datadog no serán correctos.

Recopilación de logs

Para activar el registro de API Gateway:

1. Abre API Gateway en tu consola AWS.

2. Selecciona la API que quieras y ve a la sección Stages (Etapas).

3. En la pestaña Logs (Registros), activa Enable CloudWatch Logs (Activar logs CloudWatch) y Enable Access Logging (Activar registro de acceso).

4. Selecciona el nivel INFO para garantizar que abarcas todas las solicitudes.

5. Asegúrate de que el nombre del grupo CloudWatch comienza con api-gateway.

6. Selecciona el formato JSON (CLF y CSV también son compatibles) y añade lo siguiente en la casilla Log format (Formato del log):

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

Enviar logs a Datadog

1. Si aún no lo ha hecho, configura la función AWS Lambda de recopilación de logs de Datadog.
2. Una vez instalada la función de Lambda, añade manualmente un activador en el grupo de log de CloudWatch que contiene tus logs de API Gateway en la consola de AWS. Selecciona el grupo de logs CloudWatch correspondiente, ponle un nombre al filtro (y deja el filtro vacío si quieres) y añade el desencadenador.

Una vez completado, navega hasta la página Logs para empezar a explorar tus logs.

Datos recopilados

Métricas

Eventos

La integración de Amazon API Gateway no incluye ningún evento.

Checks de servicios

La integración de Amazon API Gateway no incluye ningún check de servicio.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.