Menggunakan ekspresi matematika dengan CloudWatch metrik

Matematika metrik memungkinkan Anda menanyakan beberapa CloudWatch metrik dan menggunakan ekspresi matematika untuk membuat deret waktu baru berdasarkan metrik ini. Anda dapat memvisualisasikan deret waktu yang dihasilkan di CloudWatch konsol dan menambahkannya ke dasbor. Menggunakan AWS Lambda metrik sebagai contoh, Anda dapat membagi Errors metrik dengan Invocations metrik untuk mendapatkan tingkat kesalahan. Kemudian tambahkan deret waktu yang dihasilkan ke grafik di CloudWatch dasbor Anda.

Anda juga dapat melakukan matematika metrik secara terprogram, menggunakan operasi. GetMetricData API Untuk informasi lebih lanjut, lihat GetMetricData.

Tambahkan ekspresi matematika ke CloudWatch grafik

Anda dapat menambahkan ekspresi matematika ke grafik di CloudWatch dasbor Anda. Setiap grafik dibatasi menggunakan maksimum 500 metrik dan ekspresi, sehingga Anda dapat menambahkan ekspresi matematika hanya jika grafik memiliki 499 metrik atau lebih sedikit. Ini berlaku meskipun tidak semua metrik ditampilkan pada grafik.

Untuk menambahkan ekspresi matematika ke grafik

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

2. Buat atau sunting grafik. Setidaknya harus ada satu metrik dalam grafik.

3. Pilih Metrik bergrafik.

4. Pilih Ekspresi matematika, Mulai dengan ekspresi kosong. Garis baru muncul untuk ekspresi.

5. Di garis baru, berdasarkan kolom Detail, masukkan ekspresi matematika. Tabel di bagian Sintaksis dan Fungsi Matematika Metrik mencantumkan fungsi yang dapat Anda gunakan dalam ekspresi.

   Untuk menggunakan metrik atau hasil ekspresi lain sebagai bagian dari rumus untuk ekspresi ini, gunakan nilai yang ditunjukkan di kolom Id: misalnya, m1+m2 atau e1- MIN (e1).

   Anda dapat mengubah nilai Id. Ini dapat mencakup angka, huruf, garis bawah, dan harus dimulai dengan huruf kecil. Mengubah nilai Id menjadi nama yang lebih bermakna juga dapat membuat grafik lebih mudah dipahami; misalnya, mengubah m1 dan m2 menjadi kesalahan dan permintaan.

   Tip

   Pilih panah turun di sebelah Ekspresi Matematika untuk melihat daftar fungsi yang didukung, yang dapat Anda gunakan ketika membuat ekspresi.

6. Untuk kolom Label dari ekspresi, masukkan nama yang menjelaskan penghitungan ekspresi.

   Jika hasil dari ekspresi adalah susunan deret waktu, masing-masing rangkaian waktu tersebut ditampilkan pada grafik dengan garis terpisah, dengan warna berbeda. Langsung di bawah grafik adalah keterangan untuk setiap garis dalam grafik. Untuk pernyataan tunggal yang menghasilkan beberapa rangkaian waktu, keterangan untuk rangkaian waktu tersebut ada dalam format Expression-Label Metric-Label. Misalnya, jika grafik menyertakan metrik dengan label Kesalahan dan ekspresi FILL(METRICS(), 0) yang memiliki label Diisi Dengan 0:, satu baris dalam legenda akan diisi dengan 0: Kesalahan. Agar keterangan hanya menampilkan label metrik asli, tetapkan Expression-Label kosong.

   Ketika satu pernyataan menghasilkan susunan rangkaian waktu pada grafik, Anda tidak dapat mengubah warna yang digunakan untuk setiap rangkaian waktu tersebut.

7. Setelah menambahkan ekspresi yang diinginkan, Anda dapat menyederhanakan grafik dengan menyembunyikan beberapa metrik asli. Untuk menyembunyikan metrik atau ekspresi, hapus kotak centang di sebelah kiri bidang Id.

Sintaks dan fungsi matematika metrik

Bagian berikut menjelaskan fungsi yang tersedia untuk matematika metrik. Semua fungsi harus ditulis dalam huruf besar (seperti AVG), dan bidang Id untuk semua metrik dan ekspresi matematika harus dimulai dengan huruf kecil.

Hasil akhir ekspresi matematika harus berupa satu deret waktu atau susunan deret waktu. Beberapa fungsi menghasilkan angka skalar. Anda dapat menggunakan fungsi ini dalam fungsi yang lebih besar sehingga pada akhirnya menghasilkan satu deret waktu. Misalnya, mengambil deret waktu tunggal menghasilkan bilangan skalar, sehingga tidak bisa menjadi hasil ekspresi akhir. AVG Tapi Anda bisa menggunakannya dalam fungsi m1- AVG (m1) untuk menampilkan deret waktu perbedaan antara setiap titik data individu dan nilai rata-rata dalam deret waktu.

