개요

Amazon API Gateway는 개발자가 어떠한 규모에서도 API를 쉽게 생성, 게시, 유지 관리, 모니터링 및 보호할 수 있도록 지원하는 완전관리형 서비스입니다.

이 통합을 활성화하여 Datadog에서 모든 API Gateway 메트릭을 확인할 수 있습니다.

설정

설치

이미 하지 않은 경우 Amazon Web Services 통합을 설정합니다.

메트릭 수집

1. AWS 통합 페이지에서 API Gateway가 Metric Collection 탭에서 활성화되어 있는지 확인하세요.

2. API Gateway 스테이지에 적용되는 커스텀 태그를 얻으려면 Datadog IAM 정책에 다음 권한을 추가하세요.

   • apigateway:GET
   • tag:GetResources

3. Datadog - Amazon API Gateway 통합을 설치합니다.

AWS에서 검색된 각 메트릭에는 호스트 이름, 보안 그룹 등을 포함하되 이에 국한되지 않고 AWS 콘솔에 표시되는 동일한 태그가 할당됩니다.

참고: 자세한 CloudWatch 메트릭을 활성화한 경우 단계 내의 모든 리소스 또는 경로에서 이를 활성화해야 합니다. 그렇지 않으면 Datadog의 집계 값이 올바르지 않게 됩니다.

로그 수집

API Gateway 로깅 활성화 방법:

1. AWS 콘솔에서 API Gateway로 이동합니다.

2. 원하는 API를 선택하고 Stages 섹션으로 이동합니다.

3. Logs 탭에서 Enable CloudWatch Logs 및 Enable Access Logging을 활성화합니다.

4. INFO 수준을 선택하여 모든 요청이 있는지 확인합니다.

5. CloudWatch Group 이름이 api-gateway로 시작하는지 확인합니다.

6. JSON 형식(CLF 및 CSV도 지원됨)을 선택하고 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
   }
   

Datadog로 로그 전송

1. 아직 설정하지 않았다면, Datadog 로그 수집 AWS Lambda 함수를 설정합니다.
2. 람다 함수가 설치되면 AWS 콘솔에서 API Gateway 로그를 포함하는 클라우드와치(CloudWatch) 로그 그룹에 대해 수동으로 트리거를 추가합니다. 해당 CloudWatch Log 그룹을 선택하고 필터 이름을 추가한 다음(필터는 비워 두어도 됨) 트리거를 추가합니다.

완료되면 로그 페이지]6로 이동하여 로그 탐색을 시작하세요.

수집한 데이터

메트릭

이벤트

Amazon API Gateway 통합에는 어떠한 이벤트도 포함되지 않습니다.

서비스 점검

Amazon API Gateway 통합에는 어떠한 서비스 점검도 포함되지 않습니다.

트러블슈팅

도움이 필요하신가요? Datadog 지원팀에 문의하세요.