Hubungkan ke sumber data default dengan sebuah pemandu

Topik ini memberikan instruksi untuk menggunakan wizard untuk terhubung CloudWatch ke sumber data berikut.

• OpenSearch Layanan Amazon

• Layanan Terkelola Amazon untuk Prometheus

• Amazon RDS for MySQL

• Amazon RDS for PostgreSQL

• Berkas CSV Amazon S3

• Monitor Microsoft Azure

• Prometheus

Kemudian di bagian ini adalah subbagian dengan catatan tentang mengelola dan menjalankan kueri dengan masing-masing sumber data ini.

Untuk membuat sebuah konektor ke sumber data

1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

2. Pada panel navigasi, silakan pilih Pengaturan.

3. Pilih tab Sumber data metrik.

4. Pilih Buat sumber data.

5. Pilih sumber yang Anda inginkan, lalu pilih Berikutnya.

6. Masukkan sebuah nama untuk sumber data.

7. Masukkan informasi lain yang diperlukan, tergantung pada sumber data yang Anda pilih. Ini dapat mencakup kredensial untuk mengakses sumber data tersebut dan sumber data yang mengidentifikasi informasi seperti nama workspace Prometheus, nama basis data, atau nama bucket Amazon S3. Untuk AWS layanan, wizard menemukan sumber daya dan mengisinya ke dalam pilihan dropdown.

   Untuk catatan lebih lanjut tentang sumber data yang Anda gunakan, silakan lihat bagian setelah prosedur ini.

8. Untuk CloudWatch terhubung ke sumber data dalam VPC, pilih Gunakan VPC dan pilih VPC yang akan digunakan. Kemudian pilih subnet dan grup keamanan.

9. Pilih Saya mengakui yang AWS CloudFormation akan membuat sumber daya IAM. Sumber daya ini adalah peran eksekusi fungsi Lambda.

10. Pilih Buat sumber data.

    Sumber baru yang baru saja Anda tambahkan tidak muncul sampai AWS CloudFormation tumpukan selesai membuatnya. Untuk memeriksa kemajuan, Anda dapat memilih Lihat status CloudFormation tumpukan saya. Atau Anda dapat memilih ikon muat ulang untuk memperbarui daftar ini.

    Ketika sumber data baru Anda muncul dalam daftar ini, sumber data siap digunakan. Anda dapat memilih Kueri dari CloudWatch metrik untuk memulai kueri dengannya. Untuk informasi selengkapnya, lihat Membuat sebuah grafik metrik dari sumber data lain.

Layanan Terkelola Amazon untuk Prometheus

Memperbarui konfigurasi sumber data

• Anda dapat memperbarui sumber data Anda secara manual dengan melakukan hal berikut:

  • Untuk memperbarui ID workspace Layanan Terkelola Amazon untuk Prometheus, perbarui variabel lingkungan AMAZON_PROMETHEUS_WORKSPACE_ID untuk sumber data konektor fungsi Lambda.

  • Untuk memperbarui konfigurasi VPC, silakan lihat Mengonfigurasi akses VPC (konsol) untuk informasi selengkapnya.

Menjalankan kueri sumber data

• Saat menjalankan kueri Layanan Terkelola Amazon untuk Prometheus, setelah Anda memilih sumber datanya di tab kueri multi sumber dan memilih sebuah konektor Layanan Terkelola Amazon untuk Prometheus, Anda dapat menggunakan alat bantu Kueri untuk menemukan metrik dan melabelinya dan menyediakan kueri PromQL yang sederhana. Anda juga dapat menggunakan editor kueri PromQL untuk membangun sebuah kueri PromQL.

• Kueri multi-baris tidak didukung oleh konektor sumber CloudWatch data. Setiap umpan baris digantikan dengan sebuah ruang saat kueri dijalankan, atau saat Anda membuat sebuah alarm atau widget dasbor dengan kuerinya. Dalam beberapa kasus, ini mungkin membuat kueri Anda tidak valid. Sebagai contoh, jika kueri Anda berisikan sebuah komentar satu baris, itu akan menjadi tidak valid. Jika Anda mencoba membuat dasbor atau alarm dengan kueri multi-baris dari baris perintah atau Infrastruktur sebagai Kode, API akan menolak tindakan tersebut dengan kesalahan penguraian.

