mon-get-stats - Amazon CloudWatch
DeskripsiSintaksOpsiOpsi umumOutputContohTopik terkait

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

mon-get-stats

Deskripsi

Mengambil data deret waktu waktu untuk statistik-statistik yang ditentukan.

catatan

Ketika Anda membuat sebuah metrik baru dengan menggunakan perintah mon-put-data, diperlukan waktu hingga dua menit sebelum Anda dapat mengambil statistik pada metrik baru dengan menggunakan perintah mon-get-stats. Namun demikian, hal ini dapat memakan waktu hingga lima belas menit sebelum metrik baru tersebut muncul dalam daftar metrik yang diambil menggunakan perintah mon-list-metrics.

Sintaks

mon-get-stats MetricName --namespace value --statistics value[,value...] [--dimensions "key1=value1,key2=value2..." ] [--end-time value] [--period value] [--start-time value] [--unit value] [Common Options]

Opsi

Nama Deskripsi

MetricName

Nama metrik. Anda juga dapat mengatur nilai ini dengan menggunakan --metric-name.

Tipe: Argumen

Nilai valid: Semua nama metrik yang valid dengan panjang antara 1 dan 255 karakter.

Bawaan: Tidak ada

Wajib: Ya

--dimensions "key1=value1,key2=value2..."

Dimensi metrik. Anda dapat menentukan dimensi dengan menggunakan dua cara dan formatnya dapat digabungkan atau digunakan secara saling menggantikan:

  • Satu pilihan per dimensi: -- dimensi "key1=value1" -- dimensi "key2=value2"

  • Semua dalam satu pilihan: -- dimensi "key1=value1,key2=value2"

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

--end-time VALUE

Stempel waktu terkini yang diizinkan untuk titik data yang telah dikembalikan. Waktu selesainya bersifat eksklusif. Stempel waktu ditentukan menggunakan ISO86 01 format gabungan. Misalnya, tanggal dan waktu 30 Juli 2013 pada pukul 12:30:00 PST akan dinyatakan sebagai 2013-07-30T12:30:00-07:00, atau dinyatakan sebagai UTC: 2013-07-30T19:30:00Z. Resolusi tertinggi yang dapat dikembalikan CloudWatch adalah 1 menit, dengan demikian semua stempel waktu dibulatkan ke menit terdekat.

Tipe: Argumen

Nilai yang valid: Stempel waktu yang valid diwakili dalam format ISO86 01 dengan offset zona waktu, atau indikator UTC.

Bawaan: Tanggal/jam saat ini.

Wajib: Tidak

-n, --namespace VALUE

Ruang nama metrik. Untuk informasi selengkapnya tentang ruang nama, silakan lihat AWS Namespaces.

Tipe: String

Nilai valid: Nama ruang nama yang benar yang memiliki panjang antara 1 dan 250 karakter.

Bawaan: Tidak ada

Wajib: Ya

--period VALUE

Pedetail, dalam detik, yang akan digunakan untuk mengambil statistik. Periode tersebut harus paling sedikit 60 detik dan harus merupakan kelipatan 60.

Tipe: Argumen

Nilai valid: Sebuah angka, dalam satuan detik, yang merupakan kelipatan dari 60 detik.

Bawaan: 60 detik.

Wajib: Tidak

-s, --statistics VALUE1,VALUE2,VALUE3...

Statistik yang akan dikembalikan untuk metrik yang telah ditentukan.

Tipe: Pencacahan

Nilai valid: Rata-rata, Jumlah, Maksimum, atau Minimum

Bawaan: Tidak ada

Wajib: Ya

--start-time VALUE

