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

# Metrik Amazon SWF untuk CloudWatch
<a name="cw-metrics"></a>

Amazon SWF kini menyediakan metrik CloudWatch yang dapat Anda gunakan untuk melacak alur kerja dan aktivitas serta menetapkan alarm pada nilai ambang batas yang Anda pilih. Anda dapat melihat metrik menggunakan. Konsol Manajemen AWS Untuk informasi selengkapnya, lihat [Melihat Metrik Amazon SWF untuk menggunakan CloudWatch Konsol Manajemen AWS](cw-metrics-console.md).

**Topics**
+ [Pelaporan Unit untuk Metrik Amazon SWF](#swf-reporting-units)
+ [Metrik Kejadian API dan Keputusan](#swf-throttling-metrics)
+ [Metrik Amazon SWF](#cloudwatch-swf-metrics)
+ [Amazon SWF nama dan dimensi sumber daya non-ASCII CloudWatch](#cloudwatch-swf-non-ascii)

## Pelaporan Unit untuk Metrik Amazon SWF
<a name="swf-reporting-units"></a>

### Metrik yang Melaporkan Interval Waktu
<a name="metrics-that-report-a-time-interval"></a>

Beberapa metrik Amazon SWF untuk CloudWatch adalah *interval waktu*, selalu diukur dalam milidetik. CloudWatch Unit ini dilaporkan sebagai`Time`. Metrik ini umumnya sesuai dengan tahapan eksekusi alur kerja Anda yang dapat mengatur alur kerja dan batas waktu aktivitas, dan memiliki nama yang serupa.

Misalnya, metrik `DecisionTaskStartToCloseTime` mengukur waktu yang dibutuhkan untuk tugas keputusan untuk menyelesaikan setelah mulai mengeksekusi, yang merupakan periode waktu yang sama tempat Anda dapat mengatur nilai `DecisionTaskStartToCloseTimeout`.

Untuk diagram masing-masing tahapan alur kerja ini dan untuk mempelajari ketika terjadi selama alur kerja dan siklus hidup aktivitas, lihat [Tipe Batas Waktu Amazon SWF](swf-timeout-types.md).

### Metrik yang Melaporkan Jumlah
<a name="metrics-that-report-a-count"></a>

*Beberapa metrik Amazon SWF untuk CloudWatch melaporkan hasil sebagai hitungan.* Misalnya, `WorkflowsCanceled`, mencatat hasil sebagai *satu* atau *nol*, yang menunjukkan apakah alur kerja dibatalkan atau tidak. Nilai nol tidak menunjukkan bahwa metrik tidak dilaporkan, hanya saja syarat yang dijelaskan metrik tidak terjadi.

Beberapa metrik Amazon SWF untuk laporan CloudWatch tersebut CloudWatch adalah `Count` *hitungan* per detik. Misalnya,`ProvisionedRefillRate`, yang dilaporkan sebagai `Count` in CloudWatch, mewakili *`Count`tingkat* permintaan per detik.

Untuk jumlah metrik, minimum dan maksimum akan selalu baik nol atau satu, tetapi rata-rata akan menjadi nilai mulai dari nol ke satu.

## Metrik Kejadian API dan Keputusan
<a name="swf-throttling-metrics"></a>

 Anda dapat memantau peristiwa API dan Keputusan CloudWatch untuk memberikan wawasan tentang penggunaan dan kapasitas Anda. Lihat [decider](swf-dev-actors.md#swf-dev-actors-deciders) dalam bagian [Konsep alur kerja dasar di Amazon SWF](swf-dg-basic.md), dan topik [Keputusan](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_Decision.html) di [Referensi API Amazon Simple Workflow Service](https://docs.aws.amazon.com/amazonswf/latest/apireference/).

Anda juga dapat memantau batas-batas ini untuk alarm ketika Anda mendekati batas throttling Amazon SWF Anda. Lihat [Kuota throttling Amazon SWF](swf-dg-limits.md#swf-throttling-limits) untuk deskripsi batas ini dan pengaturan default mereka. Batas ini dirancang untuk mencegah alur kerja yang salah mengkonsumsi sumber daya sistem yang berlebihan. Untuk meminta peningkatan batas Anda, lihat: [Meminta peningkatan kuota](swf-dg-limits.md#swf-dg-limits-how-to-increase).

Sebagai praktik terbaik, Anda harus mengonfigurasi CloudWatch alarm sekitar 60% dari kapasitas API atau peristiwa keputusan Anda. Tindakan ini akan mengizinkan Anda untuk menyesuaikan alur kerja, atau meminta peningkatan batas layanan, sebelum throttling Amazon SWF diaktifkan. Tergantung pada [lonjakan](https://en.wikipedia.org/wiki/Burstiness) panggilan, Anda dapat mengkonfigurasi alarm yang berbeda untuk memberitahu ketika Anda mendekati Kuota Layanan Anda: 
+ Jika lalu lintas Anda memiliki lonjakan yang signifikan, atur alarm pada 60% dari batas `ProvisionedBucketSize`.
+ Jika panggilan Anda memiliki tingkat yang relatif stabil, atur alarm pada 60% dari batas `ProvisionedRefillRate` untuk API terkait dan kejadian keputusan Anda. 

## Metrik Amazon SWF
<a name="cloudwatch-swf-metrics"></a>

Metrik berikut tersedia untuk Amazon SWF:


|  Metrik  |  Deskripsi  | 
| --- | --- | 
| `DecisionTaskScheduleToStartTime` | Interval waktu, dalam milidetik, antara waktu tugas keputusan dijadwalkan dan ketika diambil oleh pekerja dan dimulai.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `DecisionTaskStartToCloseTime` | Interval waktu, dalam milidetik, antara waktu tugas keputusan dimulai dan ketika ditutup.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `DecisionTasksCompleted` | Jumlah tugas keputusan yang telah selesai.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| PendingTasks | Jumlah tugas tertunda dalam interval 1 menit untuk Daftar Tugas tertentu.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, TaskListName`<br />Statistik yang valid: `Sum` | 
| `StartedDecisionTasksTimedOutOnClose` | Jumlah tugas keputusan yang dimulai tapi berakhir pada penutupan.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowStartToCloseTime` | Waktu, dalam milidetik, antara waktu alur kerja dimulai dan saat alur kerja ditutup.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `WorkflowsCanceled` | Jumlah alur kerja yang dibatalkan.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowsCompleted` | Jumlah alur kerja yang selesai.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowsContinuedAsNew` | Jumlah alur kerja yang berlanjut sebagai baru.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowsFailed` | Jumlah alur kerja yang gagal.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowsTerminated` | Jumlah alur kerja yang diakhiri.<br />CloudWatch Unit: `Count`<br />Dimensi: `Cause, Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `WorkflowsTimedOut` | Jumlah alur kerja yang waktunya habis, karena alasan apa pun.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, WorkflowTypeName, WorkflowTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ActivityTaskScheduleToCloseTime` | Interval waktu, dalam milidetik, antara waktu ketika aktivitas dijadwalkan dan ketika ditutup.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `ActivityTaskScheduleToStartTime` | Interval waktu, dalam milidetik, antara waktu ketika tugas aktivitas dijadwalkan dan ketika dimulai.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `ActivityTaskStartToCloseTime` | Interval waktu, dalam milidetik, antara waktu ketika tugas aktivitas dimulai dan ketika ditutup.<br />CloudWatch Unit: `Time`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Average, Minimum, Maximum` | 
| `ActivityTasksCanceled` | Jumlah tugas aktivitas yang dibatalkan.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ActivityTasksCompleted` | Jumlah tugas aktivitas yang selesai.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ActivityTasksFailed` | Jumlah tugas aktivitas yang gagal.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ScheduledActivityTasksTimedOutOnClose` | Jumlah tugas aktivitas yang dijadwalkan tetapi waktunya habis saat penutupan.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ScheduledActivityTasksTimedOutOnStart` | Jumlah tugas aktivitas yang dijadwalkan tetapi waktunya habis saat mulai.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `StartedActivityTasksTimedOutOnClose` | Jumlah tugas aktivitas yang dimulai tetapi waktunya habis saat penutupan.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `StartedActivityTasksTimedOutOnHeartbeat` | Jumlah tugas aktivitas yang dimulai tetapi waktunya habis karena batas waktu detak jantung.<br />CloudWatch Unit: `Count`<br />Dimensi: `Domain, ActivityTypeName, ActivityTypeVersion`<br />Statistik yang valid: `Sum` | 
| `ThrottledEvents` | Jumlah permintaan yang mengalami throttling.<br />CloudWatch Unit: `Count`<br />Dimensi: `APIName, DecisionName, ThrottlingScope`<br />Statistik yang valid: `Sum` | 
| `ProvisionedBucketSize` | Jumlah permintaan yang tersedia per detik.<br />Dimensi: `APIName, DecisionName`<br />Statistik yang valid: `Minimum` | 
| `ConsumedCapacity` | Jumlah permintaan per detik.<br />CloudWatch Unit: `Count`<br />Dimensi: `APIName, DecisionName`<br />Statistik yang valid: `Sum` | 
| ConsumedLimit | Jumlah batas umum yang telah dikonsumsi.<br />Dimensi: `GeneralLimitType` | 
| `ProvisionedRefillRate` | Jumlah permintaan per detik yang diizinkan masuk ke dalam bucket.<br />Dimensi: `APIName, DecisionName`<br />Statistik yang valid: `Minimum` | 
| ProvisionedLimit | Jumlah batas umum yang diberikan ke akun.<br />Dimensi: `GeneralLimitType` | 


|  Dimensi  |  Deskripsi  | 
| --- | --- | 
| `Domain` | Memfilter data ke domain Amazon SWF tempat alur kerja atau aktivitas berjalan. | 
| `ActivityTypeName` | Memfilter data ke nama tipe aktivitas. | 
| `ActivityTypeVersion` | Memfilter data ke versi tipe aktivitas. | 
| `WorkflowTypeName` | Memfilter data ke nama tipe alur kerja untuk eksekusi alur kerja ini. | 
| `WorkflowTypeVersion` | Memfilter data ke versi tipe alur kerja untuk eksekusi alur kerja ini. | 
| `APIName` | Memfilter data ke API dari nama API yang ditentukan. | 
| `DecisionName` | Memfilter data ke nama Keputusan yang ditentukan. | 
| `TaskListName` | Memfilter data ke nama Daftar Tugas yang ditentukan. | 
| `TaskListClassification` | Memfilter data ke klasifikasi daftar tugas. Nilai "D" untuk Daftar Tugas Keputusan dan "A" untuk Daftar Tugas Aktivitas. | 
| `ThrottlingScope` | Memfilter data ke lingkup pelambatan yang ditentukan. Nilai adalah “Akun” jika melebihi kuota tingkat akun, atau “Alur Kerja” saat melebihi kuota tingkat alur kerja. | 

## Amazon SWF nama dan dimensi sumber daya non-ASCII CloudWatch
<a name="cloudwatch-swf-non-ascii"></a>

Amazon SWF memungkinkan karakter non-ASCII dalam nama sumber daya seperti dan. TaskList DomainName Namun, nilai dimensi CloudWatch metrik hanya dapat berisi karakter ASCII yang dapat dicetak. Untuk memastikan bahwa Amazon SWF menggunakan nilai dimensi yang kompatibel dengan [CloudWatch persyaratan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Dimension.html), nama sumber daya Amazon SWF yang tidak memenuhi persyaratan ini akan dikonversi dan akan memiliki checksum yang ditambahkan sebagai berikut: 
+ Setiap karakter non-ASCII diganti dengan `?`. 
+ String masukan atau string yang diubah akan, jika perlu, terpotong. Ini memastikan bahwa ketika checksum ditambahkan, panjang string baru tidak akan melebihi maksimum. CloudWatch
+ Karena karakter non-ASCII dikonversi`?`, beberapa nilai dimensi CloudWatch metrik yang berbeda sebelum konversi mungkin tampak sama setelah konversi. Untuk membantu membedakannya, garis bawah (`_`) diikuti oleh 16 karakter pertama SHA256 checksum dari nama sumber daya asli ditambahkan ke nama sumber daya.

Contoh perubahan:
+ `test àpple` akan diubah menjadi `test ?pple_82cc5b8e3a771d12`
+ `àòà` akan diubah menjadi `???_2fec5edbb2c05c22`.
+  TaskList Nama-nama `àpplé` dan keduanya `âpplè` akan dikonversi menjadi`?ppl?`, dan akan identik. Menambahkan checksum mengembalikan nilai-nilai yang berbeda, `?ppl?_f39a36df9d85a69d` dan `?ppl?_da3efb4f11dd0f7f`.

**Tip**  
Anda dapat membuat SHA256 checksum Anda sendiri. Misalnya, untuk menggunakan alat baris perintah `shasum`:   
 **echo -n "<the original resource name>" \| shasum -a 256 \| cut -c1-16**