Singkatan tipe data

Beberapa fungsi hanya berlaku untuk jenis data tertentu. Singkatan dalam daftar berikut digunakan dalam tabel fungsi untuk mewakili jenis data yang didukung pada setiap fungsi:

• S mewakili angka skalar, seperti 2, -5, atau 50,25.

• TS adalah deret waktu (serangkaian nilai untuk satu CloudWatch metrik dari waktu ke waktu): misalnya, CPUUtilization metrik misalnya i-1234567890abcdef0 selama tiga hari terakhir.

• TS[] adalah susunan deret waktu, seperti deret waktu untuk beberapa metrik.

• String[] adalah susunan string.

Fungsi METRICS ()

Fungsi METRICS() mengembalikan semua metrik dalam permintaan. Ekspresi matematika tidak disertakan.

Anda dapat menggunakan METRICS() dalam ekspresi yang lebih besar yang menghasilkan deret waktu tunggal atau array deret waktu. Misalnya, ekspresi SUM(METRICS()) mengembalikan deret waktu (TS) yang merupakan jumlah nilai dari semua metrik grafik. METRICS() /100 mengembalikan array deret waktu, yang masing-masing merupakan deret waktu yang menunjukkan setiap titik data dari salah satu metrik dibagi 100.

Anda dapat menggunakan fungsi METRICS() dengan string untuk mengembalikan hanya metrik grafik yang berisi string itu di bidang Id mereka. Misalnya, ekspresi SUM(METRICS(“error”)) mengembalikan deret waktu yang merupakan jumlah nilai dari semua metrik grafik yang memiliki 'kesalahan' di bidang Id mereka. Anda juga dapat menggunakan SUM([METRICS(“4xx”), METRICS (“5xx”)]) untuk mencocokkan beberapa string.

Fungsi aritmetika dasar

Tabel berikut mencantumkan daftar fungsi aritmetika dasar yang didukung. Nilai yang hilang dalam deret waktu dianggap 0. Jika nilai titik data menyebabkan fungsi mencoba membagi dengan nol, maka titik data diabaikan.

Operasi	Argumen	Contoh
Operator aritmetika: + - * / ^	S, S S, TS TS, TS S, TS[] TS, TS[]	PERIOD(m1) /60 5 * m1 m1 - m2 SUM(100/ [m1, m2]) AVG(METRICS()) METRICS() * 100
Pengurangan uner -	S TS TS[]	-5*m1 -m1 SUM(- [m1, m2])

Operator perbandingan dan logis

Anda dapat menggunakan operator perbandingan dan logika baik dengan sepasang deret waktu maupun sepasang nilai skalar tunggal. Ketika Anda menggunakan operator perbandingan dengan sepasang deret waktu, operator mengembalikan deret waktu di mana setiap titik data adalah 0 (salah) atau 1 (benar). Jika Anda menggunakan operator perbandingan pada sepasang nilai skalar, satu nilai skalar akan dikembalikan, baik 0 maupun 1.

Ketika operator perbandingan digunakan antara dua deret waktu, dan hanya satu deret waktu yang memiliki nilai untuk time stamp tertentu, fungsi menganggap nilai yang hilang dalam deret waktu lain sebagai 0.

Anda dapat menggunakan operator logis bersama operator perbandingan, untuk membuat fungsi yang lebih kompleks.

Tabel berikut mencantumkan operator yang didukung.

Jenis operator	Operator yang didukung
Operator Perbandingan	== != <= >= < >
Operator Logis	ANDatau && OR atau ||

Untuk melihat bagaimana operator ini digunakan, misalkan kita memiliki dua deret waktu: metric1 memiliki nilai [30, 20, 0, 0] dan metric2 memiliki nilai [20, -, 20, -] di mana - menunjukkan bahwa tidak ada nilai untuk timestamp tersebut.

Ekspresi	Output
(metric1 < metric2)	0, 0, 1, 0
(metric1 >= 30)	1, 0, 0, 0
(metrik1 > 15 AND metrik2 > 15)	1, 0, 0, 0

Fungsi yang didukung untuk matematika metrik

Tabel berikut menjelaskan fungsi yang dapat Anda gunakan dalam ekspresi matematika. Masukkan semua fungsi dalam huruf besar.

Hasil akhir ekspresi matematika harus berupa satu deret waktu atau susunan deret waktu. Beberapa fungsi dalam tabel di bagian berikut menghasilkan angka skalar. Anda dapat menggunakan fungsi ini dalam fungsi yang lebih besar sehingga pada akhirnya menghasilkan satu deret waktu. Misalnya, mengambil deret waktu tunggal menghasilkan bilangan skalar, sehingga tidak bisa menjadi hasil ekspresi akhir. AVG Tapi Anda bisa menggunakannya dalam fungsi m1- AVG (m1) untuk menampilkan deret waktu perbedaan antara setiap titik data individu dan nilai rata-rata titik data tersebut.

