Penayangan masalah otomatis

Ringkasan

Penayangan masalah otomatis (AIS) memberikan informasi cepat tentang masalah yang sedang berlangsung yang terdeteksi dalam cluster Hybrid Anda. Informasi ini mencakup link ke dokumentasi untuk pemecahan masalah dan penyelesaian. Penayangan masalah otomatis hanya mencari masalah umum yang diketahui dan dapat dideteksi sistem, serta tidak dapat mendeteksi semua masalah dalam cluster.

Mulai Apigee hybrid v1.10, komponen pengamat runtime Apigee akan otomatis memindai bidang kontrol dan status server API Kubernetes untuk menentukan apakah ada masalah konfigurasi. Secara default, pemindaian terjadi setiap 60 detik. Anda dapat mengubah interval atau menonaktifkan pemindaian jika mau.

Saat mendeteksi masalah, AIS akan membuat instance ApigeeIssue baru dalam server Kubernetes API. Instance ini berisi informasi tentang masalah dan link ke dokumentasi tentang masalah tertentu.

Saat Anda menyelesaikan masalah, masalah tersebut akan otomatis dihapus dari server Kubernetes API saat pemindaian menentukan bahwa masalah tersebut tidak lagi terjadi.

Menggunakan Penayangan masalah otomatis.

Periksa apakah ada masalah yang ada dengan perintah kubectl get apigeeissues: 

kubectl -n APIGEE_NAMESPACE get apigeeissues

Contoh:

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

Untuk informasi yang lebih mendetail tentang masalah tertentu, gunakan perintah kubectl describe dengan nama masalah. Nama harus diawali dengan apigeeissues, misalnya: 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:

Mengubah interval pemindaian

Secara default, Watcher memindai control plane untuk menemukan masalah setiap 60 detik. Untuk mengubah interval pemindaian, tentukan interval baru dalam hitungan detik dengan properti watcher.args.issueScanInterval dalam file penggantian Anda. Contoh:

watcher:
  args:
    issueScanInterval: 120

Terapkan konfigurasi.

Helm

Upgrade diagram apigee-env untuk setiap lingkungan Apigee.

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

apigeectl

Terapkan perubahan ke semua lingkungan.

apigeectl apply -f OVERRIDES_FILE --org

Menonaktifkan kemunculan masalah otomatis

Anda dapat menonaktifkan Peningkatan masalah otomatis dengan menetapkan properti watcher.args.enableIssueScanning ke false dalam file penggantian. Contoh:

watcher:
  args:
    enableIssueScanning: false

Terapkan konfigurasi.

Helm

Upgrade diagram apigee-env untuk setiap lingkungan Apigee.

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

apigeectl

Terapkan perubahan ke semua lingkungan.

apigeectl apply -f OVERRIDES_FILE --org
Penayangan masalah otomatis dapat memberikan link langsung ke panduan pemecahan masalah, termasuk: Lihat Pengantar playbook Apigee X dan Apigee Hybrid untuk mengetahui ringkasan dan daftar panduan pemecahan masalah Apigee.