View a markdown version of this page

Pemantauan Amazon Textract - Amazon Textract
Menggunakan CloudWatch Metrik untuk Amazon TextractAkses Metrik Amazon TextractBuat Alarm

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 global untuk akun Anda. Anda dapat menggunakan metrik untuk melacak kesehatan solusi berbasis Amazon Text, dan mengatur alarm untuk memberi tahu Anda ketika satu atau lebih metrik berada di luar ambang batas yang ditentukan. Misalnya, Anda dapat melihat metrik untuk jumlah kesalahan server yang telah terjadi. Anda juga dapat melihat metrik untuk berapa kali operasi Amazon Textract tertentu berhasil. Untuk melihat metrik, Anda dapat menggunakan Amazon CloudWatch AWS CLI, the, atau CloudWatch API.

Menggunakan CloudWatch Metrik untuk Amazon Textract

Untuk menggunakan metrik, Anda harus menentukan informasi berikut:

  • Dimensi metrik atau tidak ada dimensi. Dimensi adalah pasangan nama-nilai yang membantu Anda mengidentifikasi metrik secara unik. Amazon Textract memiliki satu dimensi, bernama Oper asi. Ini menyediakan metrik untuk operasi tertentu. Jika Anda tidak menentukan dimensi, metrik akan dicakup untuk semua operasi Amazon Textract dalam akun Anda.

  • Nama metrik, seperti UserErrorCount.

Anda bisa mendapatkan data pemantauan untuk Amazon Textract dengan menggunakan Konsol Manajemen AWS, the AWS CLI, atau CloudWatch API. Anda juga dapat menggunakan CloudWatch API melalui salah satu Kit Pengembangan Perangkat Lunak Amazon AWS (SDK) atau alat CloudWatch API. Konsol menampilkan serangkaian grafik berdasarkan data mentah dari CloudWatch API. 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 CloudWatch izin yang sesuai untuk memantau Amazon Textract dengan CloudWatch. Untuk informasi lebih lanjut, lihat Kontrol Autentikasi dan Akses untuk Amazon CloudWatch.

Akses Metrik Amazon Textract

Contoh berikut menunjukkan cara mengakses metrik Amazon Textract menggunakan CloudWatch konsol, AWS CLI, dan CloudWatch API.

Cara melihat metrik (konsol)

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

  2. Pilih Metrik, pilih tab Semua Metrik, lalu pilih Amazon Textract.

  3. Pilih Berdasarkan operasi, lalu pilih metrik.

    Misalnya, pilih StartDocumentAnalysis metrik untuk mengukur berapa kali analisis dokumen asinkron telah dimulai.

  4. Pilih nilai untuk rentang tanggal. Hitungan metrik ditampilkan dalam grafik.

Untuk melihat metrik panggilan StartDocumentAnalysis operasi yang berhasil yang telah dilakukan selama periode waktu (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.

Untuk mengakses metrik (CloudWatch API)

Buat Alarm

Anda dapat membuat CloudWatch alarm yang mengirimkan pesan Amazon Simple Notification Service (Amazon SNS) saat alarm berubah status. Alarm mengawasi metrik tunggal selama periode waktu yang Anda tentukan. Alarm tersebut melakukan satu atau beberapa tindakan berdasarkan nilai metrik yang relatif terhadap ambang batas tertentu selama beberapa periode waktu. Tindakan ini adalah notifikasi yang dikirim ke topik Amazon SNS atau kebijakan Penskalaan Otomatis.

Alarm memanggil tindakan hanya untuk perubahan status berkelanjutan. CloudWatch alarm tidak memanggil tindakan hanya karena mereka berada dalam keadaan tertentu. Status harus diubah dan dipertahankan selama jangka waktu tertentu.

Untuk mengatur alarm (konsol)

  1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

  2. Di panel navigasi, pilih Alarm, dan pilih Buat Alarm. Ini membuka Create Alarm Wizard.

  3. Pilih Pilih Metrik.

  4. Di tab Semua metrik, pilih Textract.

  5. Pilih Berdasarkan Oper asi, lalu pilih metrik.

    Misalnya, pilih StartDocumentAnalysis untuk menyetel alarm untuk jumlah maksimum operasi analisis dokumen asinkron.

  6. Pilih tab Metrik bergrafik.

  7. Untuk Statistik pilih Jumlah.

  8. Pilih Pilih Metrik.

  9. Isi Nama dan Deskripsi. Untuk Kapan pun, pilih >=, dan masukkan nilai maksimum pilihan Anda.

  10. Jika Anda CloudWatch ingin mengirimi Anda email ketika status alarm tercapai, untuk When ever this alarm:, pilih State is 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 menyimpan daftar dan menampilkannya di lapangan sehingga Anda dapat menggunakannya untuk mengatur alarm masa depan.

    catatan

    Jika Anda menggunakan Daftar baru untuk membuat topik Amazon SNS baru, alamat email harus diverifikasi sebelum penerima yang dituju menerima pemberitahuan. Amazon SNS hanya mengirim email ketika alarm memasuki status alarm. Jika perubahan status alarm ini terjadi sebelum alamat email diverifikasi, penerima yang dituju tidak menerima pemberitahuan.

  11. Pilih Buat Alarm.

Untuk mengatur alarm (AWS CLI)

  • Buka AWS CLI dan masukkan perintah berikut. Ubah nilai alarm-actions parameter untuk mereferensikan topik Amazon SNS yang Anda buat sebelumnya. 

    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 5 menit untuk panggilan keStartDocumentAnalysis. Untuk informasi selengkapnya, lihat masukkan-metrik-alarm.

Untuk mengatur alarm (CloudWatch API)