개요
자동 문제 표시(AIS)는 Hybrid 클러스터 내에서 감지된 진행 중인 문제에 대한 빠른 정보를 제공합니다. 이 정보에는 문제 해결 및 해결 방법 문서에 대한 링크가 포함되어 있습니다. 자동 문제 표시는 시스템에서 감지 가능한 일반적인 알려진 문제만 찾으며 클러스터 내의 모든 문제를 감지할 수 없습니다.
Apigee Hybrid v1.10부터 Apigee 런타임 감시자 구성요소에서 컨트롤 플레인과 Kubernetes API 서버 상태를 자동으로 스캔하여 구성 문제가 있는지 확인합니다. 기본적으로 스캔은 60초마다 수행됩니다. 원하는 경우 간격을 변경하거나 스캔을 중지할 수 있습니다.
AIS에서 문제를 감지하면 Kubernetes API 서버 내에 새 ApigeeIssue
인스턴스를 만듭니다. 이러한 인스턴스에는 문제에 대한 정보와 특정 문제에 대한 문서 링크가 포함되어 있습니다.
문제가 해결되어 스캔에서 이 문제가 더 이상 발생하지 않는 것을 확인하면 인스턴스는 Kubernetes API 서버에서 자동으로 삭제됩니다.
자동 문제 표시 사용
kubectl get apigeeissues
명령어로 기존 문제가 있는지 확인합니다.
kubectl -n APIGEE_NAMESPACE get apigeeissues
예를 들면 다음과 같습니다.
kubectl -n APIGEE_NAMESPACE get apigeeissues NAME SEVERITY AGE URL vhost-missing-eg-nonprod Error 1hr https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP control-plane-connectivity-failure Error 1d https://cloud.google.com/apigee/docs/hybrid/OLD_TLS_VERSION
특정 문제에 대한 자세한 내용을 보려면 문제 이름과 함께 kubectl describe
명령어를 사용하세요. 이름 앞에 apigeeissues
를 붙여야 합니다(예: apigeeissues vhost-missing-eg-nonprod
).
kubectl -n APIGEE_NAMESPACE describe apigeeissues vhost-missing-eg-nonprod Name: vhost-missing-eg-nonprod Namespace: apigee Labels:Annotations: API Version: apigee.cloud.google.com/v1alpha1 Kind: ApigeeIssue Metadata: Creation Timestamp: 2022-08-25T20:41:56Z Managed Fields: API Version: apigee.cloud.google.com/v3 Resource Version: 12345678 UID: aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg Spec: Severity: Error Reason: MISSING_ENV_GROUP Details: Expected envgroup "nonprod" for ApigeeRouteConfig "my-org-nonprod" Documentation: https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP Ignore: false IgnoreReason: Events:
스캔 간격 변경
기본적으로 감시자는 60초마다 한 번씩 컨트롤 플레인에 문제가 있는지 스캔합니다. 스캔 간격을 변경하려면 재정의 파일에서 watcher.args.issueScanInterval
속성을 사용하여 새 간격을 초 단위로 지정합니다. 예를 들면 다음과 같습니다.
watcher: args: issueScanInterval: 120
apigeectl apply -f OVERRIDES_FILE --org
를 사용하여 구성을 적용합니다.
자동 문제 표시 중지
재정의 파일에서 watcher.args.enableIssueScanning
속성을 false
로 설정하여 자동 문제 표시를 중지할 수 있습니다. 예를 들면 다음과 같습니다.
watcher: args: enableIssueScanning: false
apigeectl apply -f OVERRIDES_FILE --org
를 사용하여 구성을 적용합니다.