Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # mon-describe-alarms-for-metrik ## Deskripsi Dapatkan informasi mengenai alarm-alarm yang terkait dengan metrik tertentu. ## Sintaks ****mon-describe-alarms-for-metric** --metric-name *value* --namespace *value* [--dimensions "key1=*value1*,key2=*value2*..."] [--period *value*] [--statistic *value*] [--extendedstatistic *value*] [--unit *value*] [Common Options] ** ## Opsi | Nama | Deskripsi | | --- | --- | | `--dimensions` `- "key1=value1,key2=value2...` | Dimensi-dimensi yang terkait dengan metrik. Anda dapat menentukan dimensi dengan menggunakan dua cara dan formatnya dapat digabungkan atau digunakan secara saling menggantikan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/cli/cli-mon-describe-alarms-for-metric.html) Tipe: Peta Nilai valid: String dengan format nama=nilai, di mana kuncinya adalah nama dimensi, dan nilainya adalah nilai dari dimensi. Nama dimensi, dan nilai harus berupa rangkaian ANSI yang memiliki panjang antara 1 dan 250 karakter. Diperbolehkan maksimal 10 dimensi. Bawaan: Tidak ada Wajib: Tidak | | `--metric-name` `VALUE` | Nama metrik yang alarm terkaitnya ingin Anda cari. Tipe: Argumen Nilai valid: Nama metrik yang benar yang memiliki panjang antara 1 dan 255 karakter. Bawaan: Tidak ada Wajib: Ya | | `--namespace` `VALUE` | Ruang nama metrik yang terkait dengan alarm. Untuk informasi selengkapnya tentang ruang nama, silakan lihat [AWS Namespaces](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html). Tipe: String Nilai valid: Nama ruang nama yang benar yang memiliki panjang antara 1 dan 250 karakter. Bawaan: Tidak ada Wajib: Ya | | `--period` `VALUE` | Periode yang digunakan untuk menyaring alarm. Hanya alarm yang mengevaluasi metrik pada periode ini saja yang nanti akan disertakan dalam hasil penyaringan. Jika tidak disebutkan, maka alarm pada periode apa pun akan disertakan. Tipe: Argumen Nilai valid: Sebuah angka, dalam satuan detik, yang merupakan kelipatan dari 60 detik. Bawaan: Tidak ada Wajib: Tidak | | `--statistic` `VALUE` | Statistik yang digunakan untuk menyaring alarm. Hanya alarm pada statistik yang ditentukan saja yang akan disertakan. Jika parameter ini tidak ditentukan, maka alarm pada semua statistik akan disertakan dalam hasil penyaringan. Tipe: Pencacahan Nilai yang valid: SampleCount, Rata-rata, Jumlah, Minimum atau Maksimum Bawaan: Tidak ada Wajib: Tidak | | `--extendedstatistic` `VALUE` | Statistik persentil yang digunakan untuk menyaring alarm. Hanya alarm pada statistik yang ditentukan saja yang akan disertakan. Jika parameter ini tidak ditentukan, maka semua alarm pada statistik apa pun akan disertakan. Tipe: String Nilai valid: Setiap persentil, dengan maksimal dua tempat desimal (misalnya, hal95.45). Bawaan: Tidak ada Wajib: Tidak | | `--unit` `VALUE` | Unit yang digunakan untuk menyaring alarm. Hanya alarm pada statistik yang ditentukan yang akan disertakan. Jika tidak disebutkan, maka alarm pada semua unit akan disertakan. Jika alarm tidak ditentukan unitnya, maka satu-satunya cara untuk mencari alarm adalah dengan menghapus pilihan ini. Tipe: Pencacahan Nilai valid: Gunakan salah satu nilai berikut ini: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/cli/cli-mon-describe-alarms-for-metric.html) Bawaan: Tidak ada Wajib: Tidak | ## Opsi umum | Nama | Deskripsi | | --- | --- | | `--aws-credential-file` `VALUE` | Lokasi file dengan AWS kredensi Anda. Anda dapat mengatur nilai ini dengan menggunakan variabel lingkungan `AWS_CREDENTIAL_FILE`. Jika Anda menentukan variabel lingkungan atau memberikan jalur ke file kredensial, maka file tersebut harus ada, jika tidak, maka permintaan gagal. Semua CloudWatch permintaan harus ditandatangani menggunakan ID kunci akses dan kunci akses rahasia Anda. Tipe: String Nilai valid: Jalur yang valid ke file yang berisi ID kunci akses dan kunci akses rahasia. Bawaan: Menggunakan variabel lingkungan `AWS_CREDENTIAL_FILE`, jika diatur. | | `-C, --ec2-cert-file-path` `VALUE` | Lokasi file EC2 sertifikat Anda untuk menandatangani permintaan. Anda dapat menggunakan variabel lingkungan `EC2_CERT` untuk menentukan nilai ini. Tipe: String Nilai yang valid: Jalur file yang valid ke file PEM yang disediakan oleh Amazon EC2 atau AWS Identity and Access Management. Bawaan: Menggunakan variabel lingkungan `EC2_CERT`, jika diatur. | | `--connection-timeout` `VALUE` | Nilai waktu habis koneksi, menggunakan satuan detik. Tipe: Integer Nilai valid: Semua angka positif. Bawaan: 30 | | `--delimiter` `VALUE` | Pembatas yang digunakan ketika menampilkan hasil yang dibatasi (panjang). Tipe: String Nilai valid: Semua string. Bawaan: Koma (,) | | `--headers` `` | Jika Anda menampilkan hasil dalam bentuk tabel atau dipisahkan, maka Anda harus menyertakan header kolom. Jika Anda menunjukkan hasil XML, maka Anda harus mengembalikan header HTTP dari permintaan layanan, jika ada. Tipe: Bendera Nilai valid: Jika ada, tampilkan header. Bawaan: Pilihan `--headers` secara default tidak aktif. | | `-I, --access-key-id` `VALUE` | ID kunci akses yang akan digunakan, bersama dengan kunci rahasia, untuk menandatangani permintaan. Ini harus digunakan bersamaan dengan --kunci rahasia, jika tidak, maka pilihan yang bersangkutan akan diabaikan. Semua permintaan CloudWatch harus ditandatangani, jika tidak permintaan ditolak. Tipe: String Nilai valid: ID kunci akses yang benar. Bawaan: Tidak Ada | | `-K, --ec2-private-key-file-path` `VALUE` | Kunci privat yang akan digunakan untuk menandatangani permintaan. Menggunakan public/private kunci menyebabkan CLI menggunakan SOAP. Permintaan tersebut ditandatangani dengan sertifikat publik dan kunci privat. Parameter ini harus digunakan bersamaan dengan `EC2_CERT`, jika tidak, maka nilainya akan diabaikan. Nilai variabel lingkungan `EC2_PRIVATE_KEY` akan digunakan jika memang diatur untuk menggunakan nilai itu, dan pilihan ini tidak ditentukan. Pilihan ini akan diabaikan jika variabel lingkungan `AWS_CREDENTIAL_FILE` telah ditetapkan, atau jika `--aws-credentials-file` digunakan. Semua permintaan CloudWatch harus ditandatangani, jika tidak permintaan ditolak. Tipe: String Nilai valid: Jalur ke kunci privat ASN.1 yang benar. Bawaan: Tidak Ada | | `--region` `VALUE` | Permintaan wilayah diarahkan ke. Anda dapat menggunakan variabel lingkungan `EC2_REGION` untuk menentukan nilai tersebut. Wilayah ini digunakan untuk membuat URL yang digunakan untuk memanggil CloudWatch, dan harus merupakan wilayah Amazon Web Services (AWS) yang valid. Tipe: String Nilai yang valid: Setiap AWS wilayah, misalnya, us-east-1. Bawaan: us-east-1, kecuali jika `EC2_REGION` variabel lingkungan sudah ditetapkan. | | `S, --secret-key` `VALUE` | Kunci akses rahasia yang akan digunakan bersama dengan ID kunci akses untuk menandatangani permintaan. Parameter ini harus digunakan bersamaan dengan `--access-key-id`, jika tidak, maka pilihan ini akan diabaikan. Tipe: String Nilai valid: ID kunci akses Anda. Bawaan: Tidak Ada | | `--show-empty-fields` `` | Menampilkan bidang kosong menggunakan (nil) sebagai placeholder untuk menunjukkan bahwa data ini tidak diminta. Tipe: Bendera Nilai valid: Tidak ada Bawaan: Secara bawaan, bidang yang kosong tidak ditampilkan. | | `--show-request` `` | Menampilkan URL yang digunakan oleh CLI untuk memanggil AWS. Tipe: Bendera Nilai valid: Tidak ada Bawaan: salah | | `--show-table, --show-long, --show-xml, --quiet` `` | Menentukan bagaimana hasil ditampilkan: dalam bentuk tabel, dibatasi (panjang), XML, atau tidak ada output (diam). Tampilan `--show-table` menunjukkan bagian dari data dalam bentuk lebar kolom tetap; `--show-long` menunjukkan semua nilai yang dikembalikan yang dibatasi oleh sebuah karakter; `--show-xml` adalah pengembalian mentah dari layanan; dan `--quiet` menekan semua output yang standar. Semua pilihan tidak dapat dipilih bersamaan, dengan prioritas `--show-table`, `--show-long`, `--show-xml`, dan `--quiet`. Tipe: Bendera Nilai valid: Tidak ada Default: `--show-table` | | `-U, --url` `VALUE` | URL yang digunakan untuk menghubungi CloudWatch Anda dapat mengatur nilai ini dengan menggunakan variabel lingkungan `AWS_CLOUDWATCH_URL`. Nilai ini digunakan secara bersamaan dengan `--region` untuk membuat URL yang diharapkan. Pilihan ini menimpa URL untuk panggilan layanan. Tipe: String Nilai valid: URL HTTP atau HTTPS yang valid. Bawaan: Menggunakan nilai yang ditentukan dalam `AWS_CLOUDWATCH_URL`, jika sudah diatur. | ## Output Perintah ini akan menampilkan sebuah tabel yang memuat hal-hal berikut: + ALARM - Nama alarm. + DESCRIPTION - Deskripsi alarm. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + STATE - Status alarm. + STATE\$1REASON - Alasan status yang dapat dibaca manusia. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + STATE\$1REASON\$1DATA - Alasan status yang dapat dibaca mesin (format SON). Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + ENABLED - Mengaktifkan atau menonaktifkan tindakan. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + OK\$1ACTIONS - Tindakan untuk menjalankan status OK. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + ALARM\$1ACTIONS - Tindakan untuk menjalankan status ALARM. + INSUFFICIENT\$1DATA\$1ACTION - Tindakan untuk menjalankan status INSUFFICIENT\$1DATA. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + NAMESPACE - Ruang nama untuk metrik. + METRIC\$1NAME - Nama metrik. + DIMENSIONS - Dimensi metrik. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + PERIOD - Periode. + Statistik - Statistik (Rata-rata, Minimum, Maksimum, Jumlah, SampleCount). + EXTENDEDSTATISTIC - Statistik persentil. + UNIT - Unit. Kolom ini hanya muncul dalam tampilan --tampilkan-panjang. + EVAL\$1PERIODS - Jumlah periode untuk mengevaluasi metrik. + COMPARISON - Operator perbandingan. + THRESHOLD - Ambang batas. Amazon CloudWatch CLI menampilkan kesalahan pada stderr. ## Contoh ### Contoh permintaan Contoh ini mendeskripsikan alarm untuk metrik tertentu. ``` mon-describe-alarms-for-metric--metric-name CPUUtilization --namespace AWS/EC2 --dimensions InstanceId=i-abcdef ``` Ini adalah contoh keluaran dari perintah ini. ``` ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80.0 ``` ## Topik terkait ### Unduh + [Menyiapkan antarmuka baris perintah](SetupCLI.md) ### Tindakan terkait + [DescribeAlarmForMetric](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmsForMetric.html) ### Perintah-perintah terkait + [mon-describe-alarm-history](cli-mon-describe-alarm-history.md) + [mon-describe-alarms](cli-mon-describe-alarms.md)