Melakukan pemecahan masalah instalasi yang terjadi pada Sinyal Aplikasi Anda - Amazon CloudWatch
Sinyal Aplikasi Kinerja awal dingin lapisan JavaAplikasi tidak memulai setelah Sinyal Aplikasi diaktifkanAplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkanTidak ada data Sinyal Aplikasi untuk aplikasi Python yang menggunakan server WSGIAplikasi Node.js saya tidak diinstrumentasi atau tidak menghasilkan telemetri Sinyal AplikasiTidak ada data aplikasi di dasbor Sinyal AplikasiMetrik layanan atau metrik ketergantungan memiliki nilai Tidak DikenalMenangani ConfigurationConflict saat mengelola add-on Amazon CloudWatch Observability EKSSaya ingin memfilter metrik dan jejak yang tidak perluApa InternalOperation artinya?Bagaimana cara mengaktifkan logging untuk aplikasi.NET?Bagaimana saya bisa menyelesaikan konflik versi perakitan di aplikasi.NET?Bisakah saya menonaktifkan FluentBit?Bisakah saya memfilter log kontainer sebelum mengekspor ke CloudWatch Log? Menyelesaikan TypeError saat Menggunakan AWS Distro for OpenTelemetry (ADOT) Lambda Layer JavaScript Perbarui ke versi agen atau add-on Amazon EKS yang diperlukan

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.

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_JAVA_AGENT_FAST_STARTUP_ENABLED 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.

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 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 kinerja startup dengan Lambda SnapStart

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.

  • 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 mengatur 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, melanggar aplikasi Django.

Untuk aplikasi Django, ada konfigurasi tambahan yang diperlukan, yang diuraikan dalam dokumentasi Python OpenTelemetry .

  • 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

  2. 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). Saat ini, 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 bahwa aplikasi Anda tidak memenuhi persyaratan untuk mengaktifkan ESM.

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.

  • 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, lalu 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 sepertiERROR 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 UnknownRemoteOperationuntuk 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.

  • UnknownServiceberarti bahwa nama aplikasi yang diinstrumentasi tidak diketahui. Jika variabel OTEL_SERVICE_NAME lingkungan tidak terdefinisi dan service.name tidak ditentukan dalamOTEL_RESOURCE_ATTRIBUTES, nama layanan disetel keUnknownService. Untuk memperbaikinya, tentukan nama layanan di OTEL_SERVICE_NAME atauOTEL_RESOURCE_ATTRIBUTES.

  • UnknownOperationberarti 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.

  • UnknownRemoteServiceberarti 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 khusus 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 metrikRemoteService. Untuk informasi selengkapnya tentang penyesuaian di CloudWatch agen, lihat. Aktifkan Sinyal CloudWatch Aplikasi

  • UnknownRemoteOperationberarti 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 khusus 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 metrikRemoteOperation. Untuk informasi selengkapnya tentang penyesuaian di CloudWatch agen, lihat. Aktifkan Sinyal CloudWatch Aplikasi

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 dimulaiConflicts 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 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 informasi tentang mengonfigurasi CloudWatch agen dengan aturan khusus untuk mengurangi kardinalitas.

Untuk informasi tentang menyesuaikan aturan pengambilan sampel jejak, lihat Mengonfigurasi aturan pengambilan sampel 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 sebagaiInternalOperation.

  • 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 sebagaiInternalOperation.

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 Mengatasi masalah instrumentasi otomatis.NET dalam dokumentasi. 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 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.<Main>$(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.

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 }

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 agen menyertakan 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.

Perbarui add-on Amazon CloudWatch Observability EKS

Untuk add-on Amazon CloudWatch Observability EKS, Anda dapat menggunakan AWS Management Console atau. AWS CLI

Gunakan konsol

Untuk memutakhirkan add-on menggunakan konsol

  1. Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/rumah#/cluster.

  2. Pilih nama kluster Amazon EKS untuk diperbarui.

  3. Pilih tab Add-ons, lalu pilih Amazon CloudWatch Observability.

  4. Pilih Edit, pilih versi yang ingin Anda perbarui, lalu pilih Simpan perubahan.

    Pastikan untuk memilih v1.7.0-eksbuild.1 atau nanti.

  5. 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

  2. Masukkan perintah berikut untuk memperbarui add-on. Ganti $VERSION dengan versi yang ada v1.7.0-eksbuild.1 atau lebih baru. Ganti $AWS_REGION dan $CLUSTER 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 $JSON_CONFIG diAktifkan Sinyal CloudWatch Aplikasi.

  3. 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.

  2. Ganti ecs-cwagent wadah dengan tag gambar terbaru dari cloudwatch-agent di Amazon ECR. $IMAGE

    Jika Anda meningkatkan ke versi tetap, pastikan untuk menggunakan versi yang sama dengan atau lebih lambat1.300040.0.

  3. $IMAGEGanti init wadah dengan tag gambar terbaru dari lokasi berikut:

  4. Perbarui variabel lingkungan Sinyal Aplikasi di container aplikasi Anda dengan mengikuti petunjuk diLangkah 4: Instrumentasikan aplikasi Anda dengan CloudWatch agen.

  5. 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. Ikuti petunjuk di Unduh paket CloudWatch agen dan tingkatkan CloudWatch agen ke versi terbaru. Pastikan untuk memilih versi 1.300040.0 atau yang lebih baru.

  2. Unduh versi terbaru dari AWS Distro untuk agen OpenTelemetry instrumentasi otomatis dari salah satu lokasi berikut:

  3. Terapkan variabel lingkungan Sinyal Aplikasi yang diperbarui ke aplikasi Anda, lalu mulai aplikasi Anda. Lihat informasi yang lebih lengkap di Langkah 3: Menginstrumentasikan aplikasi Anda dan memulainya.