Dalam tabel berikut, setiap contoh dalam kolom Contoh adalah ekspresi yang menghasilkan satu deret waktu atau susunan deret waktu. Contoh ini menunjukkan cara fungsi yang mengembalikan angka skalar dapat digunakan sebagai bagian dari ekspresi yang benar guna menghasilkan satu deret waktu.

Fungsi	Argumen	Jenis pengembalian*	Deskripsi	Contoh	Didukung untuk lintas akun?
ABS	TS TS[]	TS TS[]	Mengembalikan nilai mutlak dari setiap titik data.	ABS(m1-m2) MIN(ABS([m1, m2])) ABS(METRICS())	✓
ANOMALY_DETECTION_BAND	TS TS, S	TS[]	Mengembalikan pita deteksi anomali untuk metrik tertentu. Pita ini terdiri atas dua deret waktu, satu mewakili batas atas nilai yang diharapkan "normal" dari metrik, dan satu lagi mewakili batas bawah. Fungsi dapat menerima dua argumen. Yang pertama adalah ID metrik untuk membuat pita. Argumen kedua adalah jumlah penyimpangan baku yang digunakan untuk pita. Jika Anda tidak menentukan argumen ini, default 2 digunakan. Untuk informasi selengkapnya, lihat Menggunakan CloudWatch deteksi anomali.	ANOMALY_ DETECTION _ BAND (m1) ANOMALY_ DETECTION _ BAND (m1,4)
AVG	TS TS[]	S TS	The AVGof a single time series mengembalikan skalar yang mewakili rata-rata semua titik data dalam metrik. Array deret waktu mengembalikan satu deret waktu. AVG Nilai yang hilang dianggap sebagai 0. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm jika Anda ingin fungsi mengembalikan skalar. Misalnya, AVG(m2). Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta. Untuk menggunakan fungsi ini dengan alarm, terutama alarm yang memiliki tindakan Penskalaan Otomatis, kami sarankan Anda mengatur alarm untuk menggunakan M dari titik data N, di mana M < N.	SUM([m1, m2])/AVG(m2) AVG(METRICS())	✓
CEIL	TS TS[]	TS TS[]	Mengembalikan batas tertinggi setiap metrik. Batas tertinggi adalah bilangan bulat terkecil yang lebih besar dari atau sama dengan setiap nilai.	CEIL(m1) CEIL(METRICS()) SUM(CEIL(METRICS()))	✓
DATAPOINT_COUNT	TS TS[]	S TS	Mengembalikan hitungan titik data yang melaporkan nilai-nilai. Ini berguna untuk menghitung rata-rata metrik yang jarang. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm. Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	SUM(m1)/DATAPOINT_ COUNT (m1) DATAPOINT_COUNT(METRICS())	✓
DB_ _ PERF INSIGHTS	String, String, String String, String, String[]	TS (jika diberi satu string) TS[] (jika diberi susunan string)	Mengembalikan metrik Wawasan Performa Counter untuk basis data seperti Amazon Relational Database Service dan Amazon DocumentDB (dengan kompatibilitas MongoDB). Fungsi ini mengembalikan jumlah data yang sama yang bisa Anda dapatkan dengan langsung menanyakan Performance APIs Insights. Anda dapat menggunakan metrik ini CloudWatch untuk membuat grafik dan membuat alarm. penting Bila Anda menggunakan fungsi ini, Anda harus menentukan ID Sumber Daya Basis Data Unik dari basis data tersebut. Hal ini berbeda dengan pengidentifikasi basis data. Untuk menemukan ID sumber daya database di RDS konsol Amazon, pilih instans DB untuk melihat detailnya. Kemudian, pilih tab Konfigurasi. ID Sumber Daya ditampilkan di bagian Konfigurasi. DB_ PERF _ INSIGHTS juga membawa DBLoad metrik pada interval sub-menit. Metrik Performance Insights yang diambil dengan fungsi ini tidak disimpan. CloudWatch Oleh karena itu, beberapa CloudWatch fitur seperti observabilitas lintas akun, deteksi anomali, aliran metrik, penjelajah metrik, dan Wawasan Metrik tidak berfungsi dengan metrik Performance Insights yang Anda ambil dengan DB_ _. PERF INSIGHTS Satu permintaan menggunakan INSIGHTS fungsi DB_ PERF _ dapat mengambil jumlah titik data berikut. 1080 titik data untuk periode resolusi tinggi (1 detik, 10 detik, 30-an) 1440 titik data untuk periode resolusi standar (1m, 5m, 1 jam, 1d) INSIGHTSFungsi DB_ PERF _ hanya mendukung panjang periode berikut: 1 detik 10 detik 30 detik 1 menit 5 Menit 1 Jam 1 hari Untuk informasi selengkapnya tentang metrik penghitung RDS Performance Insights Amazon, lihat Metrik penghitung Performance Insights. Untuk informasi selengkapnya tentang metrik penghitung Wawasan Performa Amazon DocumentDB, silakan lihat Metrik penghitung Wawasan Performa. catatan Metrik resolusi tinggi dengan perincian sub-menit yang diambil oleh DB_ PERF _ INSIGHTS hanya berlaku untuk metrik, atau untuk DBLoadmetrik sistem operasi jika Anda telah mengaktifkan Enhanced Monitoring pada resolusi yang lebih tinggi. Untuk informasi selengkapnya tentang pemantauan yang RDS disempurnakan Amazon, lihat Memantau metrik OS dengan Pemantauan yang Ditingkatkan. Anda dapat membuat alarm resolusi tinggi menggunakan INSIGHTS fungsi DB_ PERF _ untuk rentang waktu maksimum tiga jam. Anda dapat menggunakan CloudWatch konsol untuk membuat grafik metrik yang diambil dengan INSIGHTS fungsi DB_ PERF _ untuk rentang waktu apa pun.	DB_ PERF _ INSIGHTS ('RDS', 'db- ABCDEFGHIJKLMNOPQRSTUVWXY1 ', 'os. cpuUtilization.user.avg') DB_ PERF _ INSIGHTS ('DOCDB, 'db-ABCDEFGHIJKLMNOPQRSTUVWXY1', ['os. cpuUtilization.idle.avg', 'os. cpuUtilization.user.max'])
DIFF	TS TS[]	TS TS[]	Mengembalikan perbedaan antara setiap nilai dalam deret waktu dan nilai sebelumnya dari deret waktu tersebut.	DIFF(m1)	✓
DIFF_TIME	TS TS[]	TS TS[]	Mengembalikan perbedaan dalam detik antara timestamp setiap nilai dalam deret waktu dan timestamp nilai sebelumnya dari deret waktu tersebut.	DIFF_TIME(METRICS())	✓
FILL	TS, [S | REPEAT |LINEAR] TS [], [TS | S | REPEAT |LINEAR]	TS TS[]	Mengisi nilai-nilai yang hilang dari deret waktu. Ada beberapa pilihan untuk nilai yang akan digunakan sebagai pengisi untuk nilai-nilai yang hilang: Anda dapat menentukan sebuah nilai yang akan digunakan sebagai nilai pengisi. Anda dapat menentukan sebuah metrik yang akan digunakan sebagai nilai pengisi. Anda dapat menggunakan REPEATkata kunci untuk mengisi nilai yang hilang dengan nilai aktual metrik terbaru sebelum nilai yang hilang. Anda dapat menggunakan LINEARkata kunci untuk mengisi nilai yang hilang dengan nilai yang membuat interpolasi linier antara nilai di awal dan akhir celah. catatan Saat menggunakan fungsi ini dalam alarm, Anda dapat mengalami masalah jika metrik Anda dipublikasikan dengan sedikit penundaan, dan menit terakhir tidak pernah memiliki data. Dalam hal ini, FILLganti titik data yang hilang dengan nilai yang diminta. Itu menyebabkan titik data terbaru untuk metrik selalu menjadi FILL nilai, yang dapat mengakibatkan alarm macet dalam status atau ALARM status OK. Anda dapat mengatasi ini menggunakan alarm M dari N. Untuk informasi selengkapnya, lihat Melakukan evaluasi alarm.	FILL(m1,10) FILL(METRICS(), 0) FILL(METRICS(), m1) FILL(m1, MIN (m1)) FILL(m1,REPEAT) FILL(METRICS(), LINEAR)	✓
FIRST LAST	TS[]	TS	Mengembalikan deret waktu pertama atau terakhir dari susunan deret waktu. Ini berguna bila digunakan dengan SORTfungsi. Ini juga dapat digunakan untuk mendapatkan ambang batas tinggi dan rendah dari fungsi ANOMALY_ DETECTION _ BAND.	IF FIRST (SORT(METRICS(()AVG,,DESC)) >100, 1, 0) Melihat metrik atas dari array, yang diurutkan berdasarkan. AVG Ini kemudian akan mengembalikan 1 atau 0 untuk setiap titik data, tergantung pada apakah nilai titik data tersebut lebih dari 100. LAST(ANOMALY_ DETECTION _ BAND (m1)) mengembalikan batas atas pita prediksi anomali.	✓
FLOOR	TS TS[]	TS TS[]	Mengembalikan pangkat setiap metrik. Pangkat adalah bilangan bulat terbesar yang kurang dari atau sama dengan setiap nilai.	FLOOR(m1) FLOOR(METRICS())	✓
IF	Ekspresi IF	TS	Gunakan IF bersama operator perbandingan untuk memfilter titik data dari deret waktu, atau membuat deret waktu campuran yang terdiri atas beberapa deret waktu gabungan. Untuk informasi selengkapnya, lihat Menggunakan ekspresi IF.	Sebagai contoh, silakan lihat Menggunakan ekspresi IF.	✓
INSIGHT_RULE_METRIC	INSIGHT_RULE_METRIC(ruleName, metricName)	TS	Gunakan INSIGHT_ RULE _ METRIC untuk mengekstrak statistik dari aturan di Contributor Insights. Untuk informasi selengkapnya, lihat Metrik grafik yang dihasilkan oleh aturan di CloudWatch.
LAMBDA	LAMBDA(LambdaFunctionName [, opsional-arg] *)	TS TS[]	Memanggil fungsi Lambda untuk menanyakan metrik dari sumber data yang tidak. CloudWatch Untuk informasi selengkapnya, lihat Cara meneruskan argumen ke fungsi Lambda Anda.
LOG	TS TS[]	TS TS[]	The LOGof a time series mengembalikan nilai logaritma natural dari setiap nilai dalam deret waktu.	LOG(METRICS())	✓
LOG10	TS TS[]	TS TS[]	LOG10 dari deret waktu mengembalikan nilai logaritma basis-10 dari setiap nilai dalam deret waktu.	LOG10 (m1)	✓
MAX	TS TS[]	S TS	The MAXof a single time series mengembalikan skalar yang mewakili nilai maksimum semua titik data dalam metrik. Jika Anda memasukkan array deret waktu, MAXfungsi membuat dan mengembalikan deret waktu yang terdiri dari nilai tertinggi untuk setiap titik data, di antara deret waktu yang digunakan sebagai input. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm jika Anda ingin fungsi mengembalikan skalar. Misalnya, MAX(m2) Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	MAX(m1) /m1 MAX(METRICS())	✓
METRIC_COUNT	TS[]	S	Mengembalikan jumlah metrik dalam susunan deret waktu.	m1/ METRIC _ COUNT (METRICS())	✓
METRICS	kosong string	TS[]	Fungsi METRICS() mengembalikan semua CloudWatch metrik dalam permintaan. Ekspresi matematika tidak disertakan. Anda dapat menggunakan METRICS() dalam ekspresi yang lebih besar yang menghasilkan deret waktu tunggal atau array deret waktu. Anda dapat menggunakan fungsi METRICS() dengan string untuk mengembalikan hanya metrik grafik yang berisi string itu di bidang Id mereka. Misalnya, ekspresi SUM(METRICS(“error”)) mengembalikan deret waktu yang merupakan jumlah nilai dari semua metrik grafik yang memiliki 'kesalahan' di bidang Id mereka. Anda juga dapat menggunakan SUM([METRICS(“4xx”), METRICS (“5xx”)]) untuk mencocokkan beberapa string.	AVG(METRICS()) SUM(METRICS(“kesalahan”))	✓
MIN	TS TS[]	S TS	The MINof a single time series mengembalikan skalar yang mewakili nilai minimum semua titik data dalam metrik. Jika Anda memasukkan array deret waktu, MINfungsi membuat dan mengembalikan deret waktu yang terdiri dari nilai terendah untuk setiap titik data, di antara deret waktu yang digunakan sebagai input. Jika Anda memasukkan array deret waktu, MINfungsi membuat dan mengembalikan deret waktu yang terdiri dari nilai terendah untuk setiap titik data, di antara deret waktu yang digunakan sebagai input. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm jika Anda ingin fungsi mengembalikan skalar. Misalnya, MIN(m2) Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	m1- MIN (m1) MIN(METRICS())	✓
MINUTE HOUR DAY DATE MONTH YEAR EPOCH	TS	TS	Fungsi-fungsi ini mengambil periode dan rentang dari deret waktu dan mengembalikan deret waktu baru yang tidak jarang di mana setiap nilai didasarkan pada timestampnya. MINUTEmengembalikan deret waktu bilangan bulat yang tidak jarang antara 0 dan 59 yang mewakili UTC menit dari setiap stempel waktu dalam deret waktu asli. HOURmengembalikan deret waktu bilangan bulat yang tidak jarang antara 0 dan 23 yang mewakili UTC jam dari setiap stempel waktu dalam deret waktu asli. DAYmengembalikan deret waktu bilangan bulat yang tidak jarang antara 1 dan 7 yang mewakili UTC hari dalam seminggu dari setiap stempel waktu dalam deret waktu asli. 1 mewakili Senin dan 7 mewakili hari Minggu. DATEmengembalikan deret waktu yang tidak jarang dari bilangan bulat antara 1 dan 31 yang mewakili UTC hari bulan dari setiap stempel waktu dalam deret waktu asli. MONTHmengembalikan deret waktu bilangan bulat yang tidak jarang antara 1 dan 12 yang mewakili UTC bulan dari setiap stempel waktu dalam deret waktu asli. 1 mewakili Januari dan 12 mewakili Desember. YEARmengembalikan deret waktu bilangan bulat yang tidak jarang yang mewakili UTC tahun setiap stempel waktu dalam deret waktu asli. EPOCHmengembalikan deret waktu yang tidak jarang dari bilangan bulat yang mewakili UTC waktu dalam detik sejak Epoch setiap stempel waktu dalam deret waktu asli. Epoch adalah 1 Januari 1970.	MINUTE(m1) IF (DAY(m1) <6, m1) mengembalikan metrik hanya dari hari kerja, Senin hingga Jumat. IF (MONTH(m1) == 4, m1) hanya mengembalikan metrik yang diterbitkan pada bulan April.	✓
PERIOD	TS	S	Mengembalikan periode metrik dalam detik. Input yang benar adalah metrik, bukan hasil ekspresi lainnya.	m1/ PERIOD (m1)	✓
RATE	TS TS[]	TS TS[]	Mengembalikan tingkat perubahan metrik per detik. Ini dihitung sebagai selisih antara nilai titik data terbaru dan nilai titik data sebelumnya, dibagi dengan perbedaan waktu dalam detik antara dua nilai. penting Menyetel alarm pada ekspresi yang menggunakan RATE fungsi pada metrik dengan data jarang dapat berperilaku tidak terduga, karena rentang titik data yang diambil saat mengevaluasi alarm dapat bervariasi berdasarkan kapan titik data terakhir diterbitkan.	RATE(m1) RATE(METRICS())	✓
REMOVE_EMPTY	TS[]	TS[]	Menghapus setiap deret waktu yang tidak memiliki titik data dari susunan deret waktu. Hasilnya adalah susunan deret waktu di mana setiap rangkaian waktu memuat paling sedikit satu titik data. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm. Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	REMOVE_EMPTY(METRICS())	✓
RUNNING_SUM	TS TS[]	TS TS[]	Mengembalikan deret waktu dengan jumlah berjalan dari nilai dalam deret waktu asli. catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm. Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	RUNNING_ SUM ([m1, m2])	✓
SEARCH	Ekspresi pencarian	Satu TS atau lebih	Mengembalikan satu deret waktu atau lebih yang sesuai dengan kriteria pencarian yang Anda tentukan. SEARCHFungsi ini memungkinkan Anda untuk menambahkan beberapa deret waktu terkait ke grafik dengan satu ekspresi. Grafik diperbarui secara dinamis untuk menyertakan metrik baru yang ditambahkan kemudian dan cocok dengan kriteria pencarian. Untuk informasi selengkapnya, lihat Gunakan ekspresi pencarian pada grafik. Anda tidak dapat membuat alarm berdasarkan SEARCHekspresi. Hal ini karena ekspresi pencarian mengembalikan beberapa deret waktu, dan sebuah alarm yang dibuat berdasarkan ekspresi matematika hanya dapat mengawasi satu deret waktu. Jika Anda masuk ke akun pemantauan dalam observabilitas CloudWatch lintas akun, SEARCHfungsi akan menemukan metrik di akun sumber dan akses pemantauan.		✓
SERVICE_QUOTA	TS yang merupakan metrik penggunaan	TS	Mengembalikan kuota layanan untuk metrik penggunaan yang diberikan. Anda dapat menggunakan ini untuk memvisualisasikan cara penggunaan saat ini dibandingkan dengan kuota, dan mengatur alarm yang memperingatkan Anda ketika mendekati kuota. Untuk informasi selengkapnya, lihat AWS metrik penggunaan.		✓
SLICE	(TS[], S, S) atau (TS[], S)	TS[] TS	Mengambil sebagian dari susunan deret waktu. Ini sangat berguna bila dikombinasikan dengan SORT. Sebagai contoh, Anda dapat mengecualikan hasil teratas dari susunan deret waktu. Anda dapat menggunakan dua pendapat skalar untuk menentukan seperangkat deret waktu yang ingin dikembalikan. Kedua skalar menetapkan awal (inklusif) dan akhir (eksklusif) dari susunan untuk kembali. Susunan diberi indeks nol, sehingga deret waktu pertama dalam susunan adalah deret waktu 0. Atau, Anda dapat menentukan hanya satu nilai, dan CloudWatch mengembalikan semua deret waktu dimulai dengan nilai itu.	SLICE(SORTMETRICS(),SUM,DESC), 0, 10) mengembalikan 10 metrik dari array metrik dalam permintaan yang memiliki nilai tertinggiSUM. SLICE(SORTMETRICS(),AVG,ASC), 5) mengurutkan larik metrik berdasarkan AVG statistik, lalu mengembalikan semua deret waktu kecuali 5 dengan yang terendahAVG.	✓
SORT	(TS [],FUNCTION, SORT _ORDER) (TS [],FUNCTION, SORT _ORDER, S)	TS[]	Mengurutkan susunan deret waktu sesuai fungsi yang Anda tentukan. Fungsi yang Anda gunakan dapat berupa AVG, MIN, MAX, atau SUM. Urutan pengurutan dapat berupa ASCnaik (nilai terendah terlebih dahulu) atau DESCuntuk mengurutkan nilai yang lebih tinggi terlebih dahulu. Anda secara opsional dapat menentukan sebuah angka setelah urutan pengurutan yang bertindak sebagai batas. Sebagai contoh, menentukan batas 5 pengembalian hanya 5 deret waktu teratas dari pengurutan. Ketika fungsi matematika ini ditampilkan pada grafik, label untuk setiap metrik dalam grafik juga diurutkan dan diberi nomor.	SORTMETRICS(),AVG,DESC, 10) menghitung nilai rata-rata setiap deret waktu, mengurutkan deret waktu dengan nilai tertinggi di awal pengurutan, dan hanya mengembalikan 10 deret waktu dengan rata-rata tertinggi. SORTMETRICS(),MAX,ASC) mengurutkan array metrik berdasarkan MAX statistik, lalu mengembalikan semuanya dalam urutan menaik.	✓
STDDEV	TS TS[]	S TS	The STDDEVof a single time series mengembalikan skalar yang mewakili standar deviasi dari semua titik data dalam metrik. Array deret waktu mengembalikan satu deret waktu. STDDEV catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm jika Anda ingin fungsi mengembalikan skalar. Misalnya, STDDEV(m2) Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	m1/ STDDEV (m1) STDDEV(METRICS())	✓
SUM	TS TS[]	S TS	The SUMof a single time series mengembalikan skalar yang mewakili jumlah nilai semua titik data dalam metrik. Array deret waktu mengembalikan satu deret waktu. SUM catatan Kami menyarankan Anda untuk tidak menggunakan fungsi ini di CloudWatch alarm jika Anda ingin fungsi mengembalikan skalar. Misalnya, SUM(m1). Setiap kali alarm mengevaluasi apakah akan mengubah status, CloudWatch mencoba untuk mengambil jumlah titik data yang lebih tinggi daripada nomor yang ditentukan sebagai Periode Evaluasi. Fungsi ini berperilaku berbeda ketika data tambahan diminta.	SUM(METRICS())/SUM(m1) SUM([m1, m2]) SUM(METRICS(“kesalahan”))/SUM(METRICS(“permintaan”)) *100	✓
TIME_SERIES	S	TS	Mengembalikan deret waktu non-jarang di mana setiap nilai diatur ke argumen skalar.	TIME_ SERIES (MAX(m1)) TIME_ SERIES (5* AVG (m1)) TIME_ SERIES (10)	✓

