Publikasikan CloudWatch metrik Amazon ke file CSV - AWS Prescriptive Guidance
RingkasanPrasyarat dan batasanAlatEpikSumber daya terkaitInformasi tambahanLampiran

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

Publikasikan CloudWatch metrik Amazon ke file CSV

Abdullahi Olaoye, Amazon Web Services

Ringkasan

Pola ini menggunakan skrip Python untuk mengambil metrik CloudWatch Amazon dan mengonversi informasi metrik menjadi file nilai yang dipisahkan koma (CSV) untuk meningkatkan keterbacaan. Skrip mengambil layanan AWS yang metriknya harus diambil sebagai argumen yang diperlukan. Anda dapat menentukan profil kredensi AWS Region dan AWS sebagai argumen opsional. Jika Anda tidak menentukan argumen tersebut, skrip menggunakan Region default dan profil yang dikonfigurasi untuk workstation tempat skrip dijalankan. Setelah skrip berjalan, ia menghasilkan dan menyimpan file CSV di direktori yang sama.

Lihat bagian Lampiran untuk skrip dan file terkait yang disediakan dengan pola ini.

Prasyarat dan batasan

Prasyarat

  • Python 3.x

  • Antarmuka Baris Perintah AWS (AWS CLI)

Batasan

Skrip saat ini mendukung layanan AWS berikut:

  • AWS Lambda

  • Awan Komputasi Elastis Amazon (Amazon EC2)

    • Secara default, skrip tidak mengumpulkan metrik volume Amazon Elastic Block Store (Amazon EBS). Untuk mengumpulkan metrik Amazon EBS, Anda harus memodifikasi file terlampirmetrics.yaml.

  • Amazon Relational Database Service (Amazon RDS)

    • Namun, skrip tidak mendukung Amazon Aurora.

  • Penyeimbang Beban Aplikasi

  • Penyeimbang Beban Jaringan

  • Amazon API Gateway

Alat

  • Amazon CloudWatch adalah layanan pemantauan yang dibangun untuk DevOps insinyur, pengembang, insinyur keandalan situs (SREs), dan manajer TI. CloudWatch menyediakan data dan wawasan yang dapat ditindaklanjuti untuk membantu Anda memantau aplikasi Anda, menanggapi perubahan kinerja di seluruh sistem, mengoptimalkan pemanfaatan sumber daya, dan mendapatkan pandangan terpadu tentang kesehatan operasional. CloudWatch mengumpulkan data pemantauan dan operasional dalam bentuk log, metrik, dan peristiwa, serta memberikan tampilan terpadu tentang sumber daya, aplikasi, dan layanan AWS yang berjalan di AWS dan server lokal.

Epik

TugasDeskripsiKeterampilan yang dibutuhkan

Instal prasyarat.

Jalankan perintah berikut:

$ pip3 install -r requirements.txt
Developer

Mengonfigurasi AWS CLI.

Jalankan perintah berikut: 

$ aws configure
Developer
TugasDeskripsiKeterampilan yang dibutuhkan

Buka naskahnya.

Untuk mengubah konfigurasi default skrip, bukametrics.yaml.

Developer

Atur periode untuk skrip.

Ini adalah periode waktu untuk mengambil. Periode default adalah 5 menit (300 detik). Anda dapat mengubah periode waktu, tetapi perhatikan batasan berikut: 

  • Jika nilai jam yang Anda tentukan adalah antara 3 jam dan 15 hari yang lalu, gunakan kelipatan 60 detik (1 menit) untuk periode tersebut. 

  • Jika nilai jam yang Anda tentukan adalah antara 15 jam dan 63 hari yang lalu, gunakan kelipatan 300 detik (5 menit) untuk periode tersebut. 

  • Jika nilai jam yang Anda tentukan lebih besar dari 63 hari yang lalu, gunakan kelipatan 3.600 detik (1 jam) untuk periode tersebut.

Jika tidak, operasi API tidak akan mengembalikan titik data apa pun.

Developer

Atur jam untuk skrip.

Nilai ini menentukan berapa jam metrik yang ingin Anda ambil. Pengaturan default-nya adalah 1 jam. Untuk mengambil beberapa hari metrik, berikan nilai dalam jam. Misalnya, selama 2 hari, tentukan 48.

Developer

Ubah nilai statistik untuk skrip.

(Opsional) Nilai statistik global adalahAverage, yang digunakan saat mengambil metrik yang tidak memiliki nilai statistik tertentu yang ditetapkan. Skrip mendukung nilai statistikMaximum,SampleCount, danSum.

Developer
TugasDeskripsiKeterampilan yang dibutuhkan

Jalankan penulisan.

Gunakan perintah berikut ini. 

$ python3 cwreport.py <service>

Untuk melihat daftar nilai layanan dan opsional region dan profile parameter, jalankan perintah berikut:

 $ python3 cwreport.py -h

Untuk informasi selengkapnya tentang parameter opsional, lihat bagian Informasi tambahan.

Developer

Sumber daya terkait

Informasi tambahan

Penggunaan skrip

$ python3 cwreport.py -h

Contoh sintaks

python3 cwreport.py <service> <--region=Optional Region> <--profile=Optional credential profile>

Parameter

  • layanan (wajib) - Layanan yang ingin Anda jalankan skrip. Skrip saat ini mendukung layanan ini: AWS Lambda, Amazon, EC2 Amazon RDS, Application Load Balancer, Network Load Balancer, dan API Gateway.

  • region (opsional) - Wilayah AWS untuk mengambil metrik. Wilayah default adalahap-southeast-1.

  • profil (opsional) - Profil bernama AWS CLI untuk digunakan. Jika parameter ini tidak ditentukan, profil kredensi default yang dikonfigurasi akan digunakan.

Contoh

  • Untuk menggunakan Region default ap-southeast-1 dan kredensional yang dikonfigurasi default untuk mengambil metrik Amazon EC2 : $ python3 cwreport.py ec2

  • Untuk menentukan Wilayah dan mengambil metrik API Gateway: $ python3 cwreport.py apigateway --region us-east-1

  • Untuk menentukan profil AWS dan mengambil EC2 metrik Amazon: $ python3 cwreport.py ec2 --profile testprofile

  • Untuk menentukan Wilayah dan profil untuk mengambil EC2 metrik Amazon: $ python3 cwreport.py ec2 --region us-east-1 --profile testprofile

Lampiran

Untuk mengakses konten tambahan yang terkait dengan dokumen ini, unzip file berikut: attachment.zip