Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memantau acara layanan

Service Events menyediakan pengamatan mendalam otomatis untuk layanan yang dipantau dengan Sin CloudWatch yal Aplikasi. Ini menangkap metrik kesalahan, data kinerja tingkat fungsi, snapshot insiden (ketika permintaan melebihi ambang latensi atau melempar pengecualian), dan peristiwa penerapan — tanpa perubahan kode tambahan.

Cara kerja acara layanan

Service Events mengumpulkan jenis sinyal berikut dari layanan berinstrumen Anda:

Acara Layanan secara otomatis diaktifkan saat Anda mengaktifkan CloudWatch Sinyal Aplikasi untuk layanan Anda. Metrik kesalahan dan pelacakan pengecualian segera aktif. Function-call metrik memerlukan konfigurasi tambahan — Anda harus mengonfigurasi paket untuk instrumen sebelum data panggilan fungsi dikumpulkan (lihatAktifkan instrumentasi fungsi). Acara Layanan dapat dinonaktifkan dengan pengaturanOTEL_AWS_SERVICE_EVENTS_ENABLED=false. Data mengalir dari ADOT SDK ke CloudWatch agen. Agen menerbitkan peristiwa ke CloudWatch Log (/aws/service-events/service-namegrup log) dan CloudWatch Metrik.

Bahasa yang didukung: Java, Python, dan Node.js.

Penyimpanan data

Service Events menyimpan data di CloudWatch Log. CloudWatch menerbitkan data peristiwa layanan ke grup log dengan awalan/aws/application-signals/service-name, di service-name mana nilai variabel OTEL_SERVICE_NAME lingkungan Anda. Satu grup log dibuat per layanan.

Anda ditagih untuk penyerapan dan penyimpanan log dengan tarif CloudWatch Log standar.

Lihat kesalahan di konsol

Di CloudWatch konsol, navigasikan ke Sinyal Aplikasi, pilih layanan Anda, lalu pilih tab Kesalahan. Tab ini menampilkan metrik pengecualian untuk layanan Anda.

Tab menampilkan:

Pilih pengecualian untuk menelusuri detail termasuk pelacakan tumpukan, pesan pengecualian, dan tautan ke pelacakan terkait.

Kesalahan dikelompokkan berdasarkan operasi, jenis pengecualian, dan bingkai tumpukan atas. Hanya perwakilan terbaru dari setiap kelompok yang ditampilkan.

Melihat peristiwa layanan di log

Data Service Events disimpan dalam CloudWatch Log di bawah grup log dengan awalan/aws/service-events/service-name. Anda dapat menanyakan data ini secara langsung menggunakan CloudWatch Logs Insights untuk membuat tampilan khusus, membuat dasbor, atau menyelidiki insiden tertentu.

Untuk menanyakan peristiwa layanan:

Peristiwa layanan di server CloudWatch Sinyal Aplikasi MCP (Model Context Protocol)

Data peristiwa layanan dapat diakses melalui server Application CloudWatch Signals MCP (Model Context Protocol), memungkinkan asisten dan agen pengkodean AI untuk menanyakan perilaku runtime layanan Anda secara langsung.

Pemecahan Masalah

Peningkatan kinerja

Untuk petunjuk penyiapan dan penggunaan, lihat server MCP Sinyal Aplikasi di GitHub situs web.

Konfigurasikan acara layanan

Prasyarat

Untuk menggunakan acara layanan, pastikan Anda memiliki versi minimum yang diperlukan dari komponen berikut:

Jika Anda menggunakan Amazon EKS, lihat Aktifkan aplikasi Anda di cluster Amazon EKS petunjuk penyiapan add-on.

Fitur diaktifkan secara default

Jika Anda menggunakan CloudWatch Sinyal Aplikasi, sinyal peristiwa layanan berikut di aktifkan secara default tanpa konfigurasi tambahan yang diperlukan:

Fitur-fitur berikut adalah opt-in dan memerlukan pengaturan variabel lingkungan untuk menghasilkan data:

Pengaturan umum

Aktifkan instrumentasi fungsi

Instrumentasi fungsi diaktifkan secara default, tetapi tidak menghasilkan metrik sampai Anda mengonfigurasi paket mana yang akan diinstrumen. Berikan daftar izin paket untuk mulai mengumpulkan telemetri per fungsi:

Pemfilteran titik akhir

Penyaringan titik akhir mengontrol titik akhir mana yang menghasilkan metrik kesalahan titik akhir dan snapshot insiden. Pengaturan ini tidak mempengaruhi instrumentasi fungsi.

Ambang batas latensi

Gunakan variabel lingkungan berikut untuk mengonfigurasi ambang latensi untuk pemicu snapshot insiden.

Pembatasan tarif

Gunakan variabel lingkungan berikut untuk mengontrol tingkat pengumpulan dan laporan data peristiwa layanan.

Konfigurasikan acara penerapan

Peristiwa penerapan selalu dipancarkan saat startup aplikasi dan setiap 24 jam. Menyediakan metadata penerapan memperkaya peristiwa ini sehingga Anda dapat menghubungkan insiden dan perubahan kinerja dengan penerapan kode tertentu.

Tetapkan variabel lingkungan berikut pada wadah atau proses aplikasi Anda untuk menyediakan metadata penerapan:

Konfigurasikan peristiwa penerapan dengan Tind GitHub akan

Dalam alur GitHub kerja Tindakan Anda, gunakan variabel lingkungan bawaan untuk mengisi metadata penerapan. Tambahkan yang berikut ini ke langkah penerapan atau lingkungan kontainer Anda:

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

Jika Anda menerapkan image kontainer, berikan nilai-nilai ini sebagai variabel lingkungan dalam definisi tugas atau spesifikasi pod Anda. Anda dapat memanggangnya ke dalam gambar pada waktu pembuatan atau menyuntikkannya pada waktu penerapan melalui konfigurasi penerapan Anda.

Konfigurasikan acara penerapan dengan GitLab CI/CD

Dalam GitLab CI/CD pipeline Anda, gunakan CI/CD variabel yang telah ditentukan untuk mengisi metadata penerapan. Tambahkan yang berikut ini ke pekerjaan penerapan Anda:

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

Teruskan variabel ini ke wadah aplikasi Anda pada waktu penerapan melalui platform orkestrasi kontainer Anda (misalnya, sebagai variabel lingkungan dalam definisi tugas Amazon ECS atau manifes penerapan Kubernetes).