*Menggunakan fungsi yang hanya mengembalikan angka skalar tidak benar, karena semua hasil akhir ekspresi harus berupa satu deret waktu atau susunan deret waktu. Alih-alih, gunakan fungsi ini sebagai bagian dari ekspresi yang lebih besar agar mengembalikan deret waktu.

Menggunakan ekspresi IF

Gunakan IF bersama operator perbandingan untuk memfilter titik data dari deret waktu, atau membuat deret waktu campuran yang terdiri atas beberapa deret waktu gabungan.

IF menggunakan argumen berikut:

IF(condition, trueValue, falseValue)

Kondisi mengevaluasi FALSE apakah nilai titik data kondisi adalah 0, dan TRUE jika nilai kondisi adalah nilai lain, apakah nilai itu positif atau negatif. Jika ketentuannya adalah deret waktu, maka akan dievaluasi secara terpisah untuk setiap timestamp.

Berikut ini daftar sintaksis yang benar. Untuk setiap sintaksis ini, output adalah satu rangkaian waktu.

• IF(TS Comparison Operator S, S | TS, S | TS)

  catatan

  Jika TS comparison operator S is TRUE tetapi metric2 tidak memiliki titik data yang sesuai, outputnya akan menjadi 0.

• IF(TS, TS, TS)

