Penyampaian masalah otomatis

Ringkasan

Automated Issue Surface (AIS) memberikan informasi cepat tentang masalah berkelanjutan yang terdeteksi dalam cluster Hybrid Anda. Informasi ini mencakup link ke dokumentasi untuk pemecahan masalah dan penyelesaian masalah. Tampilan masalah otomatis hanya mencari masalah yang diketahui, umum, dan dapat terdeteksi oleh sistem, serta tidak dapat mendeteksi semua masalah dalam cluster.

Dimulai dengan Apigee Hybrid v1.10, komponen watcher runtime Apigee secara otomatis memindai bidang kontrol dan status server Kubernetes API untuk menentukan apakah ada masalah konfigurasi atau tidak. Secara default, pemindaian terjadi setiap 60 detik. Anda dapat mengubah interval atau menonaktifkan pemindaian jika menginginkannya.

Saat mendeteksi masalah, AIS akan membuat instance ApigeeIssue baru dalam server Kubernetes API. Instance ini berisi informasi tentang masalah tersebut 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 sudah tidak terjadi lagi.

Menggunakan Penyampaian masalah otomatis.

Periksa masalah yang ada dengan perintah kubectl get apigeeissues:

kubectl -n apigee get apigeeissues

Contoh:

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

Untuk mendapatkan informasi 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 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 bidang kontrol untuk menemukan masalah sekali setiap 60 detik. Untuk mengubah interval pemindaian, tentukan interval baru dalam 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 ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml

Menonaktifkan kemunculan masalah otomatis

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

watcher:
  args:
    enableIssueScanning: false

Terapkan konfigurasi.

Upgrade diagram apigee-env untuk setiap lingkungan Apigee.

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml
Penelusuran masalah otomatis dapat memberikan link langsung ke panduan pemecahan masalah, termasuk: Lihat Pengantar playbook hybrid Apigee X dan Apigee untuk mengetahui ringkasan dan daftar panduan pemecahan masalah Apigee.