Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menerbitkan metrik kustom
Anda dapat mempublikasikan metrik Anda sendiri untuk CloudWatch menggunakan AWS CLI atau. API Anda dapat melihat grafik statistik metrik yang dipublikasikan dengan. AWS Management Console
CloudWatch menyimpan data tentang metrik sebagai serangkaian titik data. Setiap titik data memiliki stempel waktu terkait. Bahkan, Anda dapat menerbitkan himpunan titik data gabungan yang disebut himpunan statistik.
Topik
Metrik resolusi tinggi
Setiap metrik adalah salah satu dari berikut:
Resolusi standar, dengan data yang memiliki granularitas satu menit
Resolusi tinggi, dengan data pada granularitas satu detik
Metrik yang dihasilkan oleh AWS layanan adalah resolusi standar secara default. Ketika menerbitkan sebuah metrik kustom, Anda dapat menetapkannya sebagai resolusi standar atau resolusi tinggi. Saat Anda menerbitkan metrik resolusi tinggi, CloudWatch simpan dengan resolusi 1 detik, dan Anda dapat membaca dan mengambilnya dengan jangka waktu 1 detik, 5 detik, 10 detik, 30 detik, atau kelipatan 60 detik.
Metrik resolusi tinggi dapat memberi wawasan yang lebih cepat tentang aktivitas submenit aplikasi Anda. Ingatlah bahwa setiap panggilan PutMetricData
untuk sebuah metrik kustom yang dikenakan biaya, sehingga memanggil PutMetricData
lebih sering pada sebuah metrik resolusi tinggi akan dapat mengakibatkan biaya yang lebih tinggi. Untuk informasi selengkapnya tentang CloudWatch harga, lihat CloudWatch Harga Amazon
Jika Anda mengatur sebuah alarm pada metrik resolusi tinggi, maka Anda dapat menentukan alarm resolusi tinggi dengan periode 10 detik atau 30 detik, atau Anda dapat mengatur sebuah alarm biasa dengan periode lebih dari 60 detik. Terdapat biaya yang lebih tinggi untuk alarm resolusi tinggi dengan periode 10 atau 30 detik.
Gunakan dimensi
Dalam metrik kustom, parameter --dimensions
merupakan hal umum. Dimensi lebih lanjut menjelaskan apa itu metrik dan data apa yang disimpannya. Anda dapat memiliki hingga 30 dimensi yang ditetapkan pada satu metrik, dan setiap dimensi ditentukan oleh nama dan pasangan nilai.
Cara menentukan dimensi yang berbeda ketika Anda menggunakan perintah yang berbeda. Dengan put-metric-data, Anda menentukan setiap dimensi sebagai MyName
=MyValue
, dan dengan get-metric-statisticsatau put-metric-alarmAnda menggunakan format Name=
MyName
,
Value=
MyValue
. Misalnya, perintah berikut memublikasikan Buffers
metrik dengan dua dimensi yang disebut InstanceId
dan InstanceType
.
aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceId=1-23456789,InstanceType=m1.small
Perintah ini mengambil statistik untuk metrik yang sama. Pisahkan bagian Nama dan Nilai dari dimensi tunggal dengan tanda koma, tetapi jika Anda memiliki beberapa dimensi, gunakan ruang antara satu dimensi dan dimensi berikutnya.
aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceId,Value=1-23456789 Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60
Jika satu metrik menyertakan beberapa dimensi, Anda harus menentukan nilai untuk setiap dimensi yang ditentukan saat Anda menggunakannya get-metric-statistics. Misalnya, metrik Amazon S3 BucketSizeBytes
menyertakan dimensi BucketName
danStorageType
, jadi Anda harus menentukan kedua dimensi dengan. get-metric-statistics
aws cloudwatch get-metric-statistics --metric-name BucketSizeBytes --start-time 2017-01-23T14:23:00Z --end-time 2017-01-26T19:30:00Z --period 3600 --namespace AWS/S3 --statistics Maximum --dimensions Name=BucketName,Value=
MyBucketName
Name=StorageType,Value=StandardStorage --output table
Untuk melihat dimensi apa yang ditentukan untuk metrik, gunakan perintah list-metrics.
Menerbitkan titik data tunggal
Untuk mempublikasikan satu titik data untuk metrik baru atau yang sudah ada, gunakan put-metric-dataperintah dengan satu nilai dan cap waktu. Misalnya, setiap tindakan berikut menerbitkan satu titik data.
aws cloudwatch put-metric-data --metric-name
PageViewCount
--namespaceMyService
--value 2 --timestamp2016-10-20T12:00:00.000Z
aws cloudwatch put-metric-data --metric-namePageViewCount
--namespaceMyService
--value 4 --timestamp2016-10-20T12:00:01.000Z
aws cloudwatch put-metric-data --metric-namePageViewCount
--namespaceMyService
--value 5 --timestamp2016-10-20T12:00:02.000Z
Jika Anda memanggil perintah ini dengan nama metrik baru, CloudWatch buat metrik untuk Anda. Jika tidak, CloudWatch kaitkan data Anda dengan metrik yang ada yang Anda tentukan.
catatan
Saat Anda membuat metrik, diperlukan waktu hingga 2 menit sebelum Anda dapat mengambil statistik untuk metrik baru menggunakan get-metric-statisticsperintah. Namun demikian, ini dapat memakan waktu hingga 15 menit sebelum metrik baru tersebut muncul dalam daftar metrik yang diambil menggunakan perintah list-metrics.
Meskipun Anda dapat mempublikasikan titik data dengan stempel waktu sebagai granular seperseribu detik, CloudWatch agregat data ke granularitas minimum 1 detik. CloudWatch mencatat rata-rata (jumlah semua item dibagi dengan jumlah item) dari nilai yang diterima untuk setiap periode, serta jumlah sampel, nilai maksimum, dan nilai minimum untuk periode waktu yang sama. Sebagai contoh, metrik PageViewCount
dari contoh sebelumnya memuat tiga titik data dengan stempel waktu yang hanya berjarak beberapa detik. Jika periode Anda disetel ke 1 menit, CloudWatch agregat tiga titik data karena semuanya memiliki stempel waktu dalam periode 1 menit.
Anda dapat menggunakan perintah get-metric-statistics untuk mengambil statistik berdasarkan titik data yang dipublikasikan.
aws cloudwatch get-metric-statistics --namespace
MyService
--metric-namePageViewCount
\ --statistics "Sum" "Maximum" "Minimum" "Average" "SampleCount" \ --start-time2016-10-20T12:00:00.000Z
--end-time2016-10-20T12:05:00.000Z
--period 60
Berikut ini adalah output contoh.
{ "Datapoints": [ { "SampleCount": 3.0, "Timestamp": "2016-10-20T12:00:00Z", "Average": 3.6666666666666665, "Maximum": 5.0, "Minimum": 2.0, "Sum": 11.0, "Unit": "None" } ], "Label": "PageViewCount" }
Menerbitkan himpunan statistik
Anda dapat mengumpulkan data Anda sebelum mempublikasikannya CloudWatch. Bila Anda memiliki beberapa titik data per menit, menggabungkan data meminimalkan jumlah panggilan menjadi put-metric-data. Misalnya, alih-alih memanggil put-metric-data beberapa kali untuk tiga titik data yang berada dalam 3 detik satu sama lain, Anda dapat menggabungkan data ke dalam satu himpunan statistik yang Anda publikasikan dengan satu panggilan, menggunakan parameter --statistic-values
.
aws cloudwatch put-metric-data --metric-name PageViewCount --namespace
MyService
--statistic-values Sum=11,Minimum=2,Maximum=5,SampleCount=3 --timestamp2016-10-14T12:00:00.000Z
CloudWatch membutuhkan titik data mentah untuk menghitung persentil. Jika menerbitkan data menggunakan himpunan statistik, Anda tidak dapat mengambil statistik persentil untuk data ini kecuali jika salah satu ketentuan berikut benar:
SampleCount
dari himpunan statistik adalah 1Minimum
danMaximum
dari himpunan statistik adalah sama
Menerbitkan nilai Nol
Jika data Anda lebih bersifat jarang dan memiliki periode yang tidak memiliki data terkait, Anda dapat memilih untuk menerbitkan nilai nol (0
) untuk periode tersebut atau tidak ada nilai sama sekali. Jika menggunakan panggilan berkala ke PutMetricData
guna memantau kesehatan aplikasi Anda, Anda mungkin ingin menerbitkan nol, alih-alih tanpa nilai. Misalnya, Anda dapat mengatur CloudWatch alarm untuk memberi tahu Anda jika aplikasi Anda gagal mempublikasikan metrik setiap lima menit. Anda ingin aplikasi tersebut menerbitkan nol pada periode tanpa data terkait.
Anda juga dapat menerbitkan nol jika ingin melacak total titik data atau jika menginginkan statistik seperti minimum dan rata-rata untuk menyertakan titik data dengan nilai 0.
Berhenti menerbitkan metrik
Untuk menghentikan penerbitan metrik kustom ke CloudWatch, ubah kode aplikasi atau layanan Anda untuk berhenti menggunakan PutMetricData. CloudWatch tidak menarik metrik dari aplikasi, itu hanya menerima apa yang didorong ke sana, jadi untuk berhenti menerbitkan metrik Anda, Anda harus menghentikannya di sumbernya.