Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemantauan Amazon Translate
Pemantauan adalah bagian penting dalam menjaga keandalan, ketersediaan, dan kinerja Amazon Translate dan solusi Anda. AWS menyediakan berbagai alat yang dapat Anda gunakan untuk memantau Amazon Translate. Anda dapat mengonfigurasi beberapa alat ini untuk memantau solusi Anda untuk Anda. Sebaiknya Anda mengotomatisasi tugas pemantauan sebanyak mungkin.
Amazon Translate menyediakan grafik yang telah dikonfigurasi sebelumnya yang menunjukkan metrik terpenting untuk solusi Anda. Setiap grafik menawarkan jendela ke kinerja solusi Anda. Untuk mendapatkan pandangan berbeda tentang kinerja solusi Anda dari waktu ke waktu, Anda dapat mengubah rentang waktu yang ditampilkan grafik.
Anda juga dapat menggunakan Amazon CloudWatch untuk memantau Amazon Translate. Dengan CloudWatch, Anda dapat mengotomatiskan pemantauan metrik spesifik untuk solusi Anda. Anda menerima pemberitahuan setiap kali metrik berada di luar ambang batas yang Anda tetapkan. Anda juga dapat menggunakan CloudWatch API untuk membuat aplikasi pemantauan khusus yang sesuai dengan kebutuhan Anda. Untuk informasi selengkapnya, lihat [Apa itu Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) *di Panduan CloudWatch Pengguna Amazon*.
Tabel berikut menjelaskan setiap grafik yang telah dikonfigurasi sebelumnya yang disediakan oleh Amazon Translate.
| Grafik | Deskripsi |
| --- | --- |
| ![\[Grafik yang menunjukkan jumlah permintaan yang berhasil.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-successful-request-count.png) | Jumlah permintaan yang berhasil Jumlah permintaan yang berhasil dibuat ke Amazon Translate selama periode waktu yang ditentukan. |
| ![\[Grafik yang menunjukkan jumlah permintaan yang dibatasi.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-throttled-request-count.png) | Jumlah permintaan terbatasJumlah permintaan ke Amazon Translate yang dibatasi selama periode waktu yang ditentukan. Gunakan informasi ini untuk menentukan apakah aplikasi Anda mengirim permintaan ke Amazon Translate terlalu cepat. |
| ![\[Grafik yang menunjukkan waktu respons rata-rata.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-average-response-time.png) | Waktu respons rata-rata Rata-rata lamanya waktu yang dibutuhkan Amazon Translate untuk memproses permintaan Anda selama periode waktu yang ditentukan. |
| ![\[Grafik yang menunjukkan jumlah karakter.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-character-count.png) | Jumlah karakterJumlah total karakter yang Anda kirim ke Amazon Translate selama periode waktu yang ditentukan. Ini adalah jumlah karakter yang akan ditagih untuk Anda. |
| ![\[Grafik yang menunjukkan jumlah kesalahan pengguna.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-user-error-count.png) | Jumlah kesalahan penggunaJumlah kesalahan pengguna yang terjadi selama periode waktu yang ditentukan. Kesalahan pengguna berada di kisaran kode kesalahan HTTP 400-499. |
| ![\[Grafik yang menunjukkan jumlah kesalahan sistem.\]](http://docs.aws.amazon.com/id_id/translate/latest/dg/images/metric-system-error-count.png) | Jumlah kesalahan sistemJumlah kesalahan sistem yang terjadi selama periode waktu yang ditentukan. Kesalahan sistem berada di kisaran kode kesalahan HTTP 500-599. |
## Pemantauan Amazon Translate
Dengan Amazon CloudWatch, Anda bisa mendapatkan metrik untuk operasi Amazon Translate individual atau metrik Amazon Translate global untuk akun Anda. Gunakan metrik untuk melacak kesehatan solusi Amazon Translate Anda dan untuk mengatur alarm untuk memberi tahu Anda ketika satu atau beberapa metrik berada di luar ambang batas yang ditentukan. Misalnya, Anda dapat memantau jumlah permintaan yang dibuat ke Amazon Translate dalam periode waktu tertentu, melihat latensi permintaan, atau memunculkan alarm saat kesalahan melebihi ambang batas.
### Memahami CloudWatch metrik untuk Amazon Translate
Untuk mendapatkan metrik untuk operasi Amazon Translate, Anda menentukan informasi berikut:
+ Dimensi metrik. *Dimensi* adalah sekumpulan pasangan nama-nilai yang Anda gunakan untuk mengidentifikasi metrik. Amazon Translate memiliki dua dimensi:
+ `Operation`
+ `Language pair`
+ Nama metrik, seperti `SuccessfulRequestCount` atau`RequestCharacters`. Untuk daftar lengkap metrik, lihat [CloudWatch Metrik untuk Amazon Translate](translate-cloudwatch.md#translate-cloudwatch-metrics).
Anda bisa mendapatkan metrik untuk Amazon Translate dengan Konsol Manajemen AWS, API AWS CLI, atau CloudWatch API. Anda dapat menggunakan CloudWatch API melalui salah satu Kit Pengembangan Perangkat Lunak Amazon AWS (SDKs) atau alat CloudWatch API.
Tabel berikut mencantumkan beberapa kegunaan umum untuk CloudWatch metrik. Berikut ini adalah saran untuk memulai, bukan daftar komprehensif.
| Bagaimana cara saya? | Pantau metrik ini |
| --- | --- |
| Lacak jumlah permintaan yang berhasil | sumStatistik SuccessfulRequestCount metrik |
| Ketahui apakah aplikasi saya telah mencapai throughput maksimumnya | sumStatistik ThrottledCount metrik |
| Temukan waktu respons untuk aplikasi saya | averageStatistik ResponseTime metrik |
| Temukan jumlah kesalahan untuk aplikasi saya | sumStatistik ServerErrorCount dan UserErrorCount metrik |
| Temukan jumlah karakter yang dapat ditagih | sumStatistik CharacterCount metrik |
Anda harus memiliki CloudWatch izin yang sesuai untuk memantau Amazon Translate dengan CloudWatch Untuk informasi selengkapnya, lihat [Otentikasi dan Kontrol Akses untuk Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) di * CloudWatch Panduan Pengguna Amazon*.
### Melihat metrik Amazon Translate
Lihat metrik Amazon Translate di CloudWatch konsol.
**Untuk melihat metrik (CloudWatch konsol)**
1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. **Pilih **Metrik**, pilih **Semua Metrik**, lalu pilih AWS/Terjemahkan.**
1. Pilih dimensi, pilih nama metrik, dan pilih **Tambahkan ke grafik**.
1. Pilih nilai untuk rentang tanggal. Hitungan metrik untuk rentang tanggal yang ditentukan ditampilkan dalam grafik.
# Mencatat panggilan API Amazon Translate dengan AWS CloudTrail
Amazon Translate terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh entitas atau AWS layanan IAM di Amazon Translate. CloudTrail menangkap semua panggilan API untuk Amazon Translate sebagai peristiwa. Ini termasuk panggilan dari konsol Amazon Translate dan panggilan kode ke operasi Amazon Translate API. Jika Anda membuat CloudTrail jejak, Anda dapat mengaktifkan pengiriman acara secara berkelanjutan, termasuk CloudTrail peristiwa untuk Amazon Translate, ke bucket Amazon Simple Storage Service (Amazon S3). Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**. Anda dapat menggunakan informasi yang dikumpulkan oleh CloudTrail untuk menentukan permintaan yang dibuat ke Amazon Translate, alamat IP dari mana permintaan itu dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.
Untuk mempelajari selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
**Topics**
+ [Informasi Amazon Translate di CloudTrail](#translate-info-in-cloudtrail)
+ [Memahami entri file log Amazon Translate](#understanding-translate-entries)
## Informasi Amazon Translate di CloudTrail
CloudTrail diaktifkan di AWS akun Anda saat Anda membuat akun. Saat aktivitas terjadi di Amazon Translate, aktivitas tersebut direkam dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya dalam **riwayat Acara**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di AWS akun Anda. Untuk informasi selengkapnya, lihat [Melihat Acara dengan Riwayat CloudTrail Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Untuk catatan peristiwa yang sedang berlangsung di AWS akun Anda, termasuk acara untuk Amazon Translate, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak dengan konsol, jejak tersebut berlaku untuk semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah di partisi AWS dan mengirimkan file log ke bucket S3 yang Anda tentukan. Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:
+ [Gambaran umum untuk membuat jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [ CloudTrail Layanan dan integrasi yang didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Menerima file CloudTrail log dari beberapa tegion](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) beberapa akun
Semua tindakan Amazon Translate dicatat oleh CloudTrail dan didokumentasikan di [bagian referensi API](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html). Misalnya, panggilan ke`DeleteTerminology`, `ImportTerminology` dan `TranslateText` tindakan menghasilkan entri dalam file CloudTrail log.
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi ini membantu Anda menentukan hal berikut:
+ Apakah permintaan dibuat dengan kredensi pengguna root
+ Baik permintaan tersebut dibuat dengan kredensial keamanan sementara untuk peran atau pengguna gabungan
+ Apakah permintaan itu dibuat oleh AWS layanan lain
Untuk informasi selengkapnya, lihat [Elemen userIdentity CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Memahami entri file log Amazon Translate
*Trail* adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu.
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `TranslateText` tindakan.
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/Administrator",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "Administrator"
},
"eventTime": "2019-09-03T20:32:50Z",
"eventSource": "translate.amazonaws.com",
"eventName": "TranslateText",
"awsRegion": "us-west-2",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197",
"requestParameters": {
"text": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"responseElements": {
"translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"requestID": "f56da956-284e-4983-b6fc-59befa20e2bf",
"eventID": "1dc75278-84d7-4bb2-861a-493d08d67391",
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# CloudWatch metrik dan dimensi untuk Amazon Translate
Untuk memantau performa solusi Anda, gunakan CloudWatch metrik dan dimensi Amazon untuk Amazon Translate.
## CloudWatch Metrik untuk Amazon Translate
| Metrik | Deskripsi |
| --- | --- |
| CharacterCount | Jumlah karakter yang dapat ditagih dalam permintaan. Dimensi yang valid: Pasangan bahasa, Operasi Statistik yang valid: Rata-rata, Maksimum, Minimum, Jumlah Unit: Jumlah |
| ResponseTime | Waktu yang dibutuhkan untuk menanggapi permintaan. Dimensi yang valid: Pasangan bahasa, Operasi Statistik yang valid: Sampel data, Rata-rata Satuan: Untuk sampel Data, hitung. Untuk statistik Rata-rata, milidetik. |
| ServerErrorCount | Jumlah kesalahan server. Rentang kode respons HTTP untuk kesalahan server adalah 500 hingga 599. Dimensi yang valid: Operasi Statistik yang valid: Rata-rata, Jumlah Unit: Jumlah |
| SuccessfulRequestCount | Jumlah permintaan terjemahan yang berhasil. Kode respons untuk permintaan yang berhasil adalah 200 hingga 299. Dimensi yang valid: Operasi Statistik yang valid: Rata-rata, Jumlah Unit: Jumlah |
| ThrottledCount | Jumlah permintaan tunduk pada pembatasan. Gunakan `ThrottledCount` untuk menentukan apakah aplikasi Anda mengirim permintaan ke Amazon Translate lebih cepat daripada akun Anda yang dikonfigurasi untuk menerimanya. Untuk informasi selengkapnya, lihat [Batas Amazon Translate](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate) di *Referensi Umum Amazon Web*. Dimensi yang valid: Operasi Statistik yang valid: Rata-rata, Jumlah Unit: Jumlah |
| UserErrorCount | Jumlah kesalahan pengguna yang terjadi. Rentang kode respons HTTP untuk kesalahan pengguna adalah 400 hingga 499. Dimensi yang valid: Operasi Statistik yang valid: Rata-rata, Jumlah Unit: Jumlah |
## CloudWatch Dimensi untuk Amazon Translate
Gunakan dimensi berikut untuk memfilter metrik Amazon Translate. Metrik dikelompokkan berdasarkan bahasa sumber dan bahasa target.
| Dimensi | Deskripsi |
| --- | --- |
| LanguagePair | Membatasi metrik hanya untuk yang berisi bahasa tertentu. |
| Operation | Membatasi metrik hanya untuk metrik dengan operasi yang ditentukan. |
# Memantau peristiwa Amazon Translate dengan Amazon EventBridge
Amazon Translate terintegrasi dengan Amazon EventBridge untuk memberi tahu Anda tentang perubahan yang memengaruhi pekerjaan terjemahan dan sumber daya data paralel Anda. Acara dari AWS layanan dikirimkan ke EventBridge dalam waktu dekat. Anda dapat menulis aturan sederhana untuk menunjukkan kejadian mana yang sesuai kepentingan Anda, dan tindakan otomatis apa yang diambil ketika suatu kejadian sesuai dengan suatu aturan. Misalnya, tindakan yang dapat dimulai secara otomatis meliputi:
+ Memanggil fungsi AWS Lambda
+ Memanggil AWS Systems Manager Run Command
+ Mengirim peristiwa ke Amazon Kinesis Data Streams
+ Mengaktifkan mesin AWS Step Functions negara
+ Memberi tahu topik Amazon SNS atau antrean Amazon SQS
Untuk informasi selengkapnya, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) di *Panduan EventBridge Pengguna Amazon*.
## Acara Amazon Translate
Berikut ini adalah contoh peristiwa dari Amazon Translate.
### Acara untuk pekerjaan terjemahan batch
Anda menjalankan tugas terjemahan batch dengan menggunakan konsol Amazon Translate atau [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)operasinya. Amazon Translate mengirimkan acara ketika pekerjaan ini selesai, baik berhasil atau tidak berhasil. Peristiwa ini menyerupai contoh berikut.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate TextTranslationJob State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [],
"detail": {
"jobId": "01234567-0123-0123-0123-012345678901",
"jobStatus": "STATUS"
}
}
```
Nilai untuk `jobStatus` atribut bergantung pada status pekerjaan tempat Amazon Translate mengirim acara tersebut. `jobStatus`Nilai-nilainya adalah:
+ `COMPLETED`— Pekerjaan telah berhasil diselesaikan dan output tersedia.
+ `COMPLETED_WITH_ERROR`— Pekerjaan telah selesai dengan kesalahan. Kesalahan dapat dianalisis dalam output pekerjaan.
+ `STOPPED`Pekerjaan telah dihentikan.
+ `FAILED`Pekerjaan itu tidak selesai. Untuk mendapatkan detail, gunakan [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)operasi.
### Acara untuk sumber daya data paralel
Saat Anda menggunakan Amazon Translate untuk membuat atau memperbarui sumber daya data paralel, ia akan mengirimkan peristiwa untuk menunjukkan apakah operasi berhasil atau gagal.
Anda membuat sumber daya data paralel dengan menggunakan konsol Amazon Translate atau [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)operasinya. Saat Anda melakukan ini, Amazon Translate mengirimkan acara seperti berikut ini.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "CreateParallelData",
"name": "ExampleParallelData",
"status": "STATUS"
}
}
```
Nilai untuk `status` atribut adalah:
+ `ACTIVE`— `CreateParallelData ` Operasi berhasil, dan sumber daya siap untuk Anda gunakan.
+ `FAILED``CreateParallelData`Operasi gagal.
Anda memperbarui sumber daya data paralel dengan menggunakan konsol Amazon Translate atau [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)operasinya. Saat Anda melakukan ini, Amazon Translate mengirimkan acara seperti berikut ini.
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "UpdateParallelData",
"name": "ExampleParallelData",
"status": "STATUS",
"latestUpdateAttemptStatus": "STATUS",
"latestUpdateAttemptAt": "2017-04-22T03:31:47Z"
}
}
```
`status`Atribut menyediakan status versi sebelumnya dari sumber daya data paralel, yang sedang digantikan oleh pembaruan. Nilainya adalah:
+ `ACTIVE`— Versi sebelumnya berhasil dibuat atau diperbarui.
+ `FAILED`— Versi sebelumnya gagal dibuat atau diperbarui.
`latestUpdateAttemptStatus`Atribut menyediakan status versi baru dari sumber daya data paralel, yang sedang dibuat oleh pembaruan. Nilainya adalah:
+ `ACTIVE`— `UpdateParallelData` Operasi berhasil, dan sumber daya yang diperbarui siap untuk Anda gunakan.
+ `FAILED``UpdateParallelData`Operasi gagal.