• IF(TS, S, TS)

• IF(TS, TS, S)

• IF(TS, S, S)

• IF(S, TS, TS)

Bagian berikut memberikan rincian dan contoh lebih lanjut untuk sintaksis ini.

IF(TS Comparison Operator S, skalar2 | metrik2, skalar3 | metrik3)

Nilai rangkaian waktu output yang sesuai:

• memiliki nilai skalar2 atau metrik2, jika TS Comparison Operator S adalah TRUE

• memiliki nilai skalar3 atau metrik3, jika TS Comparison Operator S adalah FALSE

• memiliki nilai 0 jika TS Comparison Operatoris TRUE dan titik data yang sesuai di metric2 tidak ada.

• memiliki nilai 0 jika TS Comparison Operatoris FALSE dan titik data yang sesuai di metric3 tidak ada.

• adalah deret waktu kosong, jika titik data yang sesuai tidak ada dalam metric3, atau jika skalar3/metric3 dihilangkan dari ekspresi

IF(metric1, metric2, metric3)

Untuk setiap titik data metric1, nilai deret waktu output yang sesuai:

• memiliki nilai metrik2, jika titik data yang sesuai dari metrik1 adalah. TRUE

• memiliki nilai metrik3, jika titik data yang sesuai dari metrik1 adalah. FALSE

