翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # モニタリング Amazon Transcribe モニタリングは、 およびその他の Amazon Transcribe AWS ソリューションの信頼性、可用性、パフォーマンスを維持する上で重要な部分です。 AWS には、監視 Amazon Transcribe、問題発生時の報告、必要に応じて自動アクションを実行するための以下のモニタリングツールが用意されています。 + **Amazon CloudWatch** は、 リソースと で実行しているアプリケーションを AWS リアルタイムでモニタリングします AWS 。メトリクスを収集および追跡し、カスタマイズされたダッシュボードを作成し、指定されたメトリックが指定したしきい値に達したときに通知またはアクションを実行するアラームを設定できます。たとえば、 で Amazon EC2 インスタンスの CPU 使用率やその他のメトリクス CloudWatch を追跡し、必要に応じて新しいインスタンスを自動的に起動できます。 + **Amazon CloudWatch Logs** は、 Amazon EC2 インスタンスやその他のソースからログファイルをモニタリング、保存 CloudTrail、およびアクセスできます。 CloudWatch Logs は、ログファイル内の情報をモニタリングし、特定のしきい値に達したときに通知できます。高い耐久性を備えたストレージにログデータをアーカイブすることもできます。 + **AWS CloudTrail** は、 によって、または に代わって行われた API コールおよび関連イベントをキャプチャ AWS アカウント し、指定した Amazon S3 バケットにログファイルを配信します。呼び出し元のユーザーとアカウント AWS、呼び出し元の送信元 IP アドレス、呼び出しの発生日時を特定できます。 詳細については、「*[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)*」を参照してください。 **Amazon EventBridge** は、イベントを使用してアプリケーションコンポーネントを接続するサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。 は、独自のアプリケーション、Software as a Service (SaaS) アプリケーション、および AWS のサービスからリアルタイムデータのストリームを EventBridge 配信し、そのデータを などのターゲットにルーティングします Lambda。サービスで発生したイベントをモニタリングし、イベント駆動型アーキテクチャを構築できます。詳細については、「*[Amazon EventBridge ユーザーガイド](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)*」を参照してください。 **Topics** + [Amazon Transcribe によるモニタリング Amazon CloudWatch](monitoring-cloudwatch.md) + [Amazon Transcribe によるモニタリング AWS CloudTrail](monitoring-transcribe-cloud-trail.md) + [での Amazon EventBridge の使用Amazon Transcribe](monitoring-events.md) # Amazon Transcribe によるモニタリング Amazon CloudWatch Amazon Transcribe を使用して をモニタリングすることで CloudWatch、未加工データを収集し、読み取り可能なほぼリアルタイムのメトリクスに加工できます。これらの統計は 15 か月間保持されるため、履歴情報にアクセスし、ウェブアプリケーションまたはサービスの動作をより的確に把握できます。また、特定のしきい値を監視するアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については[https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)を参照してください。 ## での Amazon CloudWatch メトリクスとディメンションの使用 Amazon Transcribe Amazon Transcribe は、パフォーマンスのモニタリングに役立つデータである CloudWatch メトリクスとディメンションをサポートしています。サポートされているメトリクスカテゴリには、文字起こしジョブに関連するトラフィック、エラー、データ転送、レイテンシーなどがあります。サポートされているメトリクスは、**AWS/Transcribe** 名前空間 CloudWatch の を介して配置されます。 **注記** CloudWatch モニタリングメトリクスは無料で、 CloudWatch サービスクォータにはカウントされません。 CloudWatch メトリクスの詳細については、[Amazon CloudWatch 「メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)」を参照してください。 **CloudWatch の メトリクス Amazon Transcribe** | メトリクス | サービスタイプ | 説明 | | --- | --- | --- | | TotalRequestCount | バッチ、ストリーミング | トランザクションの数を示します。Transcribe へのリクエストの成功と失敗をすべて表します。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation`、`LanguageCode` | | SuccessfulRequestCount | バッチ | 成功したリクエストの数を示します。成功したリクエストのレスポンスコード範囲は 200〜299 です。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | SyncServerErrorCount | バッチ | サーバーエラーの数を示します。サーバーエラーのレスポンスコード範囲は 500〜599 です。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | SyncUserErrorCount | バッチ | パラメーター、ファイル、アクセス許可などの無効なユーザーエラーの数や、スロットリングエラーの数が表示されます。ユーザーエラーのレスポンスコード範囲は 400〜499 です。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | ThrottledCount | バッチ、ストリーミング | トランザクションレートのクォータを超えたために **LimitExceededException** を返すリクエストの数を表示します。 は、顧客が 1 秒あたりに実行できるリクエストの数 Amazon Transcribe を制限します。に設定されたクォータ制限を頻繁に超える場合 AWS アカウント は、クォータの引き上げをリクエストできます。引き上げをリクエストするには、「[AWS のサービス クォータ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)」を参照してください。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | LimitExceededCount | バッチ、ストリーミング | レート以外のクォータを超えたために **LimitExceededException** を返すリクエストの数を表示します。同時ジョブの数、文字起こしの合計数、最大オーディオファイルサイズなど Amazon Transcribe を制限します。に設定された制限を頻繁に超える場合 AWS アカウント は、クォータの引き上げをリクエストできます。引き上げをリクエストするには、「[AWS のサービス クォータ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)」を参照してください。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | AsyncUserErrorCount | バッチ | 指定されたオーディオ形式が検出されたものと一致しない場合、無効なサンプルレート、顧客 Amazon S3 アクセスエラーなど、非同期 (バックエンド) ユーザーエラーの数。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` **オペレーション**: `StartCallAnalyticsJob`、`StartMedicalTranscriptionJob`、`StartTranscriptionJob`、`CreateMedicalVocabulary`、`CreateVocabulary`、`UpdateMedicalVocabulary`、`UpdateVocabulary` | | AsyncServerErrorCount | バッチ | 非同期 (バックエンド) サーバーエラー、より具体的には自動音声認識 (ASR) 処理エラーの数。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` **オペレーション**: `StartCallAnalyticsJob`、`StartMedicalTranscriptionJob`、`StartTranscriptionJob`、`CreateMedicalVocabulary`、`CreateVocabulary`、`UpdateMedicalVocabulary`、`UpdateVocabulary` | | AudioDurationTime | バッチ | 秒単位での音声ファイルまたはビデオファイルの長さ。 **単位**: 秒 **関連する統計**: average、Minimum、Maximum **有効なディメンション**: `Domain`、`ServiceType`、`LanguageCode` | | ConcurrentStreamsCount | ストリーミング | 現在処理中の同時ストリームの数を表示します。 **単位**: 個 **関連する統計情報**: Average、Maximum **有効なディメンション**: `Domain`、 `ServiceType` | | ConcurrentPostStreamJobsCount | ストリーミング | 現在処理中の concurrent AWS HealthScribe ストリーム後分析の数を表示します。 **単位**: 個 **関連する統計情報**: Average、Maximum **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | | PostStreamJobLimitExceededCount | ストリーミング | 同時ストリーム後ジョブ制限のクォータを超えたために `LimitExceededException` を返すリクエストの数を示します。 **単位**: 個 **関連する統計**: Sum、Average **有効なディメンション**: `Domain`、`ServiceType`、`Operation` | **CloudWatch の ディメンション Amazon Transcribe** | ディメンション | 説明 | | --- | --- | | Domain | 指定された Transcribe タイプのメトリクスのみを表示します。 **有効なオプション**: Transcribe、医療 Transcribe、コール分析の Transcribe | | ServiceType | 指定されたサービスタイプのメトリクスのみを表示します。 **有効なオプション**: バッチ | | Operation | 指定されたオペレーションのメトリクスのみを表示します。 **有効なオプション**: 任意の Amazon Transcribe API | | LanguageCode | 指定された言語のメトリクスのみを表示します。 **有効なオプション**: `en-US` フォーム内の任意の有効な言語コード | # Amazon Transcribe によるモニタリング AWS CloudTrail Amazon Transcribe は AWS CloudTrail、 AWS Identity and Access Management (IAM) ユーザーまたはロール、または AWS のサービス Amazon Transcribe によって実行されたアクションを記録するサービスである と統合されています。 は、 のすべての API コール CloudTrail をキャプチャします Amazon Transcribe。これには、 からの呼び出し AWS マネジメントコンソール と、イベントとしての Amazon Transcribe APIsへのコード呼び出しが含まれます。証跡を作成することで、 バケット Amazon Transcribeへの CloudTrail Amazon S3 イベントを含むイベントの継続的な配信を有効にすることができます。証跡を作成しない場合でも、**イベント履歴**の CloudTrail AWS マネジメントコンソール で最新のイベントを表示することはできます。によって収集された情報を使用して CloudTrail、 に対して行われた各リクエスト Amazon Transcribe、リクエスト元の IP アドレス、リクエスト者、リクエスト日時などの詳細を確認できます。 詳細については CloudTrail、 [https://docs.aws.amazon.com/awscloudtrail/latest/userguide/](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。 ## Amazon Transcribe および CloudTrail CloudTrail アカウントを作成する AWS アカウント と、 は で有効になります。アクティビティが発生すると Amazon Transcribe、そのアクティビティは CloudTrail イベント履歴の他の AWS のサービス イベントとともに CloudTrail **イベント**に記録されます。で最近のイベントを表示、検索、ダウンロードできます AWS アカウント。詳細については、「[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。 のイベントなど AWS アカウント、 のイベントの継続的な記録を取得するには Amazon Transcribe、証跡を作成します。*証跡*は、 が指定された Amazon S3 bucket CloudTrail にイベントをログファイルとして配信できるようにする設定です。 CloudTrail ログファイルには 1 つ以上のログエントリが含まれています。*イベント* は、任意の送信元からの単一の要求を表します。これには、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。 CloudTrail ログファイルはパブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。 デフォルトでは、 で証跡を作成すると AWS マネジメントコンソール、証跡はすべての に適用されます AWS リージョン。証跡は、 AWS パーティション AWS リージョン 内のすべての からのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、他の を設定 AWS のサービス して、 CloudTrail ログで収集されたイベントデータをさらに分析して対応できます。詳細については、以下を参照してください。 + [証跡を作成するための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail サポートされているサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Amazon SNS の通知の設定 CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + 「[複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)」と「[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)」 CloudTrail は、 [API リファレンス](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)に記載されているすべての Amazon Transcribe アクションをログに記録します。たとえば、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)、、および [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)オペレーションでは[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html)、 CloudTrail ログファイルにエントリが生成されます。CloudTrail が Amazon Transcribe API オペレーションをログに記録すると、CloudTrail ログエントリは Amazon S3 URI 値などのリクエストパラメータとレスポンスパラメータの機密情報に空の文字列を使用します。 各イベントまたはログエントリには、リクエストの生成者に関する情報が含まれます。この情報は以下のことを確認するのに役立ちます: + リクエストがルート認証情報または IAM ユーザー認証情報のどちらを使用して行われたか + リクエストが、 IAM ロールまたはフェデレーションユーザーの一時的なセキュリティ認証情報によって行われたか + リクエストが別の によって行われたかどうか AWS のサービス 詳細については、「[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)」を参照してください。 複数の AWS リージョン と複数の の Amazon Transcribe ログファイルを 1 つの Amazon S3 バケット AWS アカウント に集約することもできます。詳細については、[「複数のリージョンからの CloudTrail ログファイルの受信」および](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)[「複数のアカウントからの CloudTrail ログファイルの受信](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)」を参照してください。 ### 例: Amazon Transcribe ログファイルエントリ *証跡*は、指定された Amazon S3 バケットへのログファイルとしてのイベントの配信を可能にする設定です。 CloudTrail ログファイルには 1 つ以上のログエントリが含まれます。*イベント* は、任意の送信元からの単一の要求を表します。これには、リクエストされたアクションに関する情報がアクションの日時として含まれ、リクエスト parameters. CloudTrail log ファイルはパブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) および [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html) API オペレーションを呼び出すと、以下のエントリが作成されます。 **注記** CloudTrail が Amazon Transcribe API オペレーションをログに記録すると、CloudTrail ログエントリは 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" } ] } ``` # での Amazon EventBridge の使用Amazon Transcribe Amazon EventBridge を使用すると、他の AWS のサービス でイベントを開始させることで Amazon Transcribe ジョブの状態の変化に対応できます。書き起こしジョブの状態が変わると、EventBridge は自動的にイベントをイベントストリームに送信します。イベントストリーム内でモニタリングするイベントと、それらのイベントが発生したときに EventBridge によって実行されるアクションを定義するルールを作成します。例えば、イベントを別のサービス (ターゲット) にルーティングし、そこからアクションが実行されるようにできます。この場合、文字起こしジョブが正常に完了したときにイベントを AWS Lambda 関数にルーティングするように、ルールを設定できます。[EventBridge ルール](#defining-rules)を定義するには、以下のセクションを参照してください。 イベントの通知は、Eメール、[チャットアプリケーション内の Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)のチャット通知、[AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)のプッシュ通知などの複数のチャネルで受け取ることができます。「[コンソール通知センター](https://console.aws.amazon.com/notifications/)」で通知を確認することもできます。通知を設定する場合は、[AWS User Notifications](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) を使用できます。AWS User Notifications は、集約をサポートしているため、特定のイベント中に受け取る通知の数を減らすことができます。 ## EventBridge ルールの定義 EventBridge ルールを定義するには、 [AWS マネジメントコンソール](https://console.aws.amazon.com/events) を使用します。ルールを定義するときは、サービス名として Amazon Transcribe を使用します。EventBridge ルールの作成方法の例については、「[Amazon EventBridge ルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)」を参照してください。 EventBridge を使用する前に、次の定義に注意してください。 + **イベント** - イベントは、文字起こしジョブのいずれかの状態の変化を示します。例えば、ジョブの `TranscriptionJobStatus` が `IN_PROGRESS` から `COMPLETED` に変わります。 + **ターゲット** - ターゲットは、イベントを処理する別の AWS のサービス です。たとえば、AWS Lambda や Amazon Simple Notification Service (Amazon SNS) です。ターゲットは、JSON 形式のイベントを受け取ります。 + **ルール** - ルールに一致するイベントは EventBridge のモニタリング対象であり、処理のために 1 つまたは複数のターゲットにルーティングされます。ルールによってイベントが複数のターゲットにルーティングされた場合、すべてのターゲットではそのイベントが並行して処理されます。ルールでは、ターゲットに送信される JSON をカスタマイズできます。 Amazon EventBridge イベントは、ベストエフォートベースで出力されます。EventBridge でのイベントの作成と管理について詳しくは、*Amazon EventBridge ユーザーガイド*の「[Amazon EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。 以下は、文字起こしジョブのステータスが `COMPLETED` または `FAILED` に変わったときに開始される、Amazon Transcribe の EventBridge ルールの例です。 ``` { "source": [ "aws.transcribe" ], "detail-type": [ "Transcribe Job State Change" ], "detail": { "TranscriptionJobStatus": [ "COMPLETED", "FAILED" ] } } ``` ルールには以下のフィールドがあります。 + `source` - イベントのソース。Amazon Transcribe の場合、これは常に `aws.transcribe` です。 + `detail-type` - イベントの詳細の識別子。Amazon Transcribe の場合、これは常に `Transcribe Job State Change` です。 + `detail` - 文字起こしジョブの新しいステータス。この例のルールでは、ジョブのステータスが `COMPLETED` または `FAILED` に変わったときにイベントが開始されます。 ## Amazon Transcribe のイベント Amazon EventBridge は複数の Amazon Transcribe イベントを記録します。 + [文字起こしジョブイベント](#job-event) + [言語識別イベント](#lang-id-event) + [コール分析イベント](#analytics-event) + [コール分析通話後のイベント](#analytics-stream-event) + [語彙イベント](#vocab-event) これらのイベントにはすべて、以下の共有フィールドが含まれます。 + `version`: イベントデータのバージョン。この値は常に `0` です。 + `id`: イベントに対して EventBridge によって生成された固有 ID。 + `detail-type`: イベントの詳細の識別子。例えば、`Transcribe Job State Change`。 + `source`: イベントのソース。Amazon Transcribe の場合、これは常に `aws.transcribe` です。 + `account`: API コールを生成したアカウントの AWS アカウント ID。 + `time`: イベントが配信された日時。 + `region`: リクエストが行われたAWS リージョン。 + `resources`: API コールによって使用されたリソース。Amazon Transcribe の場合、このフィールドは常に空です。 + `detail`: イベントに関するその他の詳細 + `FailureReason`: このフィールドは、状態またはステータスが `FAILED` に変化した場合に表示され、`FAILED` の状態またはステータスになった理由が説明されます。 + 各イベントタイプには、`detail` の下に表示される追加の固有のフィールドがあります。これらの固有のフィールドは、各イベント例の後に続く以下のセクションで定義されています。 ### 文字起こしジョブイベント ジョブの状態が `IN_PROGRESS` から `COMPLETED` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの `TranscriptionJobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。文字起こしジョブのステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。 このイベントは [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`: 文字起こしジョブに選択した固有の名前。 + `TranscriptionJobStatus `: 文字起こしのジョブのステータス。これは、`COMPLETED` または `FAILED` です。 ### 言語識別イベント [自動言語識別](lang-id.md)を有効にすると、Amazon Transcribe は、言語識別の状態が `COMPLETED` または `FAILED` の場合にイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの `JobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。言語識別ステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。 このイベントは、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) パラメータが含まれている場合の [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": "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`: 文字起こしジョブの場合、この値は `TranscriptionJob` でなければなりません。 + `JobName`: 文字起こしジョブの固有の名前。 + `LanguageIdentificationStatus`: 文字起こしジョブにおける言語識別のステータス。これは、`COMPLETED` または `FAILED` です。 ### コール分析イベント [コール分析](call-analytics.md)ジョブの状態が `IN_PROGRESS` から `COMPLETED` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析ジョブを特定するには、イベントの `JobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。コール分析ジョブのステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。 このイベントは [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`: コール分析文字起こしジョブの固有の名前。 + `JobStatus`: コール分析文字起こしジョブのステータス。`COMPLETED` または `FAILED` のいずれかとなります。 + `FailureReason`: このフィールドは `JobStatus` が `FAILED` の場合にのみ存在し、失敗の理由を示します。 + `AnalyticsJobDetails`: スキップされた分析機能に関する情報を含む、コール分析文字起こしジョブの詳細。 ### コール分析通話後のイベント [通話後分析](tca-post-call.md)文字起こしが `IN_PROGRESS` から `COMPLETED` または `FAILED` の状態に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析通話後ジョブを特定するには、イベントの `StreamingSessionId` フィールドを使用します。 このイベントは、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) パラメータが含まれている場合の [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 オペレーションにのみ適用されることに注意してください。 `COMPLETED` イベントには、以下の情報が含まれています。 ``` { "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" } } } ``` `FAILED` イベントには、以下の情報が含まれています。 ``` { "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`: リアルタイムコール分析文字起こしリクエストに割り当てられる識別番号。 + `PostCallStatus`: 通話後コール分析文字起こしジョブのステータス。`COMPLETED` または `FAILED` のいずれかとなります。 + `Transcript`: 編集済みおよび未編集のトランスクリプトの URI。 + `Media`: 編集済みおよび未編集の音声ファイルの URI。 ### AWS HealthScribe ストリーム後分析イベント [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html) が `IN_PROGRESS` から `COMPLETED` に変わるなど、AWS HealthScribe ストリーム後分析オペレーションの状態が変わると、AWS HealthScribe は次の情報を含むイベントを生成します。 ``` { "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`: イベントを生成したストリーム後分析オペレーションのタイプ。結果オブジェクトの内容は、`UpdateType` によって異なります。 + `SessionId`: AWS HealthScribe ストリームの識別番号。この ID を使用して、元のストリーミングセッションを識別し、イベントを生成したストリーム後分析を検索します。 + `Status`: ストリーム後分析オペレーションのステータス。これは、`IN_PROGRESS`、`COMPLETED`、または `FAILED` です。 + `ClinicalNoteOutputLocation`: `ClinicalNoteGenerationResult` の出力 Amazon S3 バケットの URI。 + `TranscriptOutputLocation`: トランスクリプトの URI。 ### 語彙イベント [カスタム語彙](custom-vocabulary.md)の状態が `PENDING` から `READY` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたカスタム語彙を特定するには、イベントの `VocabularyName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。カスタム語彙の状態が `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。 **注記** このイベントは [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`: カスタム語彙の固有の名前です。 + `VocabularyState`: カスタム語彙の処理状態。これは、`READY` または `FAILED` です。