EKM 상태 모니터링

이 페이지는 Apigee에 적용되지만 Apigee Hybrid에는 적용되지 않습니다.

Apigee Edge 문서 보기

이 문서에서는 Apigee와 함께 사용되는 Cloud External Key Manager(Cloud EKM)의 상태를 모니터링하는 방법과 Cloud Logging을 사용하여 Cloud EKM 관련 문제에 대한 알림을 구성하는 방법을 설명합니다.

Apigee는 CMEK에 Cloud EKM을 사용할 수 있습니다. 네트워크 문제로 인해 Cloud EKM을 사용할 수 없게 되거나 키가 사용 중지되거나 연결할 수 없는 경우 암호화에 의존하는 Apigee 서비스가 영향을 받을 수 있습니다.

Cloud Logging에서 Cloud EKM 문제 모니터링

Apigee에서 거부됨, 키 사용 중지됨, 결제 사용 중지됨, 키에 연결할 수 없음과 같은 상태 변경과 같은 Cloud EKM 문제가 발생하면 Cloud Logging에 로그 항목이 생성됩니다. 로그 탐색기에서 이러한 로그를 보고 로그 기반 알림을 구성하여 이러한 이벤트에 대한 알림을 받을 수 있습니다.

로그 항목에는 문제가 발생한 조직 및 인스턴스에 대한 세부정보가 포함되지만 보안상의 이유로 키 이름은 생략됩니다.

로그 탐색기에서 Cloud EKM 관련 로그 항목을 찾으려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔의 로그 탐색기로 이동합니다.

    로그 탐색기로 이동

  2. 쿼리 편집기 입력란에 다음 쿼리를 입력하고 쿼리 실행을 클릭합니다.
    Apigee EKM key health issue detected
  3. Cloud EKM 문제가 발생한 경우 쿼리 결과에 이벤트를 자세히 설명하는 로그 항목이 표시됩니다.
확대하려면 클릭 EKM 오류 로그 항목

Cloud EKM 문제에 대한 로그 기반 알림 구성

Apigee에서 Cloud EKM 관련 오류를 로깅할 때 알림을 받을 수 있도록 로그 기반 알림 정책을 만들 수 있습니다. 이러한 알림은 Cloud EKM의 문제를 사전에 식별하고 해결하는 데 도움이 될 수 있습니다.

Cloud EKM 오류 메시지 문자열을 기반으로 로그 기반 알림을 구성하려면 Cloud Logging 문서의 로그 기반 알림 정책 구성을 참조하세요.

알림을 만들 때 Cloud Logging에서 Cloud EKM 문제 모니터링에 설명된 것과 동일한 쿼리 필터를 사용하여 특정 Cloud EKM 로그 항목을 일치시킵니다.

알림 제한사항 및 복구

Cloud EKM 상태 알림을 구성하고 대응할 때는 다음 제한사항에 유의하세요.

  • 반복 알림: 키에 연결할 수 없는 동안 Apigee는 약 1시간마다 로그 항목을 생성합니다. 로그 기반 알림을 구성하면 기본 문제가 해결될 때까지 이 주기로 알림을 받습니다.
  • 복구 알림 없음: Cloud EKM에 다시 연결할 수 있게 되면 Apigee는 로그 항목을 생성하거나 알림을 전송하지 않습니다. 로그 기반 알림은 Apigee가 오류 로그 항목 생성을 중지한 후 알림 정책의 자동 종료 구성에 따라 자체적으로 해결됩니다.
  • 복구 확인: 복구 로그 항목이 생성되지 않으므로 API 프록시 배포와 같이 키가 필요한 작업을 수행하고 성공했는지 확인하여 Cloud EKM에 다시 연결할 수 있는지 확인합니다.

문제 해결 제한사항

Apigee 로깅은 Cloud EKM 연결 또는 키 상태에 문제가 있는 경우를 나타냅니다. 하지만 Cloud EKM 자체의 세부적인 문제 해결 (예: 네트워크 연결 문제 또는 외부 키 관리자 측의 문제 진단)은 Apigee 모니터링의 범위를 벗어납니다. Cloud EKM 문제에 대한 알림을 받으면 Cloud EKM 서비스의 상태와 구성을 조사해야 합니다.