View a markdown version of this page

Kumpulkan metrik dan jejak dengan OpenTelemetry - Amazon CloudWatch

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

Kumpulkan metrik dan jejak dengan OpenTelemetry

Anda dapat mengumpulkan metrik dan jejak dari aplikasi atau layanan Anda menggunakan CloudWatch agen dengan OpenTelemetry Protokol (OTLP), yang merupakan solusi open source populer. Anda dapat menggunakan OpenTelemetry SDK apa pun untuk mengirim metrik dan jejak ke CloudWatch agen. Untuk informasi selengkapnya tentang OpenTelemetry SDK yang tersedia, lihat API & OpenTelemetry SDK Bahasa yang Didukung. .

Untuk mengumpulkan OpenTelemetry metrik dan jejak, tambahkan otlp bagian ke file konfigurasi CloudWatch agen. Bagian ini memiliki bidang berikut:

  • grpc_endpoint – Opsional. Menentukan alamat CloudWatch agen yang akan digunakan untuk mendengarkan OpenTelemetry metrik atau jejak yang dikirim menggunakan Panggilan Prosedur Jarak Jauh gRPC. Formatnya adalah ip:port. Alamat ini harus sesuai dengan alamat yang ditetapkan untuk pengekspor gRPC di OpenTelemetry SDK. Jika Anda menghilangkan bidang ini, 127.0.0.1:4317 default akan digunakan.

  • http_endpoint – Opsional. Menentukan alamat CloudWatch agen yang akan digunakan untuk mendengarkan OpenTelemetry metrik atau jejak yang dikirim melalui HTTP. Formatnya adalah ip:port. Alamat ini harus sesuai dengan alamat yang ditetapkan untuk eksportir HTTP di OpenTelemetry SDK. Jika Anda menghilangkan bidang ini, 127.0.0.1:4318 default akan digunakan.

  • tls – Opsional. Menentukan bahwa server harus dikonfigurasi dengan TLS.

    • cert_file— Jalur ke sertifikat TLS untuk digunakan untuk koneksi yang diperlukan TLS.

    • key_file— Jalur ke kunci TLS untuk digunakan untuk koneksi yang diperlukan TLS.

otlpBagian ini dapat ditempatkan di beberapa bagian dalam file konfigurasi CloudWatch agen tergantung pada bagaimana dan di mana Anda ingin mengirim metrik dan jejak.

penting

Setiap otlp bagian membutuhkan titik akhir dan port yang unik. Untuk informasi terperinci tentang pemisahan metrik dan titik akhir pelacakan, lihat Konfigurasi Eksportir OTLP di dokumentasi OpenTelemetry SDK.

Untuk mengirim metrik ke CloudWatch atau Layanan Terkelola Amazon untuk Prometheus, tambahkan otlp bagian di bawah bagian tersebutmetrics_collected. metrics Untuk informasi selengkapnya tentang mengirim metrik ke tujuan yang berbeda, lihatMembuat atau mengedit file konfigurasi CloudWatch agen secara manual. Contoh berikut menunjukkan konfigurasi yang mengirimkan metrik ke CloudWatch:

catatan

Jika Anda menjalankan agen di lingkungan kontainer dan mengirim telemetri dari luar jaringan wadah agen, pastikan untuk menentukan titik akhir sebagai alih- 0.0.0.0 alih titik akhir default. 127.0.0.1

{
  "metrics": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Untuk mengirim metrik ke Amazon CloudWatch Logs menggunakan format metrik tertanam (EMF), tambahkan otlp bagian di bawah metrics_collected logs bagian tersebut. Ini mengirimkan log EMF secara default ke grup /aws/cwagent log dan aliran log yang dihasilkan. Metrik diekstraksi ke dalam CWAgent namespace secara default. Contoh berikut menunjukkan konfigurasi yang mengirimkan metrik sebagai log EMF ke CloudWatch Log:

{
  "logs": {
    "metrics_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}

Untuk mengirim jejak ke AWS X-Ray, tambahkan otlp bagian di bawah traces_collected dalam traces bagian. Contoh berikut menunjukkan konfigurasi yang mengirimkan jejak ke X-Ray:

{
  "traces": {
    "traces_collected": {
      "otlp": {
        "grpc_endpoint": "127.0.0.1:4317",
        "http_endpoint": "127.0.0.1:4318"
      }
    }
  }
}