Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemantauan Amazon Textract
Dengan CloudWatch, Anda bisa mendapatkan metrik untuk operasi Amazon Textract individual atau metrik Amazon Textract untuk akun Anda. Anda dapat menggunakan metrik untuk melacak kondisi solusi berbasis Amazon Textract, dan menyiapkan alarm untuk memberi tahu ketika satu atau beberapa metrik berada di luar ambang batas yang ditentukan. Misalnya, Anda dapat melihat metrik untuk jumlah kesalahan server yang terjadi. Anda juga dapat melihat metrik untuk berapa kali operasi Amazon Textract tertentu telah berhasil. Untuk melihat metrik, Anda dapat menggunakan[Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/), yang[AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/), atau[API CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## Menggunakan Metrik CloudWatch untuk Amazon Textract
Untuk menggunakan metrik, Anda harus menentukan informasi berikut:
+ Dimensi metrik atau tanpa dimensi. *Dimensi* adalah pasangan nama-nilai yang membantu Anda mengidentifikasi metrik secara unik. Amazon Textract memiliki satu dimensi, bernama*Operasi*. Ini menyediakan metrik untuk operasi tertentu. Jika Anda tidak menentukan dimensi, metrik akan dicakup ke semua operasi Amazon Textract di akun Anda.
+ Nama metrik, seperti `UserErrorCount`.
Anda bisa mendapatkan data pemantauan untuk Amazon Textract Texact dengan menggunakanKonsol Manajemen AWS, yangAWS CLI, atau API CloudWatch. Anda juga dapat menggunakan API CloudWatch melalui salah satu Kit Pengembangan Perangkat Lunak (SDK) Amazon AWS atau alat API CloudWatch. Konsol tersebut menampilkan serangkaian grafik berdasarkan data mentah dari API CloudWatch. Tergantung kebutuhan, Anda mungkin lebih memilih menggunakan grafik yang ditampilkan di konsol atau diterima dari API.
###
Daftar berikut menunjukkan beberapa penggunaan umum untuk metrik. Berikut ini adalah saran untuk memulai, bukan daftar komprehensif.
| Bagaimana caranya? | Metrik Terkait |
| --- | --- |
| Bagaimana saya tahu jika aplikasi saya telah mencapai jumlah maksimum permintaan per detik? | Pantau statistik `Sum` metrik `ThrottledCount`. |
| Bagaimana saya dapat memantau kesalahan permintaan? | Gunakan statistik `Sum` metrik `UserErrorCount`. |
| Bagaimana saya dapat menemukan jumlah total permintaan? | Gunakan statistik `SampleCount` metrik `ResponseTime`. Termasuk setiap permintaan yang menghasilkan kesalahan. Jika Anda ingin melihat panggilan operasi yang berhasil saja, maka gunakan metrik `SuccessfulRequestCount`. |
| Bagaimana saya bisa memantau latensi panggilan operasi Amazon Textract? | Gunakan metrik `ResponseTime`. |
Anda harus memiliki izin CloudWatch yang sesuai untuk memantau Amazon Textract dengan CloudWatch. Untuk informasi selengkapnya, lihat [Autentikasi dan Kontrol Akses untuk Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## Mengakses Metrik Amazon Textract
Contoh-contoh berikut menunjukkan cara mengakses metrik Amazon Textract Texact menggunakan konsol CloudWatch,AWS CLI, dan API CloudWatch.
**Untuk melihat metrik (konsol)**
1. Buka konsol CloudWatch di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch).
1. Pilih**Metrik**, pilih**Semua Metrik**tab, dan kemudian pilih**Amazon Textract**.
1. Pilih**Dengan operasi**, dan kemudian pilih metrik.
Misalnya, pilih**StartDocumentAnalysis**metrik untuk mengukur berapa kali analisis dokumen asinkron telah dimulai.
1. Pilih nilai untuk rentang tanggal. Hitungan metrik ditampilkan dalam grafik.
**Melihat metrik agar sukses`StartDocumentAnalysis`panggilan operasi yang telah dilakukan selama periode waktu tertentu (CLI)**
+ Buka AWS CLI dan masukkan perintah berikut:
```
aws cloudwatch get-metric-statistics \
--metric-name SuccessfulRequestCount \
--start-time 2019-02-01T00:00:00Z \
--period 3600 \
--end-time 2019-03-01T00:00:00Z \
--namespace AWS/Textract \
--dimensions Name=Operation,Value=StartDocumentAnalysis \
--statistics Sum
```
Contoh ini menunjukkan panggilan operasi `StartDocumentAnalysis` yang berhasil dilakukan selama periode waktu tertentu. Untuk informasi selengkapnya, lihat [dapatkan-metrik-statistik](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html).
**Untuk mengakses metrik (API CloudWatch)**
+ Panggil `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Untuk informasi selengkapnya, lihat [Referensi API Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## Buat Alarm
Anda dapat membuat alarm CloudWatch yang mengirimkan pesan Amazon Simple Notification Service (Amazon SNS) ketika status alarm berubah. Alarm mengawasi satu metrik selama suatu periode waktu yang Anda tentukan. Alarm tersebut juga dapat melakukan satu atau beberapa tindakan berdasarkan nilai metrik relatif terhadap ambang batas selama sejumlah periode waktu. Tindakan ini adalah notifikasi yang dikirim ke topik Amazon SNS atau kebijakan Auto Scaling.
Alarm memicu tindakan hanya untuk perubahan status berkelanjutan. Alarm CloudWatch tidak memicu tindakan hanya karena alarm tersebut berada dalam status tertentu. Status harus diubah dan dipelihara selama jangka waktu tertentu.
**Untuk mengatur alarm (konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka konsol CloudWatch di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Di panel navigasi, pilih**Alarm**, dan pilih**Buat Alarm**. Ini akan membuka**Buat Wisaya Alarm**.
1. Pilih **Pilih metrik**.
1. Di**Semua metrik**tab, pilih**Textract**.
1. Pilih**Operasi**, dan kemudian pilih metrik.
Misalnya, pilih**StartDocumentAnalysis**untuk mengatur alarm untuk jumlah maksimum operasi analisis dokumen asinkron.
1. Pilih tab **Metrik bergrafik**.
1. Untuk **Statistik** pilih **Jumlah**.
1. Pilih **Pilih metrik**.
1. Isi **Nama** dan **Deskripsi**. Untuk **Kapan pun**, pilih **>=**, dan masukkan nilai maksimum pilihan Anda.
1. Jika Anda ingin CloudWatch mengirimkan email jika status alarm sudah tercapai, untuk **Kapan pun alarm ini:**, pilih **Status ALARM**. Untuk mengirim alarm ke topik Amazon SNS yang sudah ada, untuk **Kirim notifikasi ke:**, pilih topik SNS yang sudah ada. Untuk mengatur nama dan alamat email untuk daftar langganan email baru, pilih**Daftar baru**. CloudWatch, simpan daftar dan tampilkan di bidang sehingga Anda dapat menggunakannya untuk mengatur alarm di masa mendatang.
**catatan**
Jika Anda menggunakan**Daftar baru**untuk membuat topik Amazon SNS baru, alamat email harus diverifikasi sebelum penerima yang dituju menerima notifikasi. Amazon SNS hanya mengirim email ketika alarm memasuki status alarm. Jika perubahan status alarm ini terjadi sebelum alamat email diverifikasi, maka penerima yang dituju tidak akan menerima notifikasi.
1. Pilih **Buat Alarm**.
**Untuk mengatur alarm (AWS CLI)**
+ Buka AWS CLI dan masukkan perintah berikut. Mengubah nilai`alarm-actions`parameter untuk mereferensikan topik Amazon SNS yang sebelumnya Anda buat.
```
aws cloudwatch put-metric-alarm \
--alarm-name StartDocumentAnalysisUserErrors \
--alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
--metric-name UserErrorCount \
--namespace AWS/Textract \
--statistic Sum \
--period 300 \
--threshold 10 \
--comparison-operator GreaterThanThreshold \
--evaluation-periods 1 \
--unit Count \
--dimensions Name=Operation,Value=StartDocumentAnalysis \
--alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic
```
Contoh ini menunjukkan cara membuat alarm ketika lebih dari 10 kesalahan pengguna terjadi dalam waktu 5 menit untuk panggilan`StartDocumentAnalysis`. Untuk informasi selengkapnya, lihat [masukkan-metrik-alarm](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html).
**Untuk mengatur alarm (API CloudWatch)**
+ Panggil `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Untuk informasi selengkapnya, lihat *[Referensi API Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.