• memiliki nilai 0, jika titik data yang sesuai dari metrik1 adalah TRUE dan titik data yang sesuai tidak ada dalam metrik2.

• dijatuhkan, jika titik data metrik1 yang sesuai FALSE dan titik data yang sesuai tidak ada dalam metrik3

• dijatuhkan, jika titik data yang sesuai dari metrik1 adalah FALSE dan metrik3 dihilangkan dari ekspresi.

• dijatuhkan, jika titik data metrik1 yang sesuai hilang.

Tabel berikut menunjukkan contoh untuk sintaks ini.

Metrik atau fungsi	Nilai-nilai
(metric1)	[1, 1, 0, 0, -]
(metric2)	[30, -, 0, 0, 30]
(metric3)	[0, 0, 20, -, 20]
IF(metric1, metric2, metric3)	[30, 0, 20, 0, -]

IF(metric1, scalar2, metric3)

Untuk setiap titik data metric1, nilai deret waktu output yang sesuai:

• memiliki nilai skalar2, jika titik data yang sesuai dari metrik1 adalah. TRUE

• memiliki nilai metrik3, jika titik data yang sesuai dari metrik1 adalah. FALSE

• dijatuhkan, jika titik data metrik1 yang sesuai FALSE dan titik data yang sesuai tidak ada pada metrik3, atau jika metrik3 dihilangkan dari ekspresi.

