Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Pemantauan Amazon Transcribe Pemantauan adalah bagian penting dari menjaga keandalan, ketersediaan, dan kinerja Amazon Transcribe dan AWS solusi Anda yang lain. AWS menyediakan alat pemantauan berikut untuk menonton Amazon Transcribe, melaporkan ketika ada sesuatu yang salah, dan mengambil tindakan otomatis bila perlu: + **Amazon CloudWatch**memantau AWS sumber daya Anda dan aplikasi yang Anda jalankan AWS secara real time. Anda dapat mengumpulkan dan melacak metrik, membuat dasbor yang disesuaikan, dan mengatur alarm yang memberi tahu Anda atau mengambil tindakan saat metrik tertentu mencapai ambang batas yang ditentukan. Misalnya, Anda dapat CloudWatch melacak penggunaan CPU atau metrik lain pada Amazon EC2 instans Anda dan secara otomatis meluncurkan instance baru bila diperlukan. + **Amazon CloudWatch Logs**dapat memantau, menyimpan, dan mengakses file log Anda dari Amazon EC2 instance, CloudTrail, dan sumber lainnya. CloudWatch Logs dapat memantau informasi dalam file log dan memberi tahu Anda ketika ambang batas tertentu terpenuhi. Anda juga dapat mengarsipkan data log dalam penyimpanan yang sangat durabel. + **AWS CloudTrail**menangkap panggilan API dan peristiwa terkait yang dibuat oleh atau atas nama Anda Akun AWS dan mengirimkan file log ke Amazon S3 bucket yang Anda tentukan. Anda dapat mengidentifikasi pengguna dan akun mana yang dipanggil AWS, alamat IP sumber dari mana panggilan dilakukan, dan kapan panggilan terjadi. Untuk informasi selengkapnya, silakan lihat *Panduan Pengguna [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)*. **Amazon EventBridge**adalah layanan tanpa server yang menggunakan peristiwa untuk menghubungkan komponen aplikasi bersama-sama, sehingga memudahkan Anda untuk membangun aplikasi berbasis peristiwa yang dapat diskalakan. EventBridge memberikan aliran data real-time dari aplikasi Anda sendiri, aplikasi Perangkat Lunak sebagai Layanan (SaaS), AWS dan layanan serta rute data tersebut ke target seperti. Lambda Anda dapat memantau peristiwa yang terjadi di layanan, dan membangun arsitektur berbasis peristiwa. Untuk informasi selengkapnya, silakan lihat *Panduan Pengguna [Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)*. **Topics** + [Pemantauan Amazon Transcribe dengan Amazon CloudWatch](monitoring-cloudwatch.md) + [Pemantauan Amazon Transcribe dengan AWS CloudTrail](monitoring-transcribe-cloud-trail.md) + [Menggunakan Amazon EventBridge dengan Amazon Transcribe](monitoring-events.md) # Pemantauan Amazon Transcribe dengan Amazon CloudWatch Anda dapat memantau Amazon Transcribe penggunaan CloudWatch, yang mengumpulkan data mentah dan memprosesnya menjadi metrik yang dapat dibaca, mendekati waktu nyata. Statistik ini disimpan untuk jangka waktu 15 bulan, sehingga Anda dapat mengakses informasi historis dan mendapatkan perspektif yang lebih baik tentang performa aplikasi atau layanan web Anda. Anda juga dapat mengatur alarm yang memperhatikan ambang batas tertentu dan mengirim notifikasi atau mengambil tindakan saat ambang batas tersebut terpenuhi. Untuk informasi selengkapnya, silakan lihat [Panduan Pengguna *CloudWatch *](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html). ## Menggunakan Amazon CloudWatch metrik dan dimensi dengan Amazon Transcribe Amazon Transcribe mendukung CloudWatch metrik dan dimensi, yang merupakan data yang dapat membantu Anda memantau kinerja. Kategori metrik yang didukung mencakup lalu lintas, kesalahan, transfer data, dan latensi yang terkait dengan pekerjaan transkripsi Anda. Metrik yang didukung terletak di namespace CloudWatch **AWS/Transcribe**. **catatan** CloudWatch Metrik pemantauan tidak dipungut biaya dan tidak dihitung terhadap kuota CloudWatch layanan. Untuk informasi selengkapnya tentang CloudWatch metrik, lihat [Menggunakan Amazon CloudWatch metrik](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). **CloudWatch metrik untuk Amazon Transcribe** | Metrik | Jenis Layanan | Deskripsi | | --- | --- | --- | | TotalRequestCount | batch, streaming | Menunjukkan jumlah transaksi. Merupakan semua permintaan yang berhasil dan tidak berhasil yang dibuat untuk Transcribe. **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**: `Domain``ServiceType`,,`Operation`, `LanguageCode` | | SuccessfulRequestCount | batch | Menunjukkan jumlah permintaan yang berhasil. Rentang kode respons untuk permintaan yang berhasil adalah 200-299. **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | SyncServerErrorCount | batch | Menunjukkan jumlah kesalahan server. Rentang kode respons untuk kesalahan server adalah 500-599. **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | SyncUserErrorCount | batch | Menampilkan jumlah kesalahan pengguna, seperti parameter, file, dan izin yang tidak valid, dan kesalahan pelambatan. Rentang kode respons untuk kesalahan pengguna adalah 400-499. **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | ThrottledCount | batch, streaming | Menunjukkan jumlah permintaan yang mengembalikan **LimitExceededException**hasil dari kuota tingkat transaksi yang terlampaui. Amazon Transcribe membatasi jumlah permintaan yang dapat dilakukan pelanggan per detik. Jika batas kuota yang ditetapkan untuk Anda sering Akun AWS terlampaui, Anda dapat meminta kenaikan kuota. Untuk meminta kenaikan, lihat [Layanan AWS kuota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | LimitExceededCount | batch, streaming | Menunjukkan jumlah permintaan yang mengembalikan **LimitExceededException**hasil dari kuota non-tarif yang terlampaui. Amazon Transcribe membatasi jumlah pekerjaan bersamaan, jumlah total transkripsi, ukuran file audio maksimum, dll. Jika batas yang ditetapkan untuk Anda sering Akun AWS terlampaui, Anda dapat meminta kenaikan kuota. Untuk meminta kenaikan, lihat [Layanan AWS kuota](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | AsyncUserErrorCount | batch | Jumlah kesalahan pengguna asinkron (backend), seperti: format audio yang diberikan tidak cocok dengan yang terdeteksi, laju sampel tidak valid, kesalahan akses pelanggan. Amazon S3 **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` **Operasi**:`StartCallAnalyticsJob`,`StartMedicalTranscriptionJob`,`StartTranscriptionJob`,`CreateMedicalVocabulary`,`CreateVocabulary`,`UpdateMedicalVocabulary`, `UpdateVocabulary` | | AsyncServerErrorCount | batch | Jumlah kesalahan server asinkron (backend) atau, lebih khusus lagi, kesalahan pemrosesan pengenalan suara otomatis (ASR). **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` **Operasi**:`StartCallAnalyticsJob`,`StartMedicalTranscriptionJob`,`StartTranscriptionJob`,`CreateMedicalVocabulary`,`CreateVocabulary`,`UpdateMedicalVocabulary`, `UpdateVocabulary` | | AudioDurationTime | batch | Panjang, dalam hitungan detik, file audio atau video. **Satuan**: detik **Statistik Relevan**: rata-rata, minimum, maksimum **Dimensi yang Valid**:`Domain`,`ServiceType`, `LanguageCode` | | ConcurrentStreamsCount | streaming | Menunjukkan jumlah aliran bersamaan yang saat ini sedang diproses. **Satuan**: hitung **Statistik Relevan**: rata-rata, maksimum **Dimensi yang Valid**:`Domain`, `ServiceType` | | ConcurrentPostStreamJobsCount | streaming | Menunjukkan jumlah analitik AWS HealthScribe pasca-aliran bersamaan yang saat ini sedang diproses. **Satuan**: hitung **Statistik Relevan**: rata-rata, maksimum **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | | PostStreamJobLimitExceededCount | streaming | Menampilkan jumlah permintaan yang mengembalikan `LimitExceededException` hasil dari kuota terlampaui pada batas pekerjaan post stream bersamaan. **Satuan**: hitung **Statistik Relevan**: jumlah, rata-rata **Dimensi yang Valid**:`Domain`,`ServiceType`, `Operation` | **CloudWatch dimensi untuk Amazon Transcribe** | Dimensi | Deskripsi | | --- | --- | | Domain | Hanya menampilkan metrik dengan tipe Transcribe yang ditentukan. **Opsi yang Valid**: Transcribe, Transcribe Medical, Transcribe Call Analytics | | ServiceType | Hanya menampilkan metrik dengan jenis layanan yang ditentukan. **Opsi yang Valid**: batch | | Operation | Hanya menampilkan metrik dengan operasi yang ditentukan. **Opsi yang Valid**: Amazon Transcribe API apa pun | | LanguageCode | Hanya menampilkan metrik dengan bahasa yang ditentukan. **Opsi yang Valid**: kode bahasa yang valid, dalam bentuk `en-US` | # Pemantauan Amazon Transcribe dengan AWS CloudTrail Amazon Transcribe terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil Amazon Transcribe oleh AWS Identity and Access Management (IAM) pengguna atau peran, atau oleh AWS layanan. CloudTrail menangkap semua panggilan API untuk Amazon Transcribe. Itu termasuk panggilan dari Konsol Manajemen AWS dan panggilan kode ke Amazon Transcribe APIs, sebagai acara. Dengan membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara yang berkelanjutan, termasuk acara untuk Amazon Transcribe, ke Amazon S3 ember. Jika Anda tidak membuat jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail Konsol Manajemen AWS dalam **Sejarah acara**. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat melihat setiap permintaan yang dibuat Amazon Transcribe, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan. Untuk mempelajari selengkapnya CloudTrail, lihat [https://docs.aws.amazon.com/awscloudtrail/latest/userguide/](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Amazon Transcribe dan CloudTrail CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas terjadi Amazon Transcribe, aktivitas tersebut dicatat dalam suatu CloudTrail peristiwa bersama dengan Layanan AWS peristiwa lain dalam **sejarah CloudTrail Peristiwa**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di situs Anda Akun AWS. Untuk informasi lain, lihat [Melihat Peristiwa dengan Riwayat Peristiwa CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Untuk mendapatkan catatan acara yang sedang berlangsung di Anda Akun AWS, termasuk acara untuk Amazon Transcribe, buat jejak. *Trail* adalah konfigurasi yang memungkinkan CloudTrail untuk mengirimkan peristiwa sebagai file log ke Amazon S3 bucket tertentu. CloudTrail file log berisi satu atau lebih entri log. *Peristiwa* menunjukkan satu permintaan dari sumber mana pun. Ini 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. Secara default, saat Anda membuat jejak di Konsol Manajemen AWS, jejak berlaku untuk semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah AWS di AWS partisi dan mengirimkan file log ke Amazon S3 bucket yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi lainnya Layanan AWS untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi lebih lanjut, lihat: + [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) + [Mengkonfigurasi Amazon SNS Pemberitahuan untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Menerima File Log CloudTrail dari Beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima File Log CloudTrail dari Beberapa Akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) CloudTrail mencatat semua Amazon Transcribe tindakan, yang didokumentasikan dalam [Referensi API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html). Misalnya, [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html), dan [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)operasi menghasilkan entri dalam file CloudTrail log. Saat CloudTrail mencatat operasi Amazon Transcribe API, entri CloudTrail log menggunakan string kosong untuk informasi sensitif dalam parameter permintaan dan respons, seperti nilai Amazon S3 URI. Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi ini membantu Anda menentukan hal berikut: + Apakah permintaan dibuat dengan root atau kredensi IAM pengguna + Apakah permintaan dibuat dengan kredensi keamanan sementara untuk IAM peran atau pengguna gabungan + Apakah permintaan dibuat oleh orang lain Layanan AWS Untuk informasi lain, lihat [Elemen userIdentity CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). Anda juga dapat menggabungkan file Amazon Transcribe log dari beberapa Wilayah AWS dan beberapa Akun AWS ke dalam satu Amazon S3 bucket. Untuk informasi selengkapnya, lihat [Menerima File CloudTrail Log dari Beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima File CloudTrail Log dari Beberapa Akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html). ### Contoh: entri file Amazon Transcribe log *Trail* adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke Amazon S3 bucket tertentu. CloudTrail file log berisi satu atau lebih entri log. *Peristiwa* menunjukkan satu permintaan dari sumber mana pun. Ini mencakup informasi tentang tindakan yang diminta sebagai tanggal dan waktu tindakan, dan parameter permintaan. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu. Panggilan ke operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)dan [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html)API membuat entri berikut. **catatan** Saat CloudTrail mencatat operasi Amazon Transcribe API, entri CloudTrail log menggunakan string kosong untuk informasi sensitif dalam parameter permintaan dan respons, seperti nilai Amazon S3 URI. ``` { "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "111122223333", "arn": "arn:aws:iam:us-west-2:111122223333:user/my-user-name", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "my-user-name" }, "eventTime": "2022-03-07T15:03:45Z", "eventSource": "transcribe.amazonaws.com", "eventName": "StartTranscriptionJob", "awsRegion": "us-west-2", "sourceIPAddress": "127.0.0.1", "userAgent": "[]", "requestParameters": { "mediaFormat": "flac", "languageCode": "en-US", "transcriptionJobName": "my-first-transcription-job", "media": { "mediaFileUri": "" } }, "responseElements": { "transcriptionJob": { "transcriptionJobStatus": "IN_PROGRESS", "mediaFormat": "flac", "creationTime": "2022-03-07T15:03:44.229000-08:00", "transcriptionJobName": "my-first-transcription-job", "languageCode": "en-US", "media": { "mediaFileUri": "" } } }, "requestID": "47B8E8D397DCE7A6", "eventID": "cdc4b7ed-e171-4cef-975a-ad829d4123e8", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" }, { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "111122223333", "arn": "arn:aws:iam:us-west-2:111122223333:user/my-user-name", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "my-user-name" }, "eventTime": "2022-03-07T15:07:11Z", "eventSource": "transcribe.amazonaws.com", "eventName": "GetTranscriptionJob", "awsRegion": "us-west-2", "sourceIPAddress": "127.0.0.1", "userAgent": "[]", "requestParameters": { "transcriptionJobName": "my-first-transcription-job" }, "responseElements": { "transcriptionJob": { "settings": { }, "transcriptionJobStatus": "COMPLETED", "mediaFormat": "flac", "creationTime": "2022-03-07T15:03:44.229000-08:00", "transcriptionJobName": "my-first-transcription-job", "languageCode": "en-US", "media": { "mediaFileUri": "" }, "transcript": { "transcriptFileUri": "" } } }, "requestID": "BD8798EACDD16751", "eventID": "607b9532-1423-41c7-b048-ec2641693c47", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ] } ``` # Menggunakan Amazon EventBridge dengan Amazon Transcribe Dengan Amazon EventBridge, Anda dapat menanggapi perubahan status dalam Amazon Transcribe pekerjaan Anda dengan memulai acara di tempat lain Layanan AWS. Saat pekerjaan transkripsi berubah status, EventBridge secara otomatis mengirimkan peristiwa ke aliran peristiwa. Anda membuat aturan yang menentukan peristiwa yang ingin Anda pantau dalam aliran peristiwa dan tindakan yang EventBridge harus diambil ketika peristiwa tersebut terjadi. Misalnya, merutekan acara ke layanan lain (atau target), yang kemudian dapat mengambil tindakan. Anda dapat, misalnya, mengonfigurasi aturan untuk merutekan acara ke AWS Lambda fungsi saat pekerjaan transkripsi berhasil diselesaikan. Untuk menentukan [EventBridge aturan](#defining-rules), lihat bagian berikut. Anda dapat menerima pemberitahuan untuk acara melalui beberapa saluran, termasuk email, [Pengembang Amazon Q dalam pemberitahuan obrolan aplikasi](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) obrolan, atau pemberitahuan [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Anda juga dapat melihat notifikasi di [Pusat Notifikasi Konsol](https://console.aws.amazon.com/notifications/). Jika Anda ingin mengatur notifikasi, Anda dapat menggunakannya [Notifikasi Pengguna AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). Notifikasi Pengguna AWS mendukung agregasi, yang dapat mengurangi jumlah notifikasi yang Anda terima selama acara tertentu. ## Mendefinisikan aturan EventBridge Untuk menentukan EventBridge aturan, gunakan [Konsol Manajemen AWS](https://console.aws.amazon.com/events). Saat Anda menentukan aturan, gunakan Amazon Transcribe sebagai nama layanan. Untuk contoh cara membuat EventBridge aturan, lihat [Amazon EventBridge aturan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). Sebelum menggunakan EventBridge, perhatikan definisi berikut: + **Peristiwa** —Sebuah peristiwa menunjukkan perubahan status salah satu pekerjaan transkripsi Anda. Misalnya, ketika `TranscriptionJobStatus` suatu pekerjaan berubah dari `IN_PROGRESS` ke`COMPLETED`. + **Target** — Target adalah target lain Layanan AWS yang memproses suatu peristiwa. Misalnya, AWS Lambda atau Amazon Simple Notification Service (Amazon SNS). Target menerima peristiwa dalam format JSON. + **Aturan** —Aturan cocok dengan peristiwa masuk yang EventBridge ingin Anda perhatikan dan merutekkannya ke target atau target untuk diproses. Jika aturan merutekan peristiwa ke beberapa target, semua target memproses peristiwa secara paralel. Aturan dapat menyesuaikan JSON yang dikirim ke target. Amazon EventBridge peristiwa dipancarkan atas dasar upaya terbaik. Untuk informasi selengkapnya tentang membuat dan mengelola acara di EventBridge, lihat [Amazon EventBridge acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan Amazon EventBridge Pengguna*. Berikut ini adalah contoh EventBridge aturan untuk Amazon Transcribe itu dimulai ketika status pekerjaan transkripsi berubah menjadi `COMPLETED` atau. `FAILED` ``` { "source": [ "aws.transcribe" ], "detail-type": [ "Transcribe Job State Change" ], "detail": { "TranscriptionJobStatus": [ "COMPLETED", "FAILED" ] } } ``` Aturan berisi bidang-bidang berikut: + `source`—Sumber acara. Karena Amazon Transcribe, ini selalu`aws.transcribe`. + `detail-type`—Pengidentifikasi untuk detail acara. Karena Amazon Transcribe, ini selalu`Transcribe Job State Change`. + `detail`—Status pekerjaan baru dari pekerjaan transkripsi. Dalam contoh ini, aturan memulai peristiwa ketika status pekerjaan berubah menjadi `COMPLETED` atau`FAILED`. ## Amazon Transcribe acara Amazon EventBridge mencatat beberapa Amazon Transcribe peristiwa: + [Acara pekerjaan transkripsi](#job-event) + [Acara identifikasi bahasa](#lang-id-event) + [Acara Panggilan Analytics](#analytics-event) + [Panggilan acara pasca-panggilan Analytics](#analytics-stream-event) + [Acara kosakata](#vocab-event) Semua peristiwa ini berisi bidang bersama berikut: + `version`: Versi data acara. Nilai ini selalu `0`. + `id`: Pengidentifikasi unik yang dihasilkan oleh EventBridge untuk acara tersebut. + `detail-type`: Pengenal untuk rincian acara. Misalnya, `Transcribe Job State Change`. + `source`: Sumber acara. Untuk Amazon Transcribe ini selalu`aws.transcribe`. + `account`: Akun AWS ID akun yang menghasilkan panggilan API. + `time`: Tanggal dan waktu acara disampaikan. + `region`: Wilayah AWS Di mana permintaan dibuat. + `resources`: Sumber daya yang digunakan oleh panggilan API. Karena Amazon Transcribe, bidang ini selalu kosong. + `detail`: Detail tambahan tentang acara tersebut. + `FailureReason`: Bidang ini hadir jika status atau status berubah`FAILED`, dan menjelaskan alasan untuk `FAILED` status atau status. + Setiap jenis acara memiliki bidang unik tambahan yang ditampilkan di bawah`detail`. Bidang unik ini didefinisikan dalam bagian berikut setelah setiap contoh peristiwa. ### Acara pekerjaan transkripsi Ketika status pekerjaan berubah dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan yang mengubah status dan memulai acara di target Anda, gunakan `TranscriptionJobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status pekerjaan transkripsi Anda. `FAILED` Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)API. ``` { "version": "0", "id": "event ID", "detail-type":"Transcribe Job State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "TranscriptionJobName": "my-first-transcription-job", "TranscriptionJobStatus": "COMPLETED" (or "FAILED") } } ``` + `TranscriptionJobName`: Nama unik yang Anda pilih untuk pekerjaan transkripsi Anda. + `TranscriptionJobStatus `: Status pekerjaan transkripsi. Ini bisa `COMPLETED` atau`FAILED`. ### Acara identifikasi bahasa Saat Anda mengaktifkan [identifikasi bahasa otomatis](lang-id.md) Amazon Transcribe , buat peristiwa saat status identifikasi bahasa adalah `COMPLETED` atau`FAILED`. Untuk mengidentifikasi pekerjaan yang mengubah status dan memulai acara di target Anda, gunakan `JobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status identifikasi bahasa Anda`FAILED`. Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)API saat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html)parameter disertakan. ``` { "version": "0", "id": "event ID", "detail-type": "Language Identification State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "JobType": "TranscriptionJob", "JobName": "my-first-lang-id-job", "LanguageIdentificationStatus": "COMPLETED" (or "FAILED") } } ``` + `JobType`: Untuk pekerjaan transkripsi, nilai ini harus`TranscriptionJob`. + `JobName`: Nama unik dari pekerjaan transkripsi Anda. + `LanguageIdentificationStatus`: Status identifikasi bahasa dalam pekerjaan transkripsi. Ini bisa `COMPLETED` atau`FAILED`. ### Acara Panggilan Analytics Ketika status pekerjaan [Call Analytics](call-analytics.md) berubah dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan Analytics Panggilan yang mengubah status dan memulai acara di target Anda, gunakan `JobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Kolom ditambahkan di bawah `detail` jika status pekerjaan Call Analytics Anda`FAILED`. Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)API. ``` { "version": "0", "id": "event ID", "detail-type": "Call Analytics Job State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "JobName": "my-first-analytics-job", "JobStatus": "COMPLETED" (or "FAILED"), "FailureReason": "failure reason", // only present when JobStatus is FAILED "AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization "Skipped": [] } } } ``` + `JobName`: Nama unik dari pekerjaan transkripsi Call Analytics Anda. + `JobStatus`: Status pekerjaan transkripsi Call Analytics Anda. Ini bisa salah satu `COMPLETED` atau`FAILED`. + `FailureReason`: Bidang ini hadir hanya ketika `JobStatus` ada`FAILED`, dan menjelaskan alasan kegagalan. + `AnalyticsJobDetails`: Detail pekerjaan transkripsi Call Analytics Anda, termasuk informasi tentang fitur analitik yang dilewati. ### Panggilan acara pasca-panggilan Analytics Saat transkripsi [analitik pasca-panggilan](tca-post-call.md) mengubah status dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan pasca-panggilan Analytics Panggilan yang mengubah status dan memulai acara di target Anda, gunakan bidang acara. `StreamingSessionId` Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)API saat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html)parameter disertakan. Sebuah `COMPLETED` acara berisi informasi berikut: ``` { "version": "0", "id": "event ID", "detail-type": "Call Analytics Post Call Job State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "StreamingSessionId": "session-id", "PostCallStatus": "COMPLETED", "Transcript": { "RedactedTranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.JSON", "TranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON" }, "Media": { "MediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV", "RedactedMediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV" } } } ``` Sebuah `FAILED` acara berisi informasi berikut: ``` { "version": "0", "id": "event ID", "detail-type": "Call Analytics Post Call Job State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "StreamingSessionId": "session-id", "PostCallStatus": "FAILED" } } ``` + `StreamingSessionId`: Nomor identifikasi yang ditetapkan untuk permintaan transkripsi Call Analytics real-time Anda. + `PostCallStatus`: Status transkripsi Analytics Panggilan pasca-panggilan Anda. Ini bisa salah satu `COMPLETED` atau`FAILED`. + `Transcript`: URI transkrip Anda yang disunting dan tidak disunting. + `Media`: URI file audio Anda yang disunting dan tidak disunting. ### AWS HealthScribe acara analitik pasca aliran Ketika status berubah untuk operasi analitik AWS HealthScribe pasca-aliran, seperti [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)perubahan dari `IN_PROGRESS` ke`COMPLETED`, AWS HealthScribe menghasilkan peristiwa dengan informasi berikut: ``` { "version":"0", "id":"event ID", "detail-type":"MedicalScribe Post Stream Analytics Update", "source":"aws.transcribe", "account":"111122223333", "time":"timestamp", "region":"us-east-1", "resources":[], "detail":{ "SessionId": , "UpdateType": "ClinicalNoteGenerationResult", "ClinicalNoteGenerationResult": { "ClinicalNoteOutputLocation": s3://amzn-s3-demo-bucket/clinical-note-output-files/clinical-notes.JSON, "TranscriptOutputLocation": s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON, "Status": , "FailureReason": } } } ``` + `UpdateType`: Jenis operasi analitik pasca-aliran yang menghasilkan acara. Isi objek hasil bervariasi tergantung pada`UpdateType`. + `SessionId`: Nomor identifikasi untuk AWS HealthScribe streaming Anda. Gunakan ID ini untuk mengidentifikasi sesi streaming yang berasal dan kemudian temukan analitik pasca-aliran yang menghasilkan acara. + `Status`: Status operasi analitik pasca-aliran. Ini dapat berupa `IN_PROGRESS`, `COMPLETED`, atau `FAILED`. + `ClinicalNoteOutputLocation`: URI dari bucket Amazon S3 keluaran untuk. `ClinicalNoteGenerationResult` + `TranscriptOutputLocation`: URI transkrip Anda. ### Acara kosakata Ketika status [kosakata kustom](custom-vocabulary.md) berubah dari `PENDING` ke `READY` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi kosakata khusus yang mengubah status dan memulai acara di target Anda, gunakan bidang acara. `VocabularyName` Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status kosakata kustom Anda. `FAILED` **catatan** Peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)API. ``` { "version": "0", "id": "event ID", "detail-type": "Vocabulary State Change", "source": "aws.transcribe", "account": "111122223333", "time": "timestamp", "region": "us-west-2", "resources": [], "detail": { "VocabularyName": "unique-vocabulary-name", "VocabularyState": "READY" (or "FAILED") } } ``` + `VocabularyName`: Nama unik kosakata kustom Anda. + `VocabularyState`: Status pemrosesan kosakata kustom Anda. Ini bisa `READY` atau`FAILED`.