Azure API Management 자체 호스팅 게이트웨이에 대한 클라우드 메트릭 및 로그 구성

  • 아티클

적용 대상: 개발자 | 프리미엄

이 문서에서는 자체 호스팅 게이트웨이의 클라우드 메트릭과 로그를 구성하는 방법에 대한 세부 정보를 제공합니다.

자체 호스팅 게이트웨이는 API 관리 서비스와 연결되어야 하며 포트 443의 Azure에 대한 아웃바운드 TCP/IP 연결이 필요합니다. 게이트웨이는 아웃바운드 연결을 활용하여 원격 분석을 Azure로 보냅니다(구성된 경우).

메트릭

기본적으로 자체 호스팅 게이트웨이는 클라우드에서 관리되는 게이트웨이와 동일한 Azure Monitor를 통해 여러 메트릭을 내보냅니다.

게이트웨이 배포의 ConfigMap에서 telemetry.metrics.cloud 키를 사용하여 이 기능을 사용하거나 사용하지 않도록 설정할 수 있습니다. 다음은 사용 가능한 구성 내역입니다.

필드 기본값 설명
telemetry.metrics.cloud true Azure Monitor를 통해 로깅을 사용합니다. 값은 true, false가 될 수 있습니다.

다음은 샘플 구성입니다.

    apiVersion: v1
    kind: ConfigMap
    metadata:
        name: contoso-gateway-environment
    data:
        config.service.endpoint: "<contoso-gateway-management-endpoint>"
        telemetry.metrics.cloud: "true"

자체 호스팅 게이트웨이는 현재 Azure Monitor를 통해 다음 메트릭을 내보냅니다.

메트릭 설명
요청 해당 기간의 API 요청 수
게이트웨이 요청의 기간 게이트웨이에서 요청을 수신한 순간부터 응답이 완전히 전송될 때까지 걸린 시간(밀리초)
백엔드 요청의 기간 전체 백 엔드 IO(연결, 바이트 송신 및 수신)에 소요된 시간(밀리초)

로그

자체 호스팅 게이트웨이에서는 현재 클라우드로 진단 로그를 보내지 않습니다. 하지만 자체 호스팅 게이트웨이가 배포되는 위치에서 로컬로 로그를 구성하고 보존할 수 있습니다.

게이트웨이가 Azure Kubernetes Service에 배포되는 경우 컨테이너용 Azure Monitor를 사용하도록 설정하여 컨테이너에서 로그를 수집하고 Log Analytics에서 로그를 볼 수 있습니다.

다음 단계