Metrik atau fungsi	Nilai-nilai
(metric1)	[1, 1, 0, 0, -]
scalar2	5
(metric3)	[0, 0, 20, -, 20]
IF(metric1, scalar2, metric3)	[5, 5, 20, -, -]

IF(metric1, metric2, scalar3)

Untuk setiap titik data metric1, nilai deret waktu output yang sesuai:

• memiliki nilai metrik2, jika titik data yang sesuai dari metrik1 adalah. TRUE

• memiliki nilai skalar3, jika titik data yang sesuai dari metrik1 adalah. FALSE

• memiliki nilai 0, jika titik data yang sesuai dari metrik1 adalah TRUE dan titik data yang sesuai tidak ada dalam metrik2.

• diabaikan jika titik data yang sesuai pada metric1 tidak ada.

Metrik atau fungsi	Nilai-nilai
(metric1)	[1, 1, 0, 0, -]
(metric2)	[30, -, 0, 0, 30]
scalar3	5
IF(metric1, metric2, scalar3)	[30, 0, 5, 5, -]

IF(scalar1, metric2, metric3)

Nilai deret waktu output yang sesuai:

• memiliki nilai metrik2, jika skalar1 adalah. TRUE

• memiliki nilai metrik3, jika skalar1 adalah. FALSE

