Bagian ini menjelaskan cara memecahkan dan menyelesaikan masalah saat menggunakan Anthos Service Mesh. Jika Anda memerlukan bantuan tambahan, lihat Mendapatkan dukungan.
Langkah pemecahan masalah
Ikuti langkah-langkah umum berikut untuk memecahkan masalah Anthos Service Mesh secara paling efisien:
- Menggunakan alat validasi konfigurasi otomatis.
- Periksa apakah Anda memiliki masalah umum dengan solusi yang diketahui.
- Mempersempit ruang lingkup masalah.
- Tinjau log dan informasi yang relevan.
- Kumpulkan log diagnostik dan cari bantuan.
kpt error selama penginstalan
Saat Anda menginstal Anthos Service Mesh menggunakan install_asm dengan versi kpt yang tidak didukung, install_asm akan menampilkan pesan error berikut:
2021-07-14T15:54:58.380312 install_asm_1_9_3: Downloading ASM..
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 41.7M 100 41.7M 0 0 31.1M 0 0:00:01 0:00:01 --:--:-- 31.1M
2021-07-14T15:54:59.777425 install_asm_1_9_3: Downloading ASM kpt package...
2021-07-14T15:54:59.805267 install_asm_1_9_3: Running: '/usr/bin/kpt pkg get --auto-set=false https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.9-asm asm'
2021-07-14T15:54:59.832100 install_asm_1_9_3: -------------
error: unknown flag: --auto-set
2021-07-14T15:54:59.907493 install_asm_1_9_3: [WARNING]: Failed, retrying...(1 of 3)
2021-07-14T15:55:01.936275 install_asm_1_9_3: Running: '/usr/bin/kpt pkg get --auto-set=false https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.9-asm asm'
2021-07-14T15:55:01.963543 install_asm_1_9_3: -------------
error: unknown flag: --auto-set
2021-07-14T15:55:02.043638 install_asm_1_9_3: [WARNING]: Failed, retrying...(2 of 3)
2021-07-14T15:55:04.074541 install_asm_1_9_3: Running: '/usr/bin/kpt pkg get --auto-set=false https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages.git/asm@release-1.9-asm asm'
2021-07-14T15:55:04.101990 install_asm_1_9_3: -------------
error: unknown flag: --auto-set
2021-07-14T15:55:04.176750 install_asm_1_9_3: [WARNING]: Failed, retrying...(3 of 3)
Jika Anda melihat error ini, download versi terbaru install_asm. Skrip
install_asm harus berupa salah satu versi berikut atau yang lebih baru:
- Untuk versi 1.8 - 1.8.6-asm.5+config1
- Untuk versi 1.9 - 1.9.6-asm.2+config1
- Untuk versi 1.10 - 1.10.2-asm.3+config1
Jika Anda mendownload anthos-service-mesh-package untuk menginstal Anthos Service Mesh menggunakan istioctl install, jika Anda memiliki versi kpt yang tidak didukung, Anda akan melihat pesan error berikut:
Package "asm":
Fetching https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages@release-1.10-asm
From https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages
* branch release-1.10-asm -> FETCH_HEAD
Error: Kptfile at "https:/github.com/GoogleCloudPlatform/anthos-service-mesh-packages/asm@release-1.10-asm" has an old version ("v1alpha1") of the Kptfile schema.
Please update the package to the latest format by following https://kpt.dev/installation/migration.
Penginstalan Anthos Service Mesh memerlukan kpt versi sebelum 1.x. Sesi
shell harus disetel agar menggunakan kpt versi 0.39.2. Anda dapat menjalankan perintah berikut untuk mendapatkan versi kpt:
kpt version
Outputnya mirip dengan hal berikut ini:
0.39.2Jika Anda melihat versi kpt yang lebih tinggi dari versi 1.0, lihat
Menyiapkan lingkungan untuk
mendownload versi yang diperlukan untuk sistem operasi Anda.
Menggunakan alat validasi otomatis
Anthos Service Mesh menyertakan alat diagnostik dan validasi konfigurasi otomatis yang dapat menyelesaikan masalah dan membantu Anda menghindarinya pada masa mendatang. Bagian berikut menjelaskan cara menggunakan alat ini.
istioctl analyze
Alat diagnostik istioctl analyze dapat mendeteksi masalah konfigurasi umum.
Instal istioctl menggunakan
instructions ini.
istioctl analyze membaca konfigurasi cluster dan jika menemukan masalah,
akan memberikan pesan informasi dan menyarankan solusi. Pengujian ini dapat dijalankan pada cluster aktif atau satu set file konfigurasi lokal. Pengujian ini juga dapat dijalankan terhadap
kombinasi keduanya, sehingga Anda dapat menemukan masalah sebelum menerapkan perubahan
pada cluster. Untuk informasi selengkapnya, lihat
Mendiagnosis Konfigurasi dengan istioctl analyze.
Untuk mengetahui informasi selengkapnya tentang error yang dideteksi istioctl analyze, lihat
Pesan Analisis Konfigurasi.
Menganalisis cluster live
Analisis cluster live menggunakan perintah berikut.
istioctl analyze -A
Jika istioctl analyze mendeteksi masalah pada konfigurasi Anda, pesan yang berisi informasi bermanfaat untuk menyelesaikannya akan ditampilkan, jika diketahui. Misalnya, jika Anda melakukan kesalahan umum dengan tidak melabeli namespace dengan benar
untuk mengaktifkan injeksi sidecar Istio, pesan berikut akan muncul:
Warn [IST0102] (Namespace default) The namespace is not enabled for Istio injection. Run 'kubectl label namespace default istio-injection=enabled' to enable it, or 'kubectl label namespace default istio-injection=disabled' to explicitly mark it as not needing injection
Jika masalah terus berlanjut, lihat bagian berikutnya untuk memeriksa apakah masalah Anda sudah diketahui.
Memeriksa masalah umum dan solusinya
Anda dapat menghemat waktu dengan memeriksa apakah gejala cocok dengan masalah di bagian masalah dan penyelesaian umum ini, yang dikelompokkan berdasarkan area fungsional Anthos Service Mesh:
- Masalah kemampuan observasi
- Masalah resource
- Masalah penskalaan
- Masalah keamanan
- Masalah pengelolaan lalu lintas
- Masalah webhook
Jika cara ini tidak menyelesaikan masalah, lihat bagian berikutnya.
Mempersempit ruang lingkup masalah
Anthos Service Mesh terdiri dari beberapa teknologi yang bekerja sama, yang berarti bahwa jenis masalah tertentu terkait dengan area atau komponen fungsional tertentu. Setiap komponen ini masing-masing menghasilkan log yang bermanfaat. Sebelum Anda mencoba menganalisis volume informasi yang diberikan secara manual, persempit cakupan pemecahan masalah dengan menjawab pertanyaan berikut:
- Apakah masalah terjadi dalam bidang kontrol atau bidang data, misalnya proxy Istiod atau Envoy?
- Di area fungsional mana Anda mengalami masalah, misalnya Jaringan, Telemetri, Keamanan, dll.?
- Apakah ada kehilangan traffic lebar mesh layanan atau dalam deployment tertentu?
- Apakah masalah muncul atau memburuk karena kurangnya kemampuan untuk menskalakan traffic di mesh layanan?
- Apakah masalah tersebut menyebabkan latensi atau masalah performa lainnya?
- Dapatkah Anda merekonstruksi masalah sesuai permintaan?
- Apakah masalahnya dimulai setelah perubahan konfigurasi baru-baru ini di Istio, GKE, dll.?
- Apakah ada peningkatan atau lonjakan traffic dalam mesh layanan?
- Apakah cluster ini memiliki deployment penting yang aktif atau tidak biasa?
- Apakah Anda mengamati pemakaian CPU atau memori yang tinggi? Jika demikian, berapa perkiraan penggunaan dalam skala besar?
- Apakah ada batasan kuota yang perlu dipertimbangkan?
Lihat status bidang kontrol
Perintah berikut dapat membantu Anda memahami status bidang kontrol Anthos Service Mesh:
kubectl get pods -n istio-systemkubectl describe -n istio-system- Untuk semua pod di sistem istio:
kubectl logs -n istio-system -l istio --all-containers istioctl versionistioctl proxy-statuskubectl get configmap istio -o yaml && kubectl get configmap istio-sidecar-injector -o yamlkubectl top pods -n istio-system
Gunakan perintah berikut untuk memahami skala deployment:
kubectl get nodeskubectl get services --all-namespaceskubectl get pods --all-namespaces
Meninjau log dan informasi yang relevan
Setelah mempersempit cakupan masalah, Anda dapat berfokus pada log dan informasi tertentu dengan lebih efektif. Untuk mempelajari log yang dihasilkan Anthos Service Mesh dan cara menafsirkan informasi yang ada di dalamnya, lihat Menafsirkan log Anthos Service Mesh.