OpenSearch Layanan Amazon

Membuat sumber data

Jika OpenSearch domain diaktifkan untuk FGAC, Anda harus memetakan peran eksekusi fungsi konektor Lambda ke pengguna di Layanan. OpenSearch Untuk informasi selengkapnya, lihat bagian Memetakan pengguna ke peran di Mengelola izin di dokumentasi OpenSearch Layanan.

Jika OpenSearch domain Anda hanya dapat diakses dalam Virtual Private Cloud (VPC), Anda perlu menyertakan variabel lingkungan baru secara manual dalam fungsi Lambda yang disebut. AMAZON_OPENSEARCH_ENDPOINT Nilai untuk variabel ini harus menjadi domain root dari OpenSearch titik akhir. Anda dapat memperoleh domain root ini dengan menghapus https:// dan <region>.es.amazonaws.com dari titik akhir domain yang tercantum di konsol OpenSearch Layanan. Misalnya, jika titik akhir domain Andahttps://sample-domain.us-east-1.es.amazonaws.com, domain root akan menjadisample-domain.

Memperbarui sumber data

• Anda dapat memperbarui sumber data Anda secara manual dengan melakukan hal berikut:

  • Untuk memperbarui domain OpenSearch Layanan, perbarui variabel AMAZON_OPENSEARCH_DOMAIN_NAME lingkungan untuk fungsi Lambda konektor sumber data.

  • Untuk memperbarui konfigurasi VPC, silakan lihat Mengonfigurasi akses VPC (konsol) untuk informasi selengkapnya.

Menjalankan kueri sumber data

• Saat menanyakan OpenSearch Layanan, setelah Anda memilih sumber data di tab Kueri multi sumber, lakukan hal berikut:

  • Pilih Indeks untuk kueri.

  • Pilih Nama metrik (Bidang numerik apa pun dalam dokumen) dan Stat.

  • Pilih sumbu Waktu (Bidang tanggal apa pun dalam dokumen).

  • Pilih Filter untuk diterapkan (Bidang String apa pun dalam dokumen).

  • Pilih kueri Grafik.

Amazon RDS for PostgreSQL dan Amazon RDS for MySQL

Membuat sumber data

• Jika sumber data Anda hanya dapat diakses dalam sebuah VPC, Anda harus memasukkan konfigurasi VPC untuk konektor, seperti yang dijelaskan dalam Hubungkan ke sumber data default dengan sebuah pemandu. Jika sumber data dihubungkan ke VPC untuk kredensial, titik akhirnya harus terkonfigurasi di VPC. Untuk informasi selengkapnya, lihat Menggunakan titik AWS Secrets Manager akhir VPC.

  Selain itu, Anda harus membuat titik akhir VPC untuk layanan Amazon RDS. Untuk informasi selengkapnya, lihat Amazon RDS API dan titik akhir AWS PrivateLink VPC antarmuka ().

Memperbarui sumber data

• Anda dapat memperbarui sumber data Anda secara manual dengan melakukan hal berikut:

  • Untuk memperbarui instans basis data, perbarui variabel lingkungan RDS_INSTANCE untuk sumber data konektor fungsi Lambda.

  • Untuk memperbarui nama pengguna dan kata sandi yang digunakan untuk terhubung ke Amazon RDS, gunakan AWS Secrets Manager. Anda dapat menemukan ARN dari yang rahasia yang digunakan untuk sumber data dalam variabel lingkungan RDS_SECRET pada sumber data fungsi Lambda. Untuk informasi selengkapnya tentang memperbarui rahasia di AWS Secrets Manager, silakan lihat Memodifikasi rahasia AWS Secrets Manager.

  • Untuk memperbarui konfigurasi VPC, silakan lihat Mengonfigurasi akses VPC (konsol) untuk informasi selengkapnya.

Menjalankan kueri sumber data

