Pemecahan masalah observabilitas App Mesh

penting

Pemberitahuan akhir dukungan: Pada 30 September 2026, AWS akan menghentikan dukungan untuk. AWS App Mesh Setelah 30 September 2026, Anda tidak akan lagi dapat mengakses AWS App Mesh konsol atau AWS App Mesh sumber daya. Untuk informasi lebih lanjut, kunjungi posting blog ini Migrasi dari AWS App Mesh ke Amazon ECS Service Connect.

Topik ini merinci masalah umum yang mungkin Anda alami dengan observabilitas App Mesh.

Tidak dapat melihat AWS X-Ray jejak untuk aplikasi saya

Gejala

Aplikasi Anda di App Mesh tidak menampilkan informasi penelusuran X-Ray di konsol X-Ray atau. APIs

Resolusi

Untuk menggunakan X-Ray di App Mesh, Anda harus mengonfigurasi komponen dengan benar untuk mengaktifkan komunikasi antara aplikasi, wadah sespan, dan layanan X-Ray. Ambil langkah-langkah berikut untuk mengonfirmasi bahwa X-Ray telah diatur dengan benar:

• Pastikan protokol pendengar Node Virtual App Mesh tidak disetel sebagaiTCP.

• Pastikan bahwa wadah X-Ray yang digunakan dengan aplikasi Anda mengekspos port UDP 2000 dan berjalan sebagai pengguna. 1337 Untuk informasi selengkapnya, lihat contoh X-Ray Amazon ECS di GitHub.

• Pastikan bahwa wadah Envoy telah mengaktifkan tracing. Jika Anda menggunakan image App Mesh Envoy, Anda dapat mengaktifkan X-Ray dengan menyetel variabel ENABLE_ENVOY_XRAY_TRACING lingkungan ke nilai 1 dan variabel XRAY_DAEMON_PORT lingkungan. 2000

• Jika Anda telah menginstrumentasi X-Ray dalam kode aplikasi Anda dengan salah satu bahasa tertentu SDKs , maka pastikan bahwa itu dikonfigurasi dengan benar dengan mengikuti panduan untuk bahasa Anda.

• Jika semua item sebelumnya dikonfigurasi dengan benar, tinjau log kontainer X-Ray untuk kesalahan dan ikuti panduan dalam Pemecahan Masalah AWS X-Ray. Penjelasan lebih rinci tentang integrasi X-Ray di App Mesh dapat ditemukan di Mengintegrasikan X-Ray dengan App Mesh.

Jika masalah Anda masih belum teratasi, pertimbangkan untuk membuka GitHub masalah atau hubungi AWS Support.

Tidak dapat melihat metrik Utusan untuk aplikasi saya di metrik Amazon CloudWatch

Gejala

Aplikasi Anda di App Mesh tidak memancarkan metrik yang dihasilkan oleh proxy Envoy ke metrik. CloudWatch

Resolusi

Saat Anda menggunakan CloudWatch metrik di App Mesh, Anda harus mengonfigurasi beberapa komponen dengan benar untuk mengaktifkan komunikasi antara proxy Envoy, sespan CloudWatch agen, dan layanan metrik. CloudWatch Ambil langkah-langkah berikut untuk mengonfirmasi bahwa CloudWatch metrik untuk proxy Envoy telah diatur dengan benar:

• Pastikan Anda menggunakan image CloudWatch agen untuk App Mesh. Untuk informasi selengkapnya, lihat CloudWatchagen App Mesh di GitHub.

• Pastikan Anda telah mengonfigurasi CloudWatch agen untuk App Mesh dengan tepat dengan mengikuti petunjuk penggunaan khusus platform. Untuk informasi selengkapnya, lihat CloudWatchagen App Mesh di GitHub.

• Jika semua item sebelumnya dikonfigurasi dengan benar, tinjau log kontainer CloudWatch agen untuk kesalahan dan ikuti panduan yang diberikan dalam Pemecahan Masalah agen. CloudWatch

Jika masalah Anda masih belum teratasi, pertimbangkan untuk membuka GitHub masalah atau hubungi AWS Support.

Tidak dapat mengonfigurasi aturan pengambilan sampel khusus untuk jejak AWS X-Ray

Gejala

Aplikasi Anda menggunakan penelusuran X-Ray, tetapi Anda tidak dapat mengonfigurasi aturan pengambilan sampel untuk jejak Anda.

Resolusi

Karena App Mesh Envoy saat ini tidak mendukung konfigurasi pengambilan sampel X-Ray Dinamis, solusi berikut tersedia.

Jika versi Utusan Anda 1.19.1 atau lebih baru, Anda memiliki opsi berikut.

• Untuk hanya mengatur laju pengambilan sampel, gunakan variabel XRAY_SAMPLING_RATE lingkungan pada wadah Envoy. Nilai harus ditentukan sebagai desimal antara 0 dan 1.00 (100%). Untuk informasi selengkapnya, lihat AWS X-Ray variabel.

• Untuk mengonfigurasi aturan pengambilan sampel kustom yang dilokalkan untuk pelacak X-Ray, gunakan variabel XRAY_SAMPLING_RULE_MANIFEST lingkungan untuk menentukan jalur file dalam sistem file kontainer Envoy. Untuk informasi selengkapnya, lihat Aturan pengambilan sampel di Panduan AWS X-Ray Pengembang.

Jika versi Utusan Anda sebelumnya1.19.1, lakukan hal berikut.

• Gunakan variabel ENVOY_TRACING_CFG_FILE lingkungan untuk mengubah laju pengambilan sampel Anda. Untuk informasi selengkapnya, lihat Variabel konfigurasi utusan. Tentukan konfigurasi penelusuran khusus dan tentukan aturan pengambilan sampel lokal. Untuk informasi selengkapnya, lihat konfigurasi X-Ray Utusan.

• Konfigurasi penelusuran khusus untuk contoh variabel ENVOY_TRACING_CFG_FILE lingkungan:

  tracing:
     http:
       name: envoy.tracers.xray
       typedConfig:
         "@type": type.googleapis.com/envoy.config.trace.v3.XRayConfig
         segmentName: foo/bar
         segmentFields:
           origin: AWS::AppMesh::Proxy
           aws:
             app_mesh:
               mesh_name: foo
               virtual_node_name: bar
         daemonEndpoint:
               protocol: UDP
               address: 127.0.0.1
               portValue: 2000
         samplingRuleManifest:
               filename: /tmp/sampling-rules.json

• Untuk detail tentang konfigurasi manifes aturan pengambilan sampel di samplingRuleManifest properti, lihat Mengonfigurasi X-Ray SDK for Go.

Jika masalah Anda masih belum teratasi, pertimbangkan untuk membuka GitHub masalah atau hubungi AWS Support.