개요
자동 문제 표시(AIS)는 Hybrid 클러스터 내에서 감지된 진행 중인 문제에 대한 빠른 정보를 제공합니다. 이 정보에는 문제 해결 및 해결 방법 문서 링크가 포함됩니다. 자동 문제 표시는 시스템에서 감지 가능한 알려진 일반적인 문제만 찾으며 클러스터 내의 모든 문제를 감지할 수는 없습니다.
Apigee Hybrid v1.10부터 Apigee 런타임 감시자 구성요소가 제어 영역 및 Kubernetes API 서버 상태를 자동으로 스캔하여 구성 문제가 있는지 확인합니다. 기본적으로 스캔은 60초마다 실행됩니다. 원하는 경우 간격을 변경하거나 스캔을 중지할 수 있습니다.
AIS는 문제를 감지하면 Kubernetes API 서버 내에 ApigeeIssue
의 새 인스턴스를 만듭니다. 이러한 인스턴스에는 문제에 대한 정보와 특정 문제에 대한 문서 링크가 포함됩니다.
문제가 해결되어 스캔에서 이 문제가 더 이상 발생하지 않는 것으로 확인되면 Kubernetes API 서버에서 자동으로 삭제됩니다.
자동 문제 표시 사용
kubectl get apigeeissues
명령어로 기존 문제가 있는지 확인합니다.
kubectl -n apigee get apigeeissues
예를 들면 다음과 같습니다.
kubectl -n apigee 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 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
구성을 적용합니다.
Helm
각 Apigee 환경의 apigee-env
차트를 업그레이드합니다.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace NAMESPACE \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml
apigeectl
변경사항을 모든 환경에 적용합니다.
apigeectl apply -f overrides --all-envs
자동 문제 표시 중지
재정의 파일에서 watcher.args.enableIssueScanning
속성을 false
로 설정하여 자동 문제 표시를 중지할 수 있습니다. 예를 들면 다음과 같습니다.
watcher: args: enableIssueScanning: false
구성을 적용합니다.
Helm
각 Apigee 환경의 apigee-env
차트를 업그레이드합니다.
helm upgrade ENV_NAME apigee-env/ \ --install \ --namespace NAMESPACE \ --set env=ENV_NAME \ --atomic \ -f overrides.yaml
apigeectl
변경사항을 모든 환경에 적용합니다.
apigeectl apply -f overrides --all-envs
관련 문제 해결 가이드
자동 문제 표시에서 다음을 포함한 문제 해결 가이드에 대한 링크를 직접 제공할 수 있습니다.- 런타임 영역과 제어 영역 사이에 네트워크 연결 없음
- 환경 그룹이 누락된 가상 호스트
- 선택기가 누락된 가상 호스트
- 인그레스 인증서 불일치
- 인그레스 인증서 만료
- 인그레스 mTLS CA 인증서 만료
- 인그레스 mTLS CA 인증서가 잘못됨