Stempel waktu pertama yang diizinkan untuk titik data yang dikembalikan. Waktu mulainya bersifat inklusif. Stempel waktu ditentukan menggunakan ISO86 01 format gabungan. Misalnya, tanggal dan waktu 30 Juli 2013 pada pukul 12:30:00 PST akan dinyatakan sebagai 2013-07-30T12:30:00-07:00, atau dinyatakan sebagai UTC: 2013-07-30T19:30:00Z. Resolusi tertinggi yang dapat dikembalikan CloudWatch adalah 1 menit, dengan demikian semua stempel waktu dibulatkan ke menit terdekat.

Tipe: Argumen

Nilai yang valid: Stempel waktu yang valid diwakili dalam format ISO86 01 dengan offset zona waktu, atau indikator UTC.

Bawaan: Satu jam sebelum waktu saat ini.

Wajib: Tidak

--unit VALUE

Unit yang akan digunakan untuk mengambil metrik. Metrik dapat dilaporkan dalam beberapa unit, hal ini akan mengambil sebuah unit khusus untuk metrik yang ditentukan. Jika tidak ada unit yang diminta, maka semua unit akan dikembalikan. Jika metrik hanya dilaporkan dengan satu unit, maka hal ini tidak akan berpengaruh.

Tipe: Pencacahan

Nilai valid: Gunakan salah satu nilai berikut ini:

  • Detik

  • Mikrodetik

  • Milidetik

  • Byte

  • Kilobyte

  • Megabyte

  • Gigabyte

  • Terabyte

  • Bit

  • Kilobit

  • Megabit

  • Gigabit

  • Terabit

  • Persen

  • Hitungan

  • Byte/Detik

  • Kilobyte/Detik

  • Megabyte/Detik

  • Gigabyte/Detik

  • Terabyte/Detik

  • Bit/Detik

  • Kilobit/Detik

  • Megabit/Detik

  • Gigabit/Detik

  • Terabit/Detik

  • Hitungan/Detik

  • Tidak ada

Bawaan: Tidak ada

Wajib: Tidak

Opsi umum

Nama Penjelasan

--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. Penggunaan kunci publik/privat akan membuat 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

Bawaan: --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:

  • Time - Waktu pengambilan metrik.

  • SampleCount - Tidak ada deskripsi yang tersedia untuk kolom ini.

  • Average - Nilai rata-rata.

  • Sum - Jumlah nilai.

  • Minimum - Nilai minimum yang diamati.

  • Maximum - Nilai maksimum yang diamati.

  • Unit - Unit metrik.

Amazon CloudWatch CLI menampilkan kesalahan pada stderr.

Contoh

Contoh permintaan

Contoh ini mengembalikan pemanfaatan CPU rata-rata, minimum, dan maksimum EC2 misalnya i-c07704a9, pada resolusi 1 jam.

mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"

Ini adalah contoh dari keluaran metrik Sampel dan Rata-rata pada resolusi satu menit.

Time                 Samples  Average  Unit   
2013-05-19 00:03:00  2.0      0.19     Percent
2013-05-19 00:04:00  2.0      0        Percent
2013-05-19 00:05:00  2.0      0        Percent
2013-05-19 00:06:00  2.0      0        Percent
2013-05-19 00:07:00  2.0      0        Percent
2013-05-19 00:08:00  2.0      0        Percent
2013-05-19 00:09:00  2.0      0        Percent
2013-05-19 00:10:00  2.0      0        Percent
2013-05-19 00:11:00  2.0      0        Percent
2013-05-19 00:12:00  2.0      0.195    Percent
2013-05-19 00:13:00  2.0      0.215    Percent
...

Contoh permintaan

Contoh ini mengembalikan pemanfaatan CPU di seluruh EC2 armada Anda.

mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"

Contoh permintaan

Contoh ini mengembalikan jumlah permintaan rata-rata, minimum, dan maksimum yang dibuat ke tumpukan pengujian MyService untuk pengguna tertentu, pada resolusi 1 jam.

mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"

Contoh permintaan

Contoh ini menunjukkan RequestCount statistik di semua "MyService”.

mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"

Topik terkait

Unduh

Tindakan terkait

Perintah-perintah terkait