자동 문제 표시

개요

자동 문제 표시(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

구성을 적용합니다.

Helm

각 Apigee 환경의 apigee-env 차트를 업그레이드합니다.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

변경사항을 모든 환경에 적용합니다.

apigeectl apply -f OVERRIDES_FILE --org

자동 문제 표시 중지

재정의 파일에서 watcher.args.enableIssueScanning 속성을 false로 설정하여 자동 문제 표시를 중지할 수 있습니다. 예를 들면 다음과 같습니다.

watcher:
  args:
    enableIssueScanning: false

구성을 적용합니다.

Helm

각 Apigee 환경의 apigee-env 차트를 업그레이드합니다.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

변경사항을 모든 환경에 적용합니다.

apigeectl apply -f OVERRIDES_FILE --org
자동 문제 표시에서 다음을 포함한 문제 해결 가이드에 대한 링크를 직접 제공할 수 있습니다. Apigee 문제 해결 가이드 개요 및 목록은 Apigee X 및 Apigee Hybrid 플레이북 소개를 참조하세요.