Penayangan masalah otomatis

Ringkasan

Penemuan 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. Penemuan masalah otomatis hanya mencari masalah umum yang diketahui dan dapat dideteksi sistem, serta tidak dapat mendeteksi semua masalah dalam cluster.

Mulai dari Apigee hybrid v1.10, komponen watcher runtime Apigee secara otomatis memindai status bidang kontrol dan 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 Penemuan masalah otomatis.

Periksa apakah ada masalah yang sudah 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 mengetahui 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 masalah di bidang kontrol setiap 60 detik. Untuk mengubah interval pemindaian, tentukan interval baru dalam hitungan detik dengan properti watcher.args.issueScanInterval di file penggantian Anda. Contoh:

watcher:
  args:
    issueScanInterval: 120

Terapkan konfigurasi.

Upgrade diagram apigee-env untuk setiap lingkungan Apigee.

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

Menonaktifkan penayangan masalah otomatis

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

watcher:
  args:
    enableIssueScanning: false

Terapkan konfigurasi.

Upgrade diagram apigee-env untuk setiap lingkungan Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE
Penemuan masalah otomatis dapat memberikan link langsung ke panduan pemecahan masalah, termasuk: Lihat Pengantar Apigee X dan playbook Apigee Hybrid untuk mengetahui ringkasan dan daftar panduan pemecahan masalah Apigee.