• adalah deret waktu kosong, jika metrik3 dihilangkan dari ekspresi.

Gunakan contoh kasus untuk ekspresi IF

Contoh berikut menggambarkan kemungkinan penggunaan fungsi IF.

• Untuk menampilkan hanya nilai metrik rendah:

  IF(metric1<400, metric1)

• Untuk mengubah setiap titik data dalam metrik menjadi satu dari dua nilai, untuk menunjukkan tinggi dan rendah relatif dari metrik awal:

  IF(metric1<400, 10, 2)

• Agar menampilkan 1 untuk setiap timestamp di mana latensi berada di atas ambang batas, dan menampilkan 0 untuk semua titik data lainnya:

  IF(latency>threshold, 1, 0)

Gunakan matematika metrik dengan GetMetricData API operasi

Anda dapat menggunakan GetMetricData untuk melakukan perhitungan menggunakan ekspresi matematika, dan juga mengambil sejumlah besar data metrik dalam satu API panggilan. Untuk informasi lebih lanjut, lihat GetMetricData.

Deteksi anomali pada matematika metrik

Deteksi anomali pada matematika metrik adalah fitur yang dapat Anda gunakan untuk membuat alarm deteksi anomali pada metrik tunggal dan hasil ekspresi matematika metrik. Anda dapat menggunakan ekspresi-ekspresi ini untuk membuat grafik yang menggambarkan pita deteksi anomali. Fitur ini mendukung fungsi aritmatika dasar, operator perbandingan dan logika, dan sebagian besar fungsi lainnya.

Deteksi anomali pada matematika metrik tidak mendukung fungsi berikut:

• Ekspresi yang berisi lebih dari satu ANOMALY_ DETECTION _ BAND di baris yang sama.

• Ekspresi yang berisi lebih dari 10 metrik atau ekspresi matematika.

• Ekspresi yang mengandung METRICSekspresi.

• Ekspresi yang berisi SEARCHfungsi.

• Ekspresi yang menggunakan fungsi DP_ PERF _ INSIGHTS.

• Ekspresi yang menggunakan metrik dengan periode yang berbeda.

• Detektor anomali matematika metrik yang menggunakan metrik resolusi tinggi sebagai input.

Untuk informasi selengkapnya tentang fitur ini, lihat Menggunakan deteksi CloudWatch anomali di CloudWatch Panduan Pengguna Amazon.