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

Memantau acara layanan

Acara Layanan menyediakan observabilitas mendalam otomatis untuk layanan yang dipantau dengan Sinyal CloudWatch Aplikasi. Ini menangkap metrik kesalahan, data kinerja tingkat fungsi, snapshot insiden (ketika permintaan melebihi ambang batas latensi atau membuang pengecualian), dan peristiwa penerapan — tanpa perubahan kode tambahan.

Cara kerja acara layanan

Acara Layanan mengumpulkan jenis sinyal berikut dari layanan instrumentasi Anda:

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

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

Penyimpanan data

Acara Layanan 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 konsumsi log dan penyimpanan dengan tarif Log standar CloudWatch .

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 jejak tumpukan, pesan pengecualian, dan tautan ke jejak terkait.

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

Lihat acara layanan di log

Data Peristiwa Layanan disimpan di CloudWatch Log di bawah grup log dengan awalan/aws/service-events/service-name. Anda dapat melakukan kueri data ini secara langsung menggunakan Wawasan CloudWatch Log untuk membuat tampilan kustom, membuat dasbor, atau menyelidiki insiden tertentu.

Untuk menanyakan acara layanan:

Acara layanan di server CloudWatch Application Signals MCP (Model Context Protocol)

Data peristiwa layanan dapat diakses melalui server CloudWatch Application 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 klaster Amazon EKS petunjuk penyiapan add-on.

Fitur diaktifkan secara default

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

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 menjadi instrumen. Berikan daftar izin paket untuk mulai mengumpulkan telemetri per fungsi:

Penyaringan titik akhir

Pemfilteran 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 di mana data peristiwa layanan dikumpulkan dan dilaporkan.

Konfigurasikan peristiwa penerapan

Acara penyebaran selalu dipancarkan saat startup aplikasi dan setiap 24 jam. Menyediakan metadata penerapan akan memperkaya peristiwa ini sehingga Anda dapat mengkorelasikan 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 Tindakan GitHub

Dalam alur kerja GitHub 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 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 peristiwa 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-variabel ini ke container aplikasi Anda pada waktu penerapan melalui platform orkestrasi container Anda (misalnya, sebagai variabel lingkungan dalam definisi tugas Amazon ECS atau manifes penerapan Kubernetes).