Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Melakukan pemecahan masalah instalasi yang terjadi pada Sinyal Aplikasi Anda Bagian ini berisi tips pemecahan masalah untuk Sinyal CloudWatch Aplikasi. **Topics** + [ ## OpenTelemetry Konflik konfigurasi alamat di Amazon EKS dengan Sinyal Aplikasi ](#Application-Signals-troubleshoot-eks-applications) + [ ## Sinyal Aplikasi Kinerja awal dingin lapisan Java ](#Application-Signals-troubleshoot-cold-start-performance) + [ ## Aplikasi tidak memulai setelah Sinyal Aplikasi diaktifkan ](#Application-Signals-troubleshoot-starting) + [ ## Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan ](#Application-Signals-troubleshoot-starting-Python) + [ ## Tidak ada data Sinyal Aplikasi untuk aplikasi Python yang menggunakan server WSGI ](#Application-Signals-troubleshoot-Python-WSGI) + [ ## Aplikasi Node.js saya tidak diinstrumentasi atau tidak menghasilkan telemetri Sinyal Aplikasi ](#Application-Signals-troubleshoot-telemetry-nodejs) + [ ## Aplikasi .NET saya tidak diinstrumentasi atau rusak untuk panggilan AWS SDK ](#Application-Signals-troubleshoot-sdk-calls) + [ ## Tidak ada data aplikasi di dasbor Sinyal Aplikasi ](#Application-Signals-troubleshoot-missingdata) + [ ## Metrik layanan atau metrik ketergantungan memiliki nilai Tidak Dikenal ](#Application-Signals-troubleshoot-unknown-values) + [ ## Menangani ConfigurationConflict saat mengelola add-on Amazon CloudWatch Observability EKS ](#Application-Signals-troubleshoot-conflict) + [ ## Saya ingin memfilter metrik dan jejak yang tidak perlu ](#Application-Signals-troubleshoot-cardinality) + [ ## Apa `InternalOperation` artinya? ](#Application-Signals-troubleshoot-InternalOperation) + [ ## Bagaimana cara mengaktifkan logging untuk aplikasi.NET? ](#Application-Signals-troubleshoot-dotnet-logging) + [ ## Bagaimana saya bisa menyelesaikan konflik versi perakitan di aplikasi.NET? ](#Application-Signals-troubleshoot-dotnet-conflicts) + [ ## Bisakah saya menonaktifkan FluentBit? ](#Application-Signals-troubleshoot-FluentBit) + [ ## Bisakah saya memfilter log kontainer sebelum mengekspor ke CloudWatch Log? ](#Application-Signals-troubleshoot-filter-logs) + [ ## Menyelesaikan TypeError saat Menggunakan AWS Distro for OpenTelemetry (ADOT) Lambda Layer JavaScript ](#lambda-execution) + [ ## TypeError saat menggunakan Response Streaming Lambda handler dengan AWS Distro for ( OpenTelemetry ADOT) Lambda Layer JavaScript ](#lambda-execution-streaming) + [ ## Perbarui ke versi agen atau add-on Amazon EKS yang diperlukan ](#CloudWatch-Application-Signals-Agent-Versions) + [ ## Embedded Metric Format (EMF) dinonaktifkan untuk Sinyal Aplikasi ](#emf-appsignals) ## OpenTelemetry Konflik konfigurasi alamat di Amazon EKS dengan Sinyal Aplikasi Jika Anda menggunakan OpenTelemetry (OTel) untuk pemantauan kinerja aplikasi (APM) dengan Amazon EKS dan mengonfigurasi titik akhir eksportir OTLP khusus selain CloudWatch titik akhir, Anda mungkin mengalami perilaku berikut setelah menginstal atau meningkatkan ke CloudWatch add-on Observability versi 5.0.0 atau yang lebih baru: + Gangguan pada OTel telemetri yang ada — Add-on CloudWatch observabilitas dapat mengesampingkan titik akhir eksportir OTLP yang Anda kode keras dalam aplikasi Anda. Penggantian ini tidak memengaruhi titik akhir yang dikonfigurasi melalui variabel lingkungan kontainer atau. `envFrom` ConfigMap Saat diganti, metrik dan jejak Anda mungkin tidak mencapai tujuan yang diinginkan. Untuk mempertahankan pengaturan APM yang ada setelah memutakhirkan ke V5.0.0 atau yang lebih baru, lihat [Menyisih dari Sinyal Aplikasi](install-CloudWatch-Observability-EKS-addon.md#Opting-out-App-Signals) + Sinyal Aplikasi mungkin tidak berfungsi jika sebelumnya Anda mengaktifkan Sinyal Aplikasi menggunakan add-on CloudWatch Observabilitas dan memiliki titik akhir OTLP khusus yang dikonfigurasi. Untuk mengatasi ini, hapus titik akhir OTLP khusus atau setel variabel lingkungan `OTEL_AWS_APPLICATION_SIGNALS_ENABLED=true` saat menginstal atau memutakhirkan ke versi 5.0.0 atau yang lebih baru ## Sinyal Aplikasi Kinerja awal dingin lapisan Java Menambahkan Application Signals Layer ke fungsi Java Lambda meningkatkan latensi startup (cold start time). Kiat-kiat berikut dapat membantu mengurangi latensi untuk fungsi yang sensitif terhadap waktu. **Startup cepat untuk agen Java** - Application Signals Java Lambda Layer menyertakan fitur Fast Startup yang dimatikan secara default tetapi dapat diaktifkan dengan mengatur variabel OTEL\$1JAVA\$1AGENT\$1FAST\$1STARTUP\$1ENABLED ke true. Saat diaktifkan, fitur ini mengonfigurasi JVM untuk menggunakan kompiler C1 tingkat kompilasi berjenjang 1 untuk menghasilkan kode asli yang dioptimalkan dengan cepat untuk memulai dingin yang lebih cepat. Kompiler C1 memprioritaskan kecepatan dengan mengorbankan optimasi jangka panjang sedangkan kompiler C2 memberikan kinerja keseluruhan yang unggul dengan membuat profil data dari waktu ke waktu. Untuk informasi selengkapnya, lihat [Startup cepat untuk agen Java](https://github.com/open-telemetry/opentelemetry-lambda/blob/main/java/README.md#fast-startup-for-java-agent). **Kurangi waktu mulai dingin dengan Provisioned Concurrency** - konkurensi yang AWS Lambda disediakan sebelumnya mengalokasikan sejumlah instance fungsi tertentu, menjaganya agar tetap diinisialisasi dan siap menangani permintaan dengan segera. Ini mengurangi waktu mulai dingin dengan menghilangkan kebutuhan untuk menginisialisasi lingkungan fungsi selama eksekusi, memastikan kinerja yang lebih cepat dan lebih konsisten, terutama untuk beban kerja yang sensitif terhadap latensi. Untuk informasi selengkapnya, lihat [Mengonfigurasi konkurensi yang disediakan](https://docs.aws.amazon.com/lambda/latest/dg/provisioned-concurrency.html) untuk suatu fungsi. **Optimalkan kinerja startup menggunakan Lambda SnapStart** — AWS Lambda SnapStart adalah fitur yang mengoptimalkan kinerja startup fungsi Lambda dengan membuat snapshot pra-inisialisasi dari lingkungan eksekusi setelah fase inisialisasi fungsi. Snapshot ini kemudian digunakan kembali untuk memulai instance baru, secara signifikan mengurangi waktu mulai dingin dengan melewatkan proses inisialisasi selama pemanggilan fungsi. Untuk selengkapnya, lihat [Meningkatkan performa startup dengan Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) ## Aplikasi tidak memulai setelah Sinyal Aplikasi diaktifkan Jika aplikasi Anda di klaster Amazon EKS tidak memulai setelah Anda mengaktifkan Sinyal Aplikasi di klaster, Anda perlu memeriksa hal-hal berikut: + Periksa apakah aplikasi telah diinstrumentasi oleh solusi pemantauan yang lain. Sinyal Aplikasi mungkin tidak mendukung hidup berdampingan dengan solusi instrumentasi lainnya. + Konfirmasikan bahwa aplikasi Anda sudah memenuhi persyaratan kompatibilitas untuk menggunakan Sinyal Aplikasi. Untuk informasi selengkapnya, lihat [Sistem yang didukung](CloudWatch-Application-Signals-supportmatrix.md). + Jika aplikasi Anda gagal menarik artefak Sinyal Aplikasi seperti AWS Distro untuk OpenTelemetery Java atau agen Python dan gambar CloudWatch agen, itu bisa menjadi masalah jaringan. Untuk mengurangi masalah, hapus anotasi `instrumentation.opentelemetry.io/inject-java: "true"` atau `instrumentation.opentelemetry.io/inject-python: "true"` dari manifes penerapan aplikasi Anda, dan terapkan ulang aplikasi Anda. Kemudian periksa apakah aplikasi sudah berfungsi. **Masalah yang diketahui** Koleksi metrik runtime dalam rilis Java SDK v1.32.5 diketahui tidak berfungsi dengan aplikasi yang menggunakan Wildfly. JBoss Masalah ini meluas ke add-on Amazon CloudWatch Observability EKS, memengaruhi versi melalui. `2.3.0-eksbuild.1` `2.5.0-eksbuild.1` Jika Anda terpengaruh, turunkan versi atau nonaktifkan koleksi metrik runtime Anda dengan menambahkan variabel `OTEL_AWS_APPLICATION_SIGNALS_RUNTIME_ENABLED=false` lingkungan ke aplikasi Anda. ## Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan Ini adalah masalah yang diketahui dalam OpenTelemetry instrumentasi otomatis bahwa variabel `PYTHONPATH` lingkungan yang hilang terkadang dapat menyebabkan aplikasi gagal memulai. Untuk mengatasi hal ini, pastikan Anda menyetel variabel `PYTHONPATH` lingkungan ke lokasi direktori kerja aplikasi Anda. Untuk informasi lebih lanjut tentang masalah ini, lihat [pengaturan autoinstrumentasi Python dari PYTHONPATH tidak sesuai dengan perilaku resolusi modul Python](https://github.com/open-telemetry/opentelemetry-operator/issues/2302), melanggar aplikasi Django. [Untuk aplikasi Django, ada konfigurasi tambahan yang diperlukan, yang diuraikan dalam dokumentasi Python OpenTelemetry .](https://opentelemetry-python.readthedocs.io/en/latest/examples/django/README.html) + Gunakan `--noreload` bendera untuk mencegah pemuatan ulang otomatis. + Tetapkan variabel `DJANGO_SETTINGS_MODULE` lingkungan ke lokasi `settings.py` berkas aplikasi Django Anda. Ini memastikan bahwa OpenTelemetry dapat mengakses dan mengintegrasikan dengan benar dengan pengaturan Django Anda. ## Tidak ada data Sinyal Aplikasi untuk aplikasi Python yang menggunakan server WSGI Jika Anda menggunakan server WSGI seperti Gunicorn atau UWSGI, Anda harus membuat perubahan tambahan untuk membuat instrumentasi otomatis ADOT Python berfungsi. **catatan** Pastikan Anda menggunakan versi terbaru ADOT Python dan add-on CloudWatch Amazon Observability EKS sebelum melanjutkan. **Langkah-langkah tambahan untuk mengaktifkan Sinyal Aplikasi dengan server WSGI** 1. Impor instrumentasi otomatis dalam proses pekerja bercabang. Untuk Gunicorn, gunakan `post_fork` pengait: ``` # gunicorn.conf.py def post_fork(server, worker): from opentelemetry.instrumentation.auto_instrumentation import sitecustomize ``` Untuk uWSGI, gunakan direktif. `import` ``` # uwsgi.ini [uwsgi] ; required for the instrumentation of worker processes enable-threads = true lazy-apps = true import = opentelemetry.instrumentation.auto_instrumentation.sitecustomize ``` 1. Aktifkan konfigurasi untuk instrumentasi otomatis ADOT Python untuk melewati proses utama dan tunduk pada pekerja dengan menyetel variabel lingkungan ke. `OTEL_AWS_PYTHON_DEFER_TO_WORKERS_ENABLED` `true` ## Aplikasi Node.js saya tidak diinstrumentasi atau tidak menghasilkan telemetri Sinyal Aplikasi Untuk mengaktifkan Sinyal Aplikasi untuk Node.js, Anda harus memastikan bahwa aplikasi Node.js Anda menggunakan format modul CommonJS (CJS). AWS Distro untuk OpenTelemetry Node.js tidak mendukung format modul ESM, karena OpenTelemetry JavaScript dukungan ESM bersifat eksperimental dan sedang dalam proses. Untuk menentukan apakah aplikasi Anda menggunakan CJS dan bukan ESM, pastikan aplikasi Anda tidak memenuhi [persyaratan untuk mengaktifkan](https://nodejs.org/api/esm.html#enabling) ESM. ## Aplikasi .NET saya tidak diinstrumentasi atau rusak untuk panggilan AWS SDK AWS Distro untuk Open Telemetry (ADOT) SDK untuk.NET tidak mendukung SDK untuk.NET V4. AWS Gunakan AWS SDK .NET V3 untuk dukungan Sinyal Aplikasi penuh. ## Tidak ada data aplikasi di dasbor Sinyal Aplikasi Jika ada metrik atau jejak yang hilang di dasbor Sinyal Aplikasi, hal-hal berikut ini mungkin menjadi penyebabnya. Selidiki penyebab-penyebab tersebut hanya jika Anda telah menunggu 15 menit untuk Sinyal Aplikasi mengumpulkan dan menampilkan data sejak pembaruan terakhir Anda. + Pastikan pustaka dan kerangka kerja yang Anda gunakan didukung oleh agen ADOT Java. Untuk informasi selengkapnya, silakan lihat [Pustaka / Kerangka Kerja](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md#libraries--frameworks). + Pastikan CloudWatch agen sedang berjalan. Pertama periksa status pod CloudWatch agen dan pastikan semuanya dalam `Running` status. ``` kubectl -n amazon-cloudwatch get pods. ``` Tambahkan berikut ini ke file konfigurasi CloudWatch agen untuk mengaktifkan log debugging, dan kemudian restart agen. ``` "agent": { "region": "${REGION}", "debug": true }, ``` Kemudian periksa kesalahan pada pod CloudWatch agen. + Periksa masalah konfigurasi dengan CloudWatch agen. Konfirmasikan bahwa berikut ini masih dalam file konfigurasi CloudWatch agen dan agen telah dimulai ulang sejak ditambahkan. ``` "agent": { "region": "${REGION}", "debug": true }, ``` Kemudian periksa log OpenTelemetry debugging untuk pesan kesalahan seperti`ERROR io.opentelemetry.exporter.internal.grpc.OkHttpGrpcExporter - Failed to export ...`. Pesan-pesan ini mungkin menunjukkan masalah. Jika itu tidak menyelesaikan masalah, buang dan periksa variabel lingkungan dengan nama yang dimulai `OTEL_` dengan menjelaskan pod dengan perintah `kubectl describe pod`. + Untuk mengaktifkan logging debug OpenTelemetry Python, atur variabel lingkungan `OTEL_PYTHON_LOG_LEVEL` ke `debug` dan gunakan kembali aplikasi. + Periksa izin yang salah atau tidak memadai untuk mengekspor data dari agen. CloudWatch Jika Anda melihat `Access Denied` pesan di log CloudWatch agen, ini mungkin masalahnya. Ada kemungkinan bahwa izin yang diterapkan saat Anda menginstal CloudWatch agen kemudian diubah atau dicabut. + Periksa masalah AWS Distro untuk OpenTelemetry (ADOT) saat membuat data telemetri. Pastikan bahwa keterangan instrumentasi `instrumentation.opentelemetry.io/inject-java` dan ` sidecar.opentelemetry.io/inject-java` diterapkan pada penerapan aplikasi deployment dan nilainya adalah `true`. Tanpa ini, pod aplikasi tidak akan diinstrumentasi bahkan jika add-on ADOT sudah diinstal dengan benar. Berikutnya, periksa apakah kontainer `init` diterapkan pada aplikasi dan status `Ready` adalah `True`. Jika kontainer `init` belum siap, silakan lihat statusnya untuk alasannya. Jika masalah berlanjut, aktifkan pencatatan debug di OpenTelemetry Java SDK dengan menyetel variabel lingkungan `OTEL_JAVAAGENT_DEBUG` ke true dan menerapkan ulang aplikasi. Kemudian cari pesan yang dimulai dengan `ERROR io.telemetry`. + metric/span Eksportir mungkin menjatuhkan data. Untuk mengetahuinya, periksa log aplikasi untuk pesan yang menyertakan `Failed to export...` + CloudWatch Agen mungkin terhambat saat mengirim metrik atau bentang ke Sinyal Aplikasi. Periksa pesan yang menunjukkan pelambatan di log CloudWatch agen. + Pastikan Anda telah mengaktifkan pengaturan penemuan layanan. Anda hanya perlu melakukan ini sekali di Wilayah Anda. Untuk mengonfirmasi hal ini, di CloudWatch konsol pilih **Sinyal Aplikasi**, **Layanan**. Jika Langkah 1 tidak ditandai **Selesai**, pilih **Mulai menemukan layanan Anda**. Data akan mulai mengalir dalam waktu lima menit. ## Metrik layanan atau metrik ketergantungan memiliki nilai Tidak Dikenal Jika Anda melihat **UnknownService**, **UnknownOperation**, **UnknownRemoteService**, atau **UnknownRemoteOperation**untuk nama ketergantungan atau operasi di dasbor Sinyal Aplikasi, periksa apakah kemunculan titik data untuk layanan jarak jauh yang tidak diketahui dan operasi jarak jauh yang tidak diketahui bertepatan dengan penerapannya. + **UnknownService**berarti bahwa nama aplikasi yang diinstrumentasi tidak diketahui. Jika variabel `OTEL_SERVICE_NAME` lingkungan tidak terdefinisi dan `service.name` tidak ditentukan dalam`OTEL_RESOURCE_ATTRIBUTES`, nama layanan disetel ke`UnknownService`. Untuk memperbaikinya, tentukan nama layanan di `OTEL_SERVICE_NAME` atau`OTEL_RESOURCE_ATTRIBUTES`. + **UnknownOperation**berarti bahwa nama operasi yang dipanggil tidak diketahui. Ini terjadi ketika Sinyal Aplikasi tidak dapat menemukan nama operasi yang memanggil panggilan jarak jauh, atau ketika nama operasi yang diekstraksi berisi nilai kardinalitas tinggi. + **UnknownRemoteService**berarti bahwa nama layanan tujuan tidak diketahui. Ini terjadi ketika sistem tidak dapat mengekstrak nama layanan tujuan yang diakses panggilan jarak jauh. Salah satu solusinya adalah membuat rentang kustom di sekitar fungsi yang mengirimkan permintaan, dan menambahkan atribut `aws.remote.service` dengan nilai yang ditentukan. Pilihan lain adalah mengkonfigurasi CloudWatch agen untuk menyesuaikan nilai metrik`RemoteService`. Untuk informasi selengkapnya tentang penyesuaian di CloudWatch agen, lihat. [Aktifkan Sinyal CloudWatch Aplikasi](CloudWatch-Agent-Application_Signals.md) + **UnknownRemoteOperation**berarti bahwa nama operasi tujuan tidak diketahui. Ini terjadi ketika sistem tidak dapat mengekstrak nama operasi tujuan yang diakses panggilan jarak jauh. Salah satu solusinya adalah membuat rentang kustom di sekitar fungsi yang mengirimkan permintaan, dan menambahkan atribut `aws.remote.operation` dengan nilai yang ditentukan. Pilihan lain adalah mengkonfigurasi CloudWatch agen untuk menyesuaikan nilai metrik`RemoteOperation`. Untuk informasi selengkapnya tentang penyesuaian di CloudWatch agen, lihat. [Aktifkan Sinyal CloudWatch Aplikasi](CloudWatch-Agent-Application_Signals.md) ## Menangani ConfigurationConflict saat mengelola add-on Amazon CloudWatch Observability EKS Saat Anda menginstal atau memperbarui add-on Amazon CloudWatch Observability EKS, jika Anda melihat kegagalan yang `Health Issue` disebabkan oleh tipe `ConfigurationConflict` dengan deskripsi yang dimulai`Conflicts found when trying to apply. Will not continue due to resolve conflicts mode`, kemungkinan karena Anda sudah memiliki CloudWatch agen dan komponen terkait seperti ServiceAccount, ClusterRole dan yang ClusterRoleBinding diinstal pada cluster. Ketika add-on mencoba menginstal CloudWatch agen dan komponen terkait, jika mendeteksi perubahan apa pun dalam konten, secara default gagal instalasi atau pembaruan untuk menghindari penimpaan status sumber daya pada cluster. Jika Anda mencoba untuk onboard ke add-on Amazon CloudWatch Observability EKS dan Anda melihat kegagalan ini, kami sarankan untuk menghapus penyiapan CloudWatch agen yang ada yang sebelumnya Anda instal di cluster dan kemudian menginstal add-on EKS. Pastikan untuk mencadangkan penyesuaian apa pun yang mungkin telah Anda buat ke penyiapan CloudWatch agen asli seperti konfigurasi agen khusus, dan berikan ini ke add-on Amazon CloudWatch Observability EKS saat Anda menginstal atau memperbaruinya berikutnya. Jika sebelumnya Anda telah menginstal CloudWatch agen untuk orientasi ke Container Insights, lihat [Menghapus CloudWatch agen dan Fluent Bit untuk Wawasan Kontainer](ContainerInsights-delete-agent.md) untuk informasi selengkapnya. Atau, add-on mendukung opsi konfigurasi resolusi konflik yang memiliki kemampuan untuk menentukan `OVERWRITE`. Anda dapat menggunakan opsi ini untuk melanjutkan dengan melakukan instalasi atau memperbarui add-on dengan menimpa konflik di klaster. Jika Anda menggunakan konsol Amazon EKS, Anda akan menemukan **Metode penyelesaian konflik** saat Anda memilih **Pengaturan konfigurasi opsional** ketika Anda membuat atau memperbarui add-on. Jika Anda menggunakan AWS CLI, Anda dapat memberikan perintah Anda `--resolve-conflicts OVERWRITE` untuk membuat atau memperbarui add-on. ## Saya ingin memfilter metrik dan jejak yang tidak perlu Jika Application Signals mengumpulkan jejak dan metrik yang tidak Anda inginkan, lihat [Kelola operasi kardinalitas tinggi](Application-Signals-Cardinality.md) informasi tentang mengonfigurasi CloudWatch agen dengan aturan khusus untuk mengurangi kardinalitas. Untuk informasi tentang menyesuaikan aturan pengambilan sampel jejak, lihat [Mengonfigurasi aturan pengambilan sampel](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console) dalam dokumentasi X-Ray. ## Apa `InternalOperation` artinya? An `InternalOperation` adalah operasi yang dipicu oleh aplikasi secara internal dan bukan oleh pemanggilan eksternal. Melihat `InternalOperation` diharapkan, perilaku sehat. Beberapa contoh khas di mana Anda akan melihat `InternalOperation` termasuk yang berikut: + **Preloading saat mulai** — Aplikasi Anda melakukan operasi bernama `loadDatafromDB` yang membaca metadata dari database selama fase pemanasan. Alih-alih mengamati `loadDatafromDB` sebagai operasi layanan, Anda akan melihatnya dikategorikan sebagai`InternalOperation`. + **Eksekusi asinkron di latar belakang** — Aplikasi Anda berlangganan antrian acara, dan memproses data streaming sesuai dengan itu setiap kali ada pembaruan. Setiap operasi yang dipicu akan berada di bawah `InternalOperation` sebagai operasi layanan. + **Mengambil informasi host dari registri layanan** — Aplikasi Anda berbicara ke registri layanan untuk penemuan layanan. Semua interaksi dengan sistem penemuan diklasifikasikan sebagai`InternalOperation`. ## Bagaimana cara mengaktifkan logging untuk aplikasi.NET? Untuk mengaktifkan logging untuk aplikasi.NET, konfigurasikan variabel lingkungan berikut. Untuk informasi selengkapnya tentang cara mengonfigurasi variabel lingkungan ini, lihat [Memecahkan masalah instrumentasi otomatis.NET dalam dokumentasi](https://opentelemetry.io/docs/zero-code/net/troubleshooting/#general-steps). OpenTelemetry + `OTEL_LOG_LEVEL` + `OTEL_DOTNET_AUTO_LOG_DIRECTORY` + `COREHOST_TRACE` + `COREHOST_TRACEFILE` ## Bagaimana saya bisa menyelesaikan konflik versi perakitan di aplikasi.NET? Jika Anda mendapatkan kesalahan berikut, lihat [Konflik versi perakitan](https://opentelemetry.io/docs/zero-code/net/troubleshooting/#assembly-version-conflicts) dalam OpenTelemetry dokumentasi untuk langkah-langkah resolusi. ``` Unhandled exception. System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified. File name: 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60' at Microsoft.AspNetCore.Builder.WebApplicationBuilder..ctor(WebApplicationOptions options, Action`1 configureDefaults) at Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(String[] args) at Program.
$(String[] args) in /Blog.Core/Blog.Core.Api/Program.cs:line 26 ``` ## Bisakah saya menonaktifkan FluentBit? Anda dapat menonaktifkan FluentBit dengan mengonfigurasi add-on Amazon CloudWatch Observability EKS. Untuk informasi selengkapnya, lihat [(Opsional) Konfigurasi tambahan](install-CloudWatch-Observability-EKS-addon.md#install-CloudWatch-Observability-EKS-addon-configuration). ## Bisakah saya memfilter log kontainer sebelum mengekspor ke CloudWatch Log? Tidak, memfilter log kontainer belum didukung. ## Menyelesaikan TypeError saat Menggunakan AWS Distro for OpenTelemetry (ADOT) Lambda Layer JavaScript Fungsi Lambda Anda mungkin gagal dengan kesalahan ini: `TypeError - "Cannot redefine property: handler"` ketika Anda: + Gunakan Layer JavaScript Lambda ADOT + Gunakan `esbuild` untuk mengkompilasi TypeScript + Ekspor handler Anda dengan kata kunci `export` Lapisan JavaScript Lambda ADOT perlu memodifikasi handler Anda saat runtime. Bila Anda menggunakan `export` kata kunci dengan `esbuild` (langsung atau melalui AWS CDK), `esbuild` membuat handler Anda tidak berubah, mencegah modifikasi ini. Ekspor fungsi handler Anda menggunakan `module.exports` alih-alih `export` kata kunci: ``` // Before export const handler = (event) => { // Handler Code } ``` ``` // After const handler = async (event) => { // Handler Code } module.exports = { handler } ``` ## TypeError saat menggunakan Response Streaming Lambda handler dengan AWS Distro for ( OpenTelemetry ADOT) Lambda Layer JavaScript Fungsi Lambda Anda mungkin gagal dengan kesalahan ini: `TypeError - "responseStream.write is not a function"` ketika Anda: + Gunakan Lapisan JavaScript Lambda ADOT dengan Instrumentasi AWS Lambda diaktifkan (diaktifkan secara default) + Menggunakan fitur streaming respons di runtime terkelola Node.js. Misalnya, ketika penangan fungsi Anda seperti: ``` * export const handler = awslambda.streamifyResponse(...) ``` Instrumentasi AWS Lambda di Lapisan JavaScript Lambda ADOT saat ini tidak mendukung Streaming Respons di runtime terkelola Node.js, jadi harus dinonaktifkan untuk menghindari hal ini. TypeError ## Perbarui ke versi agen atau add-on Amazon EKS yang diperlukan Setelah 9 Agustus 2024, CloudWatch Application Signals tidak akan lagi mendukung versi lama dari add-on Amazon CloudWatch Observability EKS, CloudWatch agen, dan AWS Distro untuk agen instrumentasi otomatis. OpenTelemetry + Untuk add-on Amazon CloudWatch Observability EKS, versi yang lebih lama dari tidak `v1.7.0-eksbuild.1` akan didukung. + Untuk CloudWatch agen, versi yang lebih lama dari `1.300040.0` tidak akan didukung. + Untuk AWS Distro untuk agen OpenTelemetry instrumentasi otomatis: + Untuk Java, versi yang lebih lama dari `1.32.2` tidak didukung. + Untuk Python, versi yang lebih lama dari `0.2.0` tidak didukung. + Untuk.NET, versi yang lebih lama dari `1.3.2` tidak didukung. + Untuk Node.js, versi yang lebih lama dari `0.3.0` tidak didukung. **penting** Versi terbaru dari agen mencakup pembaruan skema metrik Sinyal Aplikasi. Pembaruan ini tidak kompatibel ke belakang, dan ini dapat mengakibatkan masalah data jika versi yang tidak kompatibel digunakan. Untuk membantu memastikan transisi yang mulus ke fungsionalitas baru, lakukan hal berikut: Jika aplikasi Anda berjalan di Amazon EKS, pastikan untuk memulai ulang semua aplikasi yang diinstrumentasi setelah Anda memperbarui add-on Amazon CloudWatch Observability. **Untuk aplikasi yang berjalan di platform lain, pastikan untuk meningkatkan CloudWatch agen dan agen AWS OpenTelemetry instrumentasi otomatis ke versi terbaru.** Petunjuk di bagian berikut dapat membantu Anda memperbarui ke versi yang didukung. **Contents** + [ ### Perbarui add-on Amazon CloudWatch Observability EKS ](#Application-Signals-Upgrade-Addon) + [ #### Gunakan konsol ](#Upgrade-Addon-Console) + [ #### Gunakan AWS CLI ](#Upgrade-Addon-CLI) + [ ### Perbarui CloudWatch agen dan agen ADOT ](#Application-Signals-Upgrade-Agents) + [ #### Pembaruan di Amazon ECS ](#Upgrade-Agents-ECS) + [ #### Pembaruan di Amazon EC2 atau arsitektur lainnya ](#Upgrade-Addon-EC2) ### Perbarui add-on Amazon CloudWatch Observability EKS Untuk add-on Amazon CloudWatch Observability EKS, Anda dapat menggunakan Konsol Manajemen AWS atau. AWS CLI #### Gunakan konsol **Untuk memutakhirkan add-on menggunakan konsol** 1. Buka konsol Amazon EKS di [https://console.aws.amazon.com/eks/rumah\$1/cluster](https://console.aws.amazon.com/eks/home#/clusters). 1. Pilih nama kluster Amazon EKS untuk diperbarui. 1. Pilih tab **Add-ons**, lalu pilih **Amazon CloudWatch Observability**. 1. Pilih **Edit**, pilih versi yang ingin Anda perbarui, lalu pilih **Simpan perubahan**. Pastikan untuk memilih `v1.7.0-eksbuild.1` atau nanti. 1. Masukkan salah satu AWS CLI perintah berikut untuk memulai ulang layanan Anda. ``` # Restart a deployment kubectl rollout restart deployment/name # Restart a daemonset kubectl rollout restart daemonset/name # Restart a statefulset kubectl rollout restart statefulset/name ``` #### Gunakan AWS CLI **Untuk meng-upgrade add-on menggunakan AWS CLI** 1. Masukkan perintah berikut untuk menemukan versi terbaru. ``` aws eks describe-addon-versions \ --addon-name amazon-cloudwatch-observability ``` 1. Masukkan perintah berikut untuk memperbarui add-on. Ganti *\$1VERSION* dengan versi yang ada `v1.7.0-eksbuild.1` atau lebih baru. Ganti *\$1AWS\$1REGION* dan *\$1CLUSTER* dengan nama Region dan cluster Anda. ``` aws eks update-addon \ --region $AWS_REGION \ --cluster-name $CLUSTER \ --addon-name amazon-cloudwatch-observability \ --addon-version $VERSION \ # required only if the advanced configuration is used. --configuration-values $JSON_CONFIG ``` **catatan** Jika Anda menggunakan konfigurasi khusus untuk add-on, Anda dapat menemukan contoh konfigurasi yang akan digunakan untuk *\$1JSON\$1CONFIG* di[Aktifkan Sinyal CloudWatch Aplikasi](CloudWatch-Agent-Application_Signals.md). 1. Masukkan salah satu AWS CLI perintah berikut untuk memulai ulang layanan Anda. ``` # Restart a deployment kubectl rollout restart deployment/name # Restart a daemonset kubectl rollout restart daemonset/name # Restart a statefulset kubectl rollout restart statefulset/name ``` ### Perbarui CloudWatch agen dan agen ADOT Jika layanan Anda berjalan pada arsitektur selain Amazon EKS, Anda perlu meningkatkan CloudWatch agen dan agen instrumentasi otomatis ADOT untuk menggunakan fitur Sinyal Aplikasi terbaru. #### Pembaruan di Amazon ECS **Untuk meningkatkan agen Anda untuk layanan yang berjalan di Amazon ECS** 1. Buat revisi definisi tugas baru. Untuk informasi selengkapnya, lihat [Memperbarui definisi tugas menggunakan konsol](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-task-definition-console-v2). 1. Ganti `ecs-cwagent` wadah dengan tag gambar terbaru dari [cloudwatch-agent](https://gallery.ecr.aws/cloudwatch-agent/cloudwatch-agent) di Amazon ECR. `$IMAGE` Jika Anda memutakhirkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat`1.300040.0`. 1. `$IMAGE`Ganti `init` wadah dengan tag gambar terbaru dari lokasi berikut: + Untuk Java, gunakan [adot-autoinstrumentation-javaaws-observability/](https://gallery.ecr.aws/aws-observability/adot-autoinstrumentation-java). Jika Anda memutakhirkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat`1.32.2`. + [Untuk Python, gunakan aws-observability/. adot-autoinstrumentation-python](https://gallery.ecr.aws/aws-observability/adot-autoinstrumentation-python) Jika Anda memutakhirkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat`0.2.0`. + Untuk.NET, gunakan [adot-autoinstrumentation-dotnetaws-observability/](https://gallery.ecr.aws/aws-observability/adot-autoinstrumentation-dotnet). Jika Anda memutakhirkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat`1.3.2`. + Untuk Node.js, gunakan [adot-autoinstrumentation-nodeaws-observability/](https://gallery.ecr.aws/aws-observability/adot-autoinstrumentation-node). Jika Anda memutakhirkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat`0.3.0`. 1. Perbarui variabel lingkungan Sinyal Aplikasi di container aplikasi Anda dengan mengikuti petunjuk di[Langkah 4: Instrumentasikan aplikasi Anda dengan CloudWatch agen](CloudWatch-Application-Signals-ECS-Sidecar.md#CloudWatch-Application-Signals-Enable-ECS-Instrument). 1. Terapkan layanan Anda dengan definisi tugas baru. #### Pembaruan di Amazon EC2 atau arsitektur lainnya **Untuk meningkatkan agen Anda untuk layanan yang berjalan di Amazon EC2 atau arsitektur lainnya** 1. Pastikan untuk memilih versi `1.300040.0` atau versi CloudWatch agen yang lebih baru. 1. Unduh versi terbaru dari AWS Distro untuk agen OpenTelemetry instrumentasi otomatis dari salah satu lokasi berikut: + Untuk Java, gunakan [aws-otel-java-instrumentation ](https://gallery.ecr.aws/aws-observability/adot-autoinstrumentation-java). Jika Anda meningkatkan ke versi tetap, pastikan untuk memilih `1.32.2` atau lebih baru. + Untuk Python, gunakan. [aws-otel-python-instrumentation ](https://github.com/aws-observability/aws-otel-python-instrumentation/releases) Jika Anda meningkatkan ke versi tetap, pastikan untuk memilih `0.2.0` atau lebih baru. + Untuk .NET, gunakan [aws-otel-dotnet-instrumentation](https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases). Jika Anda meningkatkan ke versi tetap, pastikan untuk memilih `1.3.2` atau lebih baru. + Untuk Node.js, gunakan [aws-otel-js-instrumentation](https://github.com/aws-observability/aws-otel-js-instrumentation/releases). Jika Anda meningkatkan ke versi tetap, pastikan untuk memilih `0.3.0` atau lebih baru. 1. Terapkan variabel lingkungan Sinyal Aplikasi yang diperbarui ke aplikasi Anda, lalu mulai aplikasi Anda. Untuk informasi selengkapnya, lihat [Langkah 3: Menginstrumentasikan aplikasi Anda dan memulainya](CloudWatch-Application-Signals-Enable-EC2Main.md#CloudWatch-Application-Signals-Enable-Other-instrument). ## Embedded Metric Format (EMF) dinonaktifkan untuk Sinyal Aplikasi Menonaktifkan EMF untuk grup `/aws/application-signals/data` log dapat memiliki dampak berikut pada fungsionalitas Sinyal Aplikasi. + Metrik dan grafik Sinyal Aplikasi tidak akan ditampilkan + Fungsionalitas Sinyal Aplikasi akan terdegradasi **Bagaimana cara mengembalikan Sinyal Aplikasi?** Ketika Sinyal Aplikasi menampilkan bagan atau metrik kosong, Anda harus mengaktifkan EMF untuk grup `/aws/application-signals/data` log untuk memulihkan fungsionalitas penuh. Lihat informasi yang lebih lengkap di [PutAccountPolicy](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html#API_PutAccountPolicy_RequestSyntax).