• Saat menjalankan kueri Amazon RDS, setelah memilih sumber data di tab Kueri multi sumber dan memilih sebuah konektor Amazon RDS, Anda dapat menggunakan penjelajah basis data untuk melihat basis data, tabel, dan kolom yang tersedia. Anda juga dapat menggunakan editor SQL untuk membuat sebuah kueri SQL.

  Anda dapat menggunakan variabel berikut dalam kueri:

  • $start.iso – Waktu mulai dalam format tanggal ISO

  • $end.iso – Waktu berakhir dalam format tanggal ISO

  • $period – Periode yang dipilih dalam hitungan detik

  Misalnya, Anda dapat menjalankan kueri SELECT value, timestamp FROM table WHERE timestamp BETWEEN $start.iso and $end.iso

• Kueri multi-baris tidak didukung oleh konektor sumber CloudWatch data. Setiap umpan baris digantikan dengan sebuah ruang saat kueri dijalankan, atau saat Anda membuat sebuah alarm atau widget dasbor dengan kuerinya. Dalam beberapa kasus, ini mungkin membuat kueri Anda tidak valid. Sebagai contoh, jika kueri Anda berisikan sebuah komentar satu baris, itu akan menjadi tidak valid. Jika Anda mencoba membuat dasbor atau alarm dengan kueri multi-baris dari baris perintah atau Infrastruktur sebagai Kode, API akan menolak tindakan tersebut dengan kesalahan penguraian.

catatan

Jika tidak ada bidang tanggal yang ditemukan dalam hasil, nilai untuk setiap bidang numerik akan dijumlahkan ke nilai tunggal dan diplot di seluruh rentang waktu yang tersedia. Jika stempel waktu tidak sejajar dengan periode yang dipilih CloudWatch, data secara otomatis digabungkan menggunakan SUM dan disejajarkan dengan periode di. CloudWatch

Berkas CSV Amazon S3

Menjalankan kueri sumber data

• Saat menjalankan kueri berkas CSV Amazon S3, setelah Anda memilih sumber data di tab Kueri multi sumber dan memilih sebuah konektor Amazon S3, pilih bucket dan kunci Amazon S3.

  File CSV harus diformat dengan cara berikut:

  • Cap waktu harus kolom pertama.

  • Tabel harus memiliki baris header. Header digunakan untuk memberi nama metrik Anda. Judul kolom stempel waktu akan diabaikan, hanya judul kolom metrik yang digunakan.

  • Perangko waktu harus dalam format tanggal ISO.

  • Metrik harus berupa bidang numerik.

  Timestamp, Metric-1, Metric-2, ...

  Berikut adalah contohnya:

  stempel waktu	(%) CPU	Memori (%)	Penyimpanan (%)
  2023-11-23T17:09:41+00:00	1	2	3
  2023-11-23T17:04:41+00:00	4	5	6
  2023-11-23T16:59:41+00:00	7	8	9
  2023-11-23T16:54:41+00:00	10	11	12

catatan

Jika tidak ada stempel waktu yang diberikan, nilai untuk setiap metrik akan dijumlahkan ke nilai-nilai tunggal dan diplot di seluruh rentang waktu yang disediakan. Jika stempel waktu tidak sejajar dengan periode yang dipilih CloudWatch, data secara otomatis digabungkan menggunakan SUM dan disejajarkan dengan periode di. CloudWatch

Monitor Microsoft Azure

Membuat sumber data

• Anda harus memberikan ID penyewa, ID klien, dan rahasia klien Anda untuk terhubung ke Monitor Microsoft Azure. Kredensialnya akan disimpan di. AWS Secrets Manager Untuk informasi selengkapnya, silakan lihat Membuat sebuah aplikasi Microsoft Entra dan pengguna utama layanan yang dapat mengakses sumber daya dalam dokumentasi Microsoft.

Memperbarui sumber data

• Anda dapat memperbarui sumber data Anda secara manual dengan melakukan hal berikut:

  • Untuk memperbarui ID penyewa, ID klien, dan rahasia klien yang digunakan untuk terhubung ke Azure Monitor, Anda dapat menemukan ARN yang rahasianya digunakan untuk sumber data sebagai variabel lingkungan AZURE_CLIENT_SECRET pada sumber data fungsi Lambda. Untuk informasi selengkapnya tentang memperbarui rahasia AWS Secrets Manager, lihat Memodifikasi AWS Secrets Manager rahasia.

