Cloud Service Mesh dan Traffic Director kini bergabung menjadi Cloud Service Mesh. Untuk mengetahui informasi selengkapnya, lihat ringkasan Cloud Service Mesh.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memecahkan masalah Cloud Service Mesh langkah demi langkah
Bagian ini menjelaskan cara memecahkan masalah dan menyelesaikan masalah saat menggunakan Cloud Service Mesh. Jika Anda memerlukan bantuan tambahan, lihat
Mendapatkan dukungan.
Langkah pemecahan masalah
Ikuti langkah-langkah umum berikut untuk memecahkan masalah Cloud Service Mesh:
Gunakan alat validasi konfigurasi otomatis.
Periksa apakah Anda mengalami masalah umum dengan solusi yang diketahui.
Persempit cakupan masalah.
Tinjau log dan informasi yang relevan.
Kumpulkan log diagnostik dan cari bantuan.
Alat diagnostik Cloud Service Mesh dapat mendeteksi masalah konfigurasi
umum. Instal alat pemecahan masalah menggunakan
petunjuk ini.
Sebelum memulai
Pastikan konteks kubeconfig untuk cluster Anda tersedia di
file kubeconfig. Jika tidak, jalankan perintah berikut:
MEMBERSHIP_LOCATION: region untuk
langganan Anda. Anda dapat memeriksa lokasi langganan dengan
gcloud container fleet memberships list --project FLEET_PROJECT_ID
yang mengganti FLEET_PROJECT_ID dengan project ID
fleet.
PROJECT_NAME: nama project.
Tabel berikut menjelaskan kemungkinan respons.
TIDAK DIKETAHUI
(Default) Informasi status tidak tersedia atau tidak diketahui.
DISINKRONKAN
Bidang kontrol mengirim konfigurasi ke klien dan menerima ACK dari klien.
ERROR
Plane kontrol mengirim konfigurasi ke klien dan menerima NACK dari klien.
STALE
Bidang kontrol mengirim konfigurasi ke klien, tetapi tidak menerima ACK atau NACK dari klien.
TIDAK DIKIRIM
Konfigurasi tidak dikirim.
T/A
Tidak berlaku.
Tidak didukung
Status sinkronisasi tidak didukung oleh API pemecahan masalah kami.
Dalam cluster
kubectl get pods -n istio-system
kubectl describe -n istio-system
Untuk semua pod di istio-system: kubectl logs -n istio-system -l istio --all-containers
istioctl version
istioctl proxy-status
kubectl get configmap istio -o yaml && kubectl get configmap istio-sidecar-injector -o yaml
kubectl top pods -n istio-system
Gunakan perintah berikut untuk memahami skala deployment:
kubectl get nodes
kubectl get services --all-namespaces
kubectl get pods --all-namespaces
Melihat konfigurasi proxy
Perintah berikut dapat membantu Anda memahami konfigurasi proxy Cloud Service Mesh:
TYPE: Salah satu dari hal berikut: cluster, pemroses,
rute, endpoint, bootstrap, log, secret, semua.
MEMBERSHIP_NAME: nama keanggotaan Anda.
MEMBERSHIP_LOCATION: region untuk
langganan Anda. Anda dapat memeriksa lokasi langganan dengan
gcloud container fleet memberships list --project FLEET_PROJECT_ID
yang mengganti FLEET_PROJECT_ID dengan project ID
fleet.
PROJECT_NAME: nama project.
Dalam cluster
Gunakan istioctl proxy-config untuk melihat konfigurasi proxy untuk bidang kontrol dalam cluster. Untuk mengetahui informasi selengkapnya, lihat
Men-debug Envoy dan istiod.
Jika masalah berlanjut, lihat bagian berikutnya untuk memeriksa apakah masalah Anda
sudah diketahui.
Memeriksa masalah dan solusi umum
Anda dapat menghemat waktu dengan memeriksa apakah gejala Anda cocok dengan masalah di bagian masalah dan solusi umum ini, yang dikelompokkan menurut area fungsi Cloud Service Mesh:
Jika langkah ini tidak menyelesaikan masalah Anda, lihat bagian berikutnya.
Mempersempit cakupan masalah
Cloud Service Mesh terdiri dari beberapa teknologi yang bekerja sama, yang berarti
bahwa jenis masalah tertentu dikaitkan dengan area fungsional atau
komponen tertentu. Setiap komponen ini menghasilkan lognya sendiri yang berguna. Sebelum
mencoba menganalisis volume informasi yang diberikan secara manual, persempit
cakupan pemecahan masalah Anda 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 di seluruh mesh layanan atau di 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 masalah dimulai setelah perubahan konfigurasi terbaru di Istio, GKE, dll.?
Apakah ada peningkatan atau lonjakan traffic dalam mesh layanan?
Apakah cluster ini memiliki fitur yang terlihat jelas yang diaktifkan atau deployment yang tidak biasa?
Apakah Anda mengamati pemakaian CPU atau memori yang tinggi? Jika ya, berapa perkiraan penggunaannya dalam skala besar?
Apakah ada batasan kuota yang perlu dipertimbangkan?
Meninjau log dan informasi yang relevan
Setelah mempersempit cakupan masalah, Anda dapat berfokus pada log dan
informasi tertentu secara lebih efektif. Untuk mempelajari log yang dihasilkan Cloud Service Mesh dan cara menafsirkan informasi yang dikandungnya, lihat Menafsirkan log Cloud Service Mesh.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[],[],null,["# Troubleshoot Cloud Service Mesh step-by-step\n============================================\n\nThis section explains how to troubleshoot and resolve problems when using\nCloud Service Mesh. If you need additional assistance, see\n[Getting support](/service-mesh/docs/getting-support).\n\nTroubleshooting steps\n---------------------\n\nFollow these general steps to troubleshoot Cloud Service Mesh:\n\n1. Use the automated configuration validation tools.\n2. Check if you have a common problem with a known solution.\n3. Narrow the scope of the problem.\n4. Review relevant logs and information.\n5. Gather diagnostic logs and seek help.\n\n| **Note:** If you are unable to troubleshoot manually, see [Gather diagnostic logs and seek help](/service-mesh/docs/troubleshooting/troubleshoot-collect-logs) for next steps.\n\nThe Cloud Service Mesh diagnostic tool can detect common configuration\nproblems. Install the troubleshooting tool using these\n[instructions](/service-mesh/docs/downloading-istioctl).\n\nBefore you begin\n----------------\n\n1. Make sure the kubeconfig context for your cluster is available in your\n kubeconfig file. If not, then run the following command:\n\n gcloud container clusters get-credentials \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eCLUSTER_LOCATION\u003c/var\u003e --project=\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of your cluster.\n - \u003cvar translate=\"no\"\u003eCLUSTER_LOCATION\u003c/var\u003e: the zone or region for your cluster.\n - \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the project name.\n2. Verify that the [Application Default Credentials](/authentication/provide-credentials-adc)\n are created. If they are not, run one of the following commands:\n\n gcloud auth application-default login --billing-project=\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n gcloud auth application-default set-quota-project \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replacing \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e with the your project name.\n\nView control plane status\n-------------------------\n\nThe following commands can help you understand the status of the\nCloud Service Mesh control plane: \n\n### Managed\n\n- Get the list of clients connection status to the Cloud Service Mesh control plane:\n\n gcloud beta container fleet mesh debug proxy-status \\\n --membership=\u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eMEMBERSHIP_LOCATION\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e: the name of your membership.\n - \u003cvar translate=\"no\"\u003eMEMBERSHIP_LOCATION\u003c/var\u003e: the region for your membership. You can check your membership's location with `gcloud container fleet memberships list --project `\u003cvar translate=\"no\"\u003eFLEET_PROJECT_ID\u003c/var\u003e replacing \u003cvar translate=\"no\"\u003eFLEET_PROJECT_ID\u003c/var\u003e with the fleet project ID.\n - \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the project name.\n\n The following table describes the possible responses.\n\n### In-cluster\n\n- `kubectl get pods -n istio-system`\n- `kubectl describe -n istio-system`\n- For all pods in istio-system: `kubectl logs -n istio-system -l istio --all-containers`\n- `istioctl version`\n- `istioctl proxy-status`\n- `kubectl get configmap istio -o yaml && kubectl get configmap istio-sidecar-injector -o yaml`\n- `kubectl top pods -n istio-system`\n\nUse the following commands to understand the scale of the deployment:\n\n- `kubectl get nodes`\n- `kubectl get services --all-namespaces`\n- `kubectl get pods --all-namespaces`\n\nView proxy configurations\n-------------------------\n\nThe following command can help you understand the Cloud Service Mesh proxy\nconfigurations: \n\n### Managed\n\n gcloud beta container fleet mesh debug proxy-config \u003cvar translate=\"no\"\u003ePOD_NAME\u003c/var\u003e.\u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e \\ \n --type=\u003cvar translate=\"no\"\u003eTYPE\u003c/var\u003e \\\n --membership=\u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eMEMBERSHIP_LOCATION\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e\n\n- \u003cvar translate=\"no\"\u003ePOD_NAME\u003c/var\u003e: the name of your Pod.\n- \u003cvar translate=\"no\"\u003eNAMESPACE\u003c/var\u003e: the namespace of your Pod.\n- \u003cvar translate=\"no\"\u003eTYPE\u003c/var\u003e: One of for following: cluster, listeners, routes, endpoints, bootstrap, log, secret, all.\n- \u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e: the name of your membership.\n- \u003cvar translate=\"no\"\u003eMEMBERSHIP_LOCATION\u003c/var\u003e: the region for your membership. You can check your membership's location with `gcloud container fleet memberships list --project `\u003cvar translate=\"no\"\u003eFLEET_PROJECT_ID\u003c/var\u003e replacing \u003cvar translate=\"no\"\u003eFLEET_PROJECT_ID\u003c/var\u003e with the fleet project ID.\n- \u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e: the project name.\n\n### In-cluster\n\nUse the `istioctl proxy-config` to see proxy configurations for in-cluster\ncontrol planes. For more information, see\n[Debugging Envoy and istiod](https://istio.io/latest/docs/ops/diagnostic-tools/proxy-cmd/).\n\nIf the problem persists, see the next section to check if your problem is\nalready known.\n\nCheck for common problems and solutions\n---------------------------------------\n\nYou can save time by checking if your symptoms match an issue in these common\nproblems and resolutions sections, grouped by Cloud Service Mesh functional\narea:\n\n- [Installation issues](/service-mesh/docs/troubleshooting/troubleshoot-installation)\n- [Managed control plane issues](/service-mesh/docs/managed/troubleshoot-managed-anthos-service-mesh)\n- [Observability issues](/service-mesh/docs/troubleshooting/troubleshoot-observability)\n- [Off-Google Cloud deployment issues](/service-mesh/docs/troubleshooting/troubleshoot-off-gcp)\n- [Proxy issues](/service-mesh/docs/troubleshooting/troubleshoot-proxy)\n- [Resource issues](/service-mesh/docs/troubleshooting/troubleshoot-resources)\n- [Scaling issues](/service-mesh/docs/troubleshooting/troubleshoot-scaling)\n- [Security issues](/service-mesh/docs/troubleshooting/troubleshoot-security)\n- [Traffic management issues](/service-mesh/docs/troubleshooting/troubleshoot-traffic)\n- [Webhook issues](/service-mesh/docs/troubleshooting/troubleshoot-webhook)\n- [Sidecar proxies issues](/service-mesh/docs/troubleshooting/troubleshoot-sidecar-proxies)\n\nIf this does not resolve your issue, see the next section.\n\nNarrow the scope of the problem\n-------------------------------\n\nCloud Service Mesh consists of several technologies working together, which means\nthat certain types of problems are associated with particular functional areas\nor components. Each of these components generate helpful logs of their own. Before\nyou attempt to manually analyze the volume of information they provide, narrow\nthe scope of your troubleshooting by answering the following questions:\n\n- Does the issue occur within the control plane or the data plane, for example `istiod` or Envoy proxies?\n- In which functional area are you experiencing the issue, for example Networking, Telemetry, Security, etc.?\n- Is there service-mesh wide traffic loss or in a specific deployment?\n- Does the problem appear or worsen due to lack of ability to scale traffic in service mesh?\n- Does the issue cause latency or other performance issues?\n- Can you reproduce the issue on demand?\n- Did the problem begin after a recent configuration change in Istio, GKE, etc.?\n- Is there an increase or spike in traffic within the service mesh?\n- Does this cluster have any noticeable features enabled or non-typical deployments?\n- Do you observe high CPU or memory utilization? If so, what is the expected usaged at scale?\n- Are there quota restrictions to consider?\n\nReview relevant logs and information\n------------------------------------\n\nAfter you narrow the scope of the problem, you can focus on certain logs and\ninformation more effectively. To learn about the logs that Cloud Service Mesh\ngenerates and how to interpret the information they contain, see\n[Interpreting Cloud Service Mesh logs](/service-mesh/docs/observability/accessing-logs#interpret_anthos_service_mesh_logs)."]]