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

Menyiapkan konsumsi metrik menggunakan AWS Distro untuk OpenTelemetry di cluster Layanan Kubernetes Amazon Elastic

Anda dapat menggunakan pengumpul AWS Distro for OpenTelemetry (ADOT) untuk mengikis metrik dari Prometheus-instrumented aplikasi, dan mengirim metrik ke Amazon Managed Service for Prometheus.

Mengumpulkan metrik Prometheus dengan ADOT melibatkan tiga OpenTelemetry komponen: Penerima Prometheus, Eksportir Penulisan Jarak Jauh Prometheus, dan Ekstensi Otentikasi Sigv4.

Anda dapat mengonfigurasi Penerima Prometheus menggunakan konfigurasi Prometheus yang ada untuk melakukan penemuan layanan dan pengikisan metrik. Penerima Prometheus mengikis metrik dalam format eksposisi Prometheus. Setiap aplikasi atau titik akhir yang ingin Anda gores harus dikonfigurasi dengan pustaka klien Prometheus. Penerima Prometheus mendukung set lengkap konfigurasi pengikisan dan pelabelan ulang Prometheus yang dijelaskan dalam Konfigurasi dalam dokumentasi Prometheus. https://prometheus.io/docs/prometheus/latest/configuration/configuration/ Anda dapat menempelkan konfigurasi ini langsung ke konfigurasi ADOT Collector Anda.

Eksportir Penulisan Jarak Jauh Prometheus menggunakan remote_write titik akhir untuk mengirim metrik yang tergores ke ruang kerja portal manajemen Anda. Permintaan HTTP untuk mengekspor data akan ditandatangani dengan AWS SIGv4, AWS protokol untuk otentikasi aman, dengan Ekstensi Otentikasi Sigv4. Untuk informasi selengkapnya, lihat proses penandatanganan Signature Version 4.

<kubernetes_sd_config>Kolektor secara otomatis menemukan titik akhir metrik Prometheus di Amazon EKS dan menggunakan konfigurasi yang ditemukan di. https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config

Demo berikut adalah contoh konfigurasi ini pada cluster yang menjalankan Amazon Elastic Kubernetes Service atau Kubernetes yang dikelola sendiri. Untuk melakukan langkah-langkah ini, Anda harus memiliki AWS kredenSIAL dari salah satu opsi potensial dalam rantai AWS kredenSIAL default. Untuk informasi selengkapnya, lihat Mengonfigurasi AWS SDK untuk Go. Demo ini menggunakan contoh aplikasi yang digunakan untuk pengujian integrasi proses. Aplikasi sampel mengekspos metrik di /metrics titik akhir, seperti pustaka klien Prometheus.

Prasyarat

Sebelum memulai langkah-langkah pengaturan penyerapan berikut, Anda harus mengatur peran IAM untuk akun layanan dan kebijakan kepercayaan.

Mengaktifkan pengumpulan metrik Prometheus

Membersihkan

Untuk membersihkan demo ini, masukkan perintah berikut.

kubectl delete namespace aoc-prometheus-pipeline-demo
kubectl delete namespace adot-col

Konfigurasi lanjutan

Penerima Prometheus mendukung set lengkap konfigurasi pengikisan dan pelabelan ulang Prometheus yang dijelaskan dalam Konfigurasi dalam dokumentasi Prometheus. https://prometheus.io/docs/prometheus/latest/configuration/configuration/ Anda dapat menempelkan konfigurasi ini langsung ke konfigurasi ADOT Collector Anda.

Konfigurasi untuk Penerima Prometheus mencakup penemuan layanan Anda, konfigurasi pengikisan, dan konfigurasi pelabelan ulang. Konfigurasi penerima terlihat seperti berikut ini.

receivers:
  prometheus:
    config:
      [[Your Prometheus configuration]]

Berikut ini adalah contoh konfigurasi.

receivers:
  prometheus:
    config:
      global:
        scrape_interval: 1m
        scrape_timeout: 10s
        
      scrape_configs:
      - job_name: kubernetes-service-endpoints
        sample_limit: 10000
        kubernetes_sd_configs:
        - role: endpoints
        tls_config:
          ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
          insecure_skip_verify: true
        bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token

Jika Anda memiliki konfigurasi Prometheus yang ada, Anda harus mengganti $ karakter dengan $$ untuk menghindari nilai diganti dengan variabel lingkungan. *Hal ini sangat penting untuk nilai penggantian relabel_configuration. Misalnya, jika Anda mulai dengan relabel_configuration berikut:

relabel_configs:
- source_labels: [__meta_kubernetes_ingress_scheme,__address__,__meta_kubernetes_ingress_path]
  regex: (.+);(.+);(.+)
  replacement: ${1}://${2}${3}
  target_label: __param_target

Ini akan menjadi sebagai berikut:

relabel_configs:
- source_labels: [__meta_kubernetes_ingress_scheme,__address__,__meta_kubernetes_ingress_path]
  regex: (.+);(.+);(.+)
  replacement: $${1}://${2}${3}
  target_label: __param_target

Eksportir penulisan jarak jauh Prometheus dan ekstensi otentikasi Sigv4

Konfigurasi untuk Eksportir Penulisan Jarak Jauh Prometheus dan Ekstensi Otentikasi Sigv4 lebih sederhana daripada penerima Prometheus. Pada tahap proses ini, metrik telah dicerna, dan kami siap untuk mengekspor data ini ke Amazon Managed Service for Prometheus. Persyaratan minimum untuk konfigurasi yang berhasil untuk berkomunikasi dengan Amazon Managed Service for Prometheus ditunjukkan dalam contoh berikut.

extensions:
  sigv4auth:
    service: "aps"
    region: "user-region"
exporters:
  prometheusremotewrite:
    endpoint: "https://aws-managed-prometheus-endpoint/api/v1/remote_write"
    auth:
      authenticator: "sigv4auth"

Konfigurasi ini mengirimkan permintaan HTTPS yang ditandatangani oleh AWS SIGv4 menggunakan AWS kredenSIAL dari rantai kre AWS denSIAL default. Untuk informasi selengkapnya, lihat Mengonfigurasi AWS SDK untuk Go. Anda harus menentukan layanan yang akan dilakukanaps.

Terlepas dari metode penerapannya, kolektor ADOT harus memiliki akses ke salah satu opsi yang tercantum dalam rantai AWS kredenSIAL default. Ekstensi Otentikasi Sigv4 bergantung pada AWS SDK untuk Go dan menggunakannya untuk mengambil kredenSIAL dan mengotentikasi. Anda harus memastikan bahwa kredenSIAL ini memiliki izin penulisan jarak jauh untuk Amazon Managed Service for Prometheus.