Menjalankan kueri sumber data

• Saat menjalankan kueri Azure Monitor, setelah Anda memilih sumber data di tab Kueri multi sumber dan memilih sebuah konektor Azure Monitor, tentukan langganan Azure, dan grup sumber daya serta sumber daya. Anda kemudian dapat memilih namespace metrik, metrik, dan agregasi, dan memfilter berdasarkan dimensi.

Prometheus

Membuat sumber data

• Anda harus memberikan titik akhir Prometheus dan pengguna serta kata sandi yang diperlukan untuk menjalankan kueri Prometheus. Kredensialnya akan disimpan di. AWS Secrets Manager

• Jika sumber data Anda hanya dapat diakses dalam sebuah VPC, Anda harus memasukkan konfigurasi VPC untuk konektor, seperti yang dijelaskan dalam Hubungkan ke sumber data default dengan sebuah pemandu. Jika sumber data adalah untuk menghubungkan untuk kredensial, titik akhir harus dikonfigurasi dalam VPC. Untuk informasi selengkapnya, lihat Menggunakan titik AWS Secrets Manager akhir VPC.

Memperbarui konfigurasi sumber data

• Anda dapat memperbarui sumber data Anda secara manual dengan melakukan hal berikut:

  • Untuk memperbarui titik akhir Prometheus, tentukan titik akhir yang baru sebagai variabel lingkungan PROMETHEUS_API_ENDPOINT pada sumber data fungsi Lambda.

  • Untuk memperbarui nama pengguna dan kata sandi yang digunakan untuk terhubung ke Prometheus, Anda dapat menemukan ARN dari rahasia yang digunakan untuk sumber data sebagai variabel lingkungan PROMETHEUS_API_SECRET pada sumber data fungsi Lambda. Untuk informasi selengkapnya tentang memperbarui rahasia AWS Secrets Manager, lihat Memodifikasi AWS Secrets Manager rahasia.

  • Untuk memperbarui konfigurasi VPC, silakan lihat Mengonfigurasi akses VPC (konsol) untuk informasi selengkapnya.

Menjalankan kueri sumber data

penting

Jenis metrik Prometheus berbeda CloudWatch dari metrik dan banyak metrik yang tersedia melalui Prometheus bersifat kumulatif berdasarkan desain. Saat Anda menanyakan metrik Prometheus CloudWatch , tidak menerapkan transformasi tambahan apa pun ke data: jika Anda hanya menentukan nama atau label metrik, nilai yang ditampilkan akan bersifat kumulatif. Untuk informasi selengkapnya, silakan lihat Jenis-jenis metrik dalam dokumentasi Prometheus.

Untuk melihat data metrik Prometheus sebagai nilai diskrit, CloudWatch seperti metrik, Anda perlu mengedit kueri sebelum menjalankannya. Misalnya, Anda mungkin perlu menambahkan sebuah panggilan ke fungsi tarif di atas nama metrik Prometheus Anda. Untuk dokumentasi tentang fungsi rate dan fungsi Prometheus lainnya, silakan lihat rate () dalam dokumentasi Prometheus.

Kueri multi-baris tidak didukung oleh konektor sumber CloudWatch data. Setiap umpan baris digantikan dengan sebuah ruang saat kueri dijalankan, atau saat Anda membuat sebuah alarm atau widget dasbor dengan kuerinya. Dalam beberapa kasus, ini mungkin membuat kueri Anda tidak valid. Sebagai contoh, jika kueri Anda berisikan sebuah komentar satu baris, itu akan menjadi tidak valid. Jika Anda mencoba membuat dasbor atau alarm dengan kueri multi-baris dari baris perintah atau Infrastruktur sebagai Kode, API akan menolak tindakan tersebut dengan kesalahan penguraian.

Notifikasi Pembaruan yang Tersedia

Dari waktu ke waktu, Amazon mungkin akan memberi tahu Anda bahwa kami menyarankan Anda memperbarui konektor Anda dengan versi yang lebih baru yang tersedia dan akan memberikan instruksi tentang cara melakukannya.