이 페이지는 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 관련 로그 항목을 찾으려면 다음 단계를 따르세요.
- Google Cloud 콘솔의 로그 탐색기로 이동합니다.
- 쿼리 편집기 입력란에 다음 쿼리를 입력하고 쿼리 실행을 클릭합니다.
Apigee EKM key health issue detected
- Cloud 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 서비스의 상태와 구성을 조사해야 합니다.