View a markdown version of this page

Integrasikan OpenSearch Layanan Amazon - Amazon CloudWatch
PrasyaratLangkah 1: Konfigurasikan konfigurasi scrapeLangkah 2: Buat scraperMetrik yang tersediaValidasi koleksi metrikCross-account observabilitasBatasan saat ini

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

Integrasikan OpenSearch Layanan Amazon

Dengan kolektor Prometheus yang CloudWatch dikelola Amazon, Anda dapat secara otomatis mengumpulkan metrik yang Prometheus kompatibel dari domain Layanan Amazon Anda. OpenSearch Kolektor terkelola terhubung ke VPC Anda, mengumpulkan metrik cluster, node, dan indeks dari domain, dan mengirimkan metrik ini langsung ke CloudWatch. Dengan integrasi ini, Anda dapat memantau kesehatan dan kinerja domain Anda CloudWatch tanpa menggunakan agen atau eksportir apa pun.

catatan

Saat kolektor Prometheus yang CloudWatch dikelola Amazon mengirimkan metrik OpenSearch Layanan Amazon Anda ke CloudWatch, metrik tersebut secara otomatis memperkaya setiap metrik dengan atribut yang mengidentifikasi asalnya. Setiap metrik membawa lingkup instrumentasi kolektor, atribut cloud yang merekam AWS akun dan Wilayah, dan unit yang disimpulkan kolektor dari nama metrik. Anda dapat memfilter dan mengelompokkan atribut ini saat menanyakan metrik Anda dengan PromQL.

Prasyarat

Prosedur ini mengasumsikan bahwa Anda terbiasa dengan administrasi domain OpenSearch Layanan Amazon dan konsep jaringan Amazon VPC.

  • Domain OpenSearch Layanan Amazon dengan akses VPC. Kolektor terkelola hanya mendukung domain yang memiliki akses VPC. Domain dengan akses publik tidak didukung.

  • Setidaknya dua subnet di Zona Ketersediaan yang berbeda

  • Aturan grup keamanan yang memungkinkan kolektor mencapai titik akhir domain Anda melalui HTTPS (port 443). Tambahkan aturan masuk ke grup keamanan domain yang memungkinkan lalu lintas HTTPS dari grup keamanan yang Anda sediakan untuk kolektor.

Langkah 1: Konfigurasikan konfigurasi scrape

Berikut ini adalah contoh konfigurasi scrape untuk Amazon OpenSearch Service. Kolektor terkelola terhubung ke domain yang Anda tentukan dan mengumpulkan metriknya secara otomatis, sehingga Anda tidak menentukan target pengikisan dalam konfigurasi. Konfigurasi harus menyertakan scrape_configs bagian dengan pekerjaan job_name yang persisopensearch-exporter. Anda mereferensikan konfigurasi ini saat Anda membuat scraper di langkah berikutnya. Untuk informasi selengkapnya tentang opsi konfigurasi, lihatKonfigurasi scraper.

global:
  external_labels:
    domain_name: my-opensearch-domain

scrape_configs:
  - job_name: opensearch-exporter
    scrape_interval: 60s

Langkah 2: Buat scraper

Buat scraper dengan CloudWatch tujuan. Anda menentukan domain yang akan dikumpulkan di exporters lapangan, dan menyediakan jaringan (subnet dan grup keamanan) di source lapangan.

AWS API

Gunakan operasi CreateScraper API untuk membuat scraper dengan CloudWatch tujuan. Ganti informasi subnet, grup keamanan, domain, dan dataset dengan nilai Anda sendiri.

POST /scrapers HTTP/1.1

{
  "alias": "opensearch-metrics-scraper",
  "source": {
    "vpcConfiguration": {
      "subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"],
      "securityGroupIds": ["sg-security-group-id"]
    }
  },
  "exporters": [
    {
      "openSearchConfiguration": {
        "domainArn": "arn:aws:es:us-west-2:123456789012:domain/my-opensearch-domain"
      }
    }
  ],
  "destination": {
    "cloudWatchConfiguration": {
      "datasetArn": "arn:aws:cloudwatch:us-west-2:123456789012:dataset/default"
    }
  },
  "scrapeConfiguration": {
    "configurationBlob": "base64-encoded-blob"
  }
}
AWS CLI

Gunakan create-scraper perintah untuk membuat scraper dengan CloudWatch tujuan. Ganti informasi subnet, grup keamanan, domain, dan dataset dengan nilai Anda sendiri.

aws amp create-scraper \
  --alias "opensearch-metrics-scraper" \
  --source '{
    "vpcConfiguration": {
      "subnetIds": ["subnet-subnet-id-1", "subnet-subnet-id-2"],
      "securityGroupIds": ["sg-security-group-id"]
    }
  }' \
  --exporters '[
    {
      "openSearchConfiguration": {
        "domainArn": "arn:aws:es:us-west-2:123456789012:domain/my-opensearch-domain"
      }
    }
  ]' \
  --scrape-configuration configurationBlob=$(base64 -w 0 opensearch-config.yaml) \
  --destination '{
    "cloudWatchConfiguration": {
      "datasetArn": "arn:aws:cloudwatch:us-west-2:123456789012:dataset/default"
    }
  }'

Metrik yang tersedia

  • Metrik cluster — Kesehatan dan status cluster, jumlah node dan node data, pecahan aktif dan relokasi, dan tugas yang tertunda.

  • Metrik node — Penggunaan CPU, penggunaan tumpukan JVM dan pengumpulan sampah, memori sistem operasi, penggunaan disk, dan aktivitas kumpulan utas untuk setiap node.

  • Metrik indeks — Tingkat pengindeksan dan penelusuran dan latensi, jumlah dokumen, aktivitas penggabungan dan penyegaran, dan penggunaan cache.

Untuk daftar lengkap metrik yang tersedia, lihat Met rik yang dikumpulkan dari OpenSearch Layanan Amazon di Panduan Pengguna Layanan Terkelola Amazon untuk Prometheus.

Validasi koleksi metrik

Untuk mengonfirmasi bahwa kolektor mengirimkan metrik dari domain Anda, jalankan kueri berikut CloudWatch dengan Query Studio. Kueri mengembalikan status kesehatan cluster untuk domain Anda. Jika mengembalikan titik data, kolektor berhasil mengumpulkan metrik dari domain Anda.

opensearch_cluster_health_status

Cross-account observabilitas

Untuk pemantauan OpenSearch Layanan Amazon lintas akun, sebaiknya gunakan sentralisasi CloudWatch metrik Amazon. Untuk informasi selengkapnya, lihat sentralisasi CloudWatch metrik.

Untuk informasi selengkapnya tentang konfigurasi scraper lintas-akun alternatif menggunakan rantai peran, lihat Meng integrasikan OpenSearch Layanan Amazon di Panduan Pengguna Layanan Terkelola Amazon untuk Prometheus.

Batasan saat ini

  • Kolektor terkelola hanya mendukung domain dengan akses VPC.

  • Scraper mengumpulkan metrik dari satu domain OpenSearch Layanan Amazon. Untuk mengumpulkan metrik dari lebih dari satu domain, buat scraper terpisah untuk setiap domain.