View a markdown version of this page

Membuat jaringan pipa - Amazon CloudWatch
Membuat pipa logMembuat pipeline metrik

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

Membuat jaringan pipa

CloudWatch pipelines mendukung pembuatan pipeline untuk data log dan metrik. Bagian berikut menjelaskan cara membuat setiap jenis pipa.

Membuat pipa log

Wizard konfigurasi pipeline memandu Anda membuat pipeline data log Anda.

  1. Di bawah Pengaturan umum, berikan detail sumber data termasuk nama dan jenis sumber. Anda juga dapat menentukan tag pipeline dan nama pipeline Anda.

  2. Di bawah Tujuan, tentukan detail tujuan. Untuk jalur pipa log, CloudWatch Log adalah satu-satunya tujuan yang didukung. Untuk pipeline metrik, CloudWatch Metrik adalah satu-satunya tujuan yang didukung.

  3. Di bawah Processor, tambahkan prosesor dan parser yang diinginkan. Parser adalah langkah pertama yang diperlukan untuk tipe data tertentu. Anda dapat melakukan parsing khusus menggunakan prosesor seperti Grok atau CSV. Anda dapat menggunakan prosesor pencarian untuk memperkaya peristiwa log dengan data dari tabel pencarian Amazon CloudWatch Logs. Prosesor yang tidak didukung oleh tipe data dinonaktifkan.

    Untuk mengkonfigurasi prosesor menggunakan bahasa alami, aktifkan AI-assistedsakelar. Masukkan deskripsi transformasi log yang Anda butuhkan, dan CloudWatch saluran pipa menghasilkan konfigurasi prosesor secara otomatis. Untuk log AWS vended, contoh peristiwa log juga dibuat sehingga Anda dapat memverifikasi output sebelum menerapkan. Anda dapat meninjau dan mengedit konfigurasi yang dihasilkan sebelum membuat pipeline.

    penting

    Untuk menggunakan konfigurasi AI-assisted prosesor, Anda harus memiliki izin logs:GeneratePipeline IAM. Untuk informasi selengkapnya, lihat AI-assisted izin konfigurasi prosesor.

    Anda juga dapat menambahkan aturan pemrosesan bersyarat ke prosesor yang didukung menggunakan when parameter. Pemrosesan bersyarat memungkinkan Anda mengontrol entri log mana yang digunakan prosesor. Untuk sintaks ekspresi dan prosesor yang didukung, lihatSintaks ekspresi untuk pemrosesan bersyarat.

    Untuk menyimpan salinan data log Anda yang tidak dimodifikasi untuk tujuan audit atau kepatuhan, aktifkan sakelar Simpan log asli. Saat diaktifkan, CloudWatch pipeline secara otomatis menyimpan salinan dari setiap peristiwa log mentah sebelum transformasi apa pun terjadi di bidang @original_message sistem acara. Ini memastikan bahwa data asli selalu tersedia untuk audit atau investigasi, bahkan setelah prosesor memodifikasi peristiwa log. Toggle Keep original log hanya tersedia untuk pipeline dengan sumber log CloudWatch vended.

  4. Di bawah Tinjau dan buat, tinjau konfigurasi pipeline. Jika Anda puas dengan konfigurasi, pilih Buat pipeline untuk memulai penerapan dan pembuatan sumber daya pipeline. Penyelesaian pembuatan pipa membutuhkan waktu hingga 5 menit tergantung pada jenis sumbernya. Setelah selesai, Anda akan dibawa ke tab Pipelines di Konsol Ingestion.

penting

Konfigurasi prosesor saluran pipa dicatat dalam AWS CloudTrail peristiwa untuk tujuan audit dan kepatuhan. Untuk melindungi informasi sensitif, jangan sertakan kata sandi, kunci API, atau informasi sensitif lainnya dalam konfigurasi prosesor.

Membuat pipeline metrik

Anda dapat membuat pipeline metrik dengan menggunakan CloudWatch konsol atau AWS CLI. Dengan pipeline metrik, Anda dapat memproses data CloudWatch metrik, menerapkan transformasi, dan meneruskan metrik yang diproses. CloudWatch

Untuk membuat pipeline metrik (konsol)

Gunakan prosedur berikut untuk membuat pipeline metrik di CloudWatch konsol.

  1. Buka CloudWatch konsol dan di panel navigasi, pilih Ingestion, Pipelines.

  2. Pilih Buat pipeline.

  3. Untuk jenis sumber, pilih CloudWatch Metrik (OTel).

  4. Konfigurasikan kriteria pemilihan untuk menentukan metrik mana yang diproses pipa. Kriteria seleksi menggunakan jalur atribut OTel sepertiresource.attributes,metric.name, dandatapoint.attributes. Semua kriteria menggunakan DAN semantik (semua harus cocok).

  5. Di bawah Processor, tambahkan hingga 20 prosesor untuk mengubah data metrik Anda.

  6. Di bawah Tinjau dan buat, tinjau konfigurasi pipeline dan pilih Buat pipeline.

Untuk membuat pipeline metrik (AWS CLI)

Gunakan create-telemetry-pipeline perintah untuk membuat pipeline metrik dari AWS CLI.

aws observabilityadmin create-telemetry-pipeline \
    --pipeline-configuration-body file://config.yaml

Contoh berikut menunjukkan file konfigurasi YAMAL yang mendefinisikan pipeline metrik dengan sumber, prosesor, dan sink.

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "payment-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}

Ketika pipeline dibuat, ia mengembalikan ARN dalam format berikut:

arn:aws:observabilityadmin:region:accountId:telemetry-pipeline/pipelineID
catatan

CloudWatch Metrik adalah satu-satunya tujuan yang didukung untuk jaringan pipa metrik.

Operasi API yang didukung

Tabel berikut mencantumkan operasi API yang dapat Anda gunakan untuk mengelola pipeline metrik.

Operasi Deskripsi
CreateTelemetryPipeline Membuat pipeline metrik baru.
GetTelemetryPipeline Mengambil detail tentang pipeline metrik tertentu.
ListTelemetryPipelines Daftar semua pipeline metrik di akun Anda.
DeleteTelemetryPipeline Menghapus pipeline metrik.
ValidateTelemetryPipelineConfiguration Memvalidasi konfigurasi pipeline sebelum pembuatan.
UpdateTelemetryPipeline Memperbarui konfigurasi pipeline metrik yang ada.