Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Surveillance Amazon Transcribe La surveillance joue un rôle important dans le maintien de la fiabilité, de la disponibilité Amazon Transcribe et des performances de vos autres AWS solutions. AWS fournit les outils de surveillance suivants pour surveiller Amazon Transcribe, signaler tout problème et prendre des mesures automatiques le cas échéant : + **Amazon CloudWatch**surveille vos AWS ressources et les applications que vous exécutez AWS en temps réel. Vous pouvez collecter et suivre les métriques, créer des tableaux de bord personnalisés, et définir des alarmes qui vous informent ou prennent des mesures lorsqu’une métrique spécifique atteint un seuil que vous spécifiez. Par exemple, vous pouvez CloudWatch suivre l'utilisation du processeur ou d'autres indicateurs sur vos Amazon EC2 instances et lancer automatiquement de nouvelles instances en cas de besoin. + **Amazon CloudWatch Logs**peut surveiller, stocker et accéder à vos fichiers journaux à partir d' Amazon EC2 instances et d'autres sources. CloudTrail CloudWatch Logs peut surveiller les informations contenues dans les fichiers journaux et vous avertir lorsque certains seuils sont atteints. Vous pouvez également archiver vos données de journaux dans une solution de stockage hautement durable. + **AWS CloudTrail**capture les appels d'API et les événements associés effectués par vous ou en votre nom Compte AWS et envoie les fichiers journaux dans un Amazon S3 compartiment que vous spécifiez. Vous pouvez identifier les utilisateurs et les comptes appelés AWS, l'adresse IP source à partir de laquelle les appels ont été effectués et la date des appels. Pour plus d’informations, consultez le *Guide de l’utilisateur [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)*. **Amazon EventBridge**est un service sans serveur qui utilise des événements pour connecter les composants de l'application entre eux, ce qui vous permet de créer plus facilement des applications évolutives pilotées par des événements. EventBridge fournit un flux de données en temps réel à partir de vos propres applications, applications SaaS (Software as a Service) et AWS services et achemine ces données vers des cibles telles que Lambda. Vous pouvez surveiller les événements qui se produisent dans les services et créer des architectures basées sur les événements. Pour plus d’informations, consultez le *Guide de l’utilisateur [Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)*. **Topics** + [Surveillance Amazon Transcribe avec Amazon CloudWatch](monitoring-cloudwatch.md) + [Surveillance Amazon Transcribe avec AWS CloudTrail](monitoring-transcribe-cloud-trail.md) + [Utilisation Amazon EventBridge avec Amazon Transcribe](monitoring-events.md) # Surveillance Amazon Transcribe avec Amazon CloudWatch Vous pouvez surveiller Amazon Transcribe l'utilisation CloudWatch, qui collecte les données brutes et les transforme en indicateurs lisibles en temps quasi réel. Ces statistiques sont enregistrées pour une durée de 15 mois ; par conséquent, vous pouvez accéder aux informations historiques et acquérir un meilleur point de vue de la façon dont votre service ou application web s’exécute. Vous pouvez également définir des alarmes qui surveillent certains seuils et envoient des notifications ou prennent des mesures lorsque ces seuils sont atteints. Pour plus d’informations, consultez le [Guide de l’utilisateur *CloudWatch *](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html). ## Utilisation de Amazon CloudWatch métriques et de dimensions avec Amazon Transcribe Amazon Transcribe prend en charge CloudWatch les métriques et les dimensions, qui sont des données qui peuvent vous aider à surveiller les performances. Les catégories de métriques prises en charge incluent le trafic, les erreurs, le transfert de données et la latence associés à vos tâches de transcription. Les métriques prises en charge se trouvent CloudWatch dans l'espace de noms **AWS/Transcribe.** **Note** CloudWatch les indicateurs de surveillance sont gratuits et ne sont pas pris en compte dans les quotas CloudWatch de service. Pour plus d'informations sur les CloudWatch métriques, consultez la section [Utilisation Amazon CloudWatch des métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). **CloudWatch métriques pour Amazon Transcribe** | Métrique | Type de service | Description | | --- | --- | --- | | TotalRequestCount | traitement par lots, streaming | Indique le nombre de transactions. Représente toutes les demandes réussies et infructueuses adressées à Transcribe. **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation`, `LanguageCode` | | SuccessfulRequestCount | lot | Indique le nombre de requêtes réussies. La plage de codes de réponse d’une demande réussie est comprise entre 200 et 299. **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | SyncServerErrorCount | lot | Indique le nombre d’erreurs de serveur. La plage de codes de réponse d’une erreur de serveur est comprise entre 500 et 599. **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | SyncUserErrorCount | lot | Indique le nombre d’erreurs d’utilisateur, telles que les paramètres, les fichiers et les autorisations non valides, ainsi que les erreurs de limitation. La plage de codes de réponse d’une erreur d’utilisateur est comprise entre 400 et 499. **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | ThrottledCount | traitement par lots, streaming | Indique le nombre de demandes renvoyant un **LimitExceededException**résultat suite à un dépassement du quota de taux de transaction. Amazon Transcribe limite le nombre de demandes qu'un client peut effectuer par seconde. Si la limite de quota fixée pour vous Compte AWS est fréquemment dépassée, vous pouvez demander une augmentation de quota. Pour demander une augmentation, consultez la section [Quotas Service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | LimitExceededCount | traitement par lots, streaming | Indique le nombre de demandes renvoyant un **LimitExceededException**résultat en cas de dépassement d'un quota non tarifaire. Amazon Transcribe limite le nombre de tâches simultanées, le nombre total de transcriptions, la taille maximale des fichiers audio, etc. Si la limite fixée pour vous Compte AWS est fréquemment dépassée, vous pouvez demander une augmentation de quota. Pour demander une augmentation, consultez la section [Quotas Service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | AsyncUserErrorCount | lot | Le nombre d'erreurs utilisateur asynchrones (backend), telles que : le format audio donné ne correspond pas à celui détecté, fréquence d'échantillonnage non valide, erreur d'accès client Amazon S3 . **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` **Opérations** : `StartCallAnalyticsJob`, `StartMedicalTranscriptionJob`, `StartTranscriptionJob`, `CreateMedicalVocabulary`, `CreateVocabulary`, `UpdateMedicalVocabulary`, `UpdateVocabulary` | | AsyncServerErrorCount | lot | Nombre d’erreurs serveur asynchrones (backend) ou, plus précisément, d’erreurs de traitement par reconnaissance vocale automatique (ASR). **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` **Opérations** : `StartCallAnalyticsJob`, `StartMedicalTranscriptionJob`, `StartTranscriptionJob`, `CreateMedicalVocabulary`, `CreateVocabulary`, `UpdateMedicalVocabulary`, `UpdateVocabulary` | | AudioDurationTime | lot | Longueur, en secondes, d’un fichier audio ou vidéo. **Unité :** secondes **Statistiques pertinentes** : moyenne, minimum, maximum **Dimensions valides** : `Domain`, `ServiceType`, `LanguageCode` | | ConcurrentStreamsCount | streaming | Indique le nombre de flux simultanés en cours de traitement. **Unité** : nombre **Statistiques pertinentes** : moyenne, maximale **Dimensions valides** :`Domain`, `ServiceType` | | ConcurrentPostStreamJobsCount | streaming | Indique le nombre d'analyses AWS HealthScribe post-stream simultanées en cours de traitement. **Unité** : nombre **Statistiques pertinentes** : moyenne, maximale **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | | PostStreamJobLimitExceededCount | streaming | Indique le nombre de demandes renvoyant un `LimitExceededException` résultat résultant d'un dépassement du quota de tâches après le streaming simultané. **Unité** : nombre **Statistiques pertinentes** : somme, moyenne **Dimensions valides** : `Domain`, `ServiceType`, `Operation` | **CloudWatch dimensions pour Amazon Transcribe** | Dimension | Description | | --- | --- | | Domain | Affiche uniquement les métriques avec le type Transcribe spécifié. **Options valides** : Transcrire, Transcribe Medical, Transcribe Call Analytics | | ServiceType | Affiche uniquement les métriques avec le type de service spécifié. **Options valides** : par lots | | Operation | Affiche uniquement les métriques avec l’opération spécifiée. **Options valides** : n'importe quelle Amazon Transcribe API | | LanguageCode | Affiche uniquement les métriques avec la langue spécifiée. **Options valides** : n’importe quel code de langue valide, sous la forme `en-US` | # Surveillance Amazon Transcribe avec AWS CloudTrail Amazon Transcribe est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises Amazon Transcribe par un utilisateur ou un rôle Gestion des identités et des accès AWS (IAM), ou par un AWS service. CloudTrail capture tous les appels d'API pour Amazon Transcribe. Cela inclut les appels provenant des appels de code AWS Management Console et vers le Amazon Transcribe APIs, en tant qu'événements. En créant un suivi, vous pouvez permettre la diffusion continue d' CloudTrail événements, y compris des événements pour Amazon Transcribe, Amazon S3 dans un compartiment. Si vous ne créez pas de journal de suivi, vous pouvez toujours afficher les événements les plus récents dans la AWS Management Console CloudTrail sous **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez voir chaque demande qui est faite Amazon Transcribe, l'adresse IP à partir de laquelle la demande est faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires. Pour en savoir plus CloudTrail, consultez le [https://docs.aws.amazon.com/awscloudtrail/latest/userguide/](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Amazon Transcribe et CloudTrail CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. Lorsqu'une activité se produit dans Amazon Transcribe, cette activité est enregistrée dans un CloudTrail événement avec d'autres Service AWS événements dans l'**historique des CloudTrail événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d’informations, consultez [Affichage des événements avec l’historique des événements CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Pour obtenir un enregistrement continu des événements de votre compte Compte AWS, y compris des événements pour Amazon Transcribe, créez un parcours. Un *journal* est une configuration qui permet de CloudTrail transmettre des événements sous forme de fichiers journaux à un Amazon S3 compartiment spécifique. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un *événement* représente une demande individuelle d’une source quelconque. Il inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique. Par défaut, lorsque vous créez un parcours dans le AWS Management Console, le parcours s'applique à tous Régions AWS. Le journal enregistre les événements provenant de tous Régions AWS les éléments de la AWS partition et envoie les fichiers journaux dans le Amazon S3 compartiment que vous spécifiez. En outre, vous pouvez en configurer d'autres Services AWS pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour en savoir plus, consultez : + [Présentation de la création d’un journal d’activité](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail Services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuration Amazon SNS des notifications pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Réception de fichiers journaux CloudTrail de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [Réception de fichiers journaux CloudTrail de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) CloudTrail enregistre toutes les Amazon Transcribe actions, qui sont documentées dans la [référence de l'API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html). Par exemple, les [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)opérations [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html), et génèrent des entrées dans les fichiers CloudTrail journaux. Lorsque CloudTrail les opérations de l'API Amazon Transcribe sont enregistrées, l'entrée du CloudTrail journal utilise des chaînes vides pour les informations sensibles contenues dans les paramètres de demande et de réponse, tels que les valeurs d'URI Amazon S3. Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Cette information permet de déterminer les éléments suivants : + Si la demande est faite avec les informations IAM d'identification root ou utilisateur + Si la demande est effectuée avec des informations d’identification de sécurité temporaires pour un rôle ou un utilisateur fédéré IAM + Si la demande est faite par un autre Service AWS Pour plus d’informations, consultez la section [Élément userIdentity CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). Vous pouvez également agréger des fichiers Amazon Transcribe journaux multiples Régions AWS ou multiples Comptes AWS dans un seul Amazon S3 compartiment. Pour plus d'informations, consultez les [sections Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [Réception de fichiers CloudTrail journaux de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html). ### Exemple : entrées de fichier Amazon Transcribe journal Un *suivi* est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un Amazon S3 compartiment spécifié. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un *événement* représente une demande individuelle d’une source quelconque. Il inclut des informations sur l'action demandée, telles que la date et l'heure de l'action, ainsi que les paramètres de la demande. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique. Les appels vers les opérations d’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) et [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html) créent l’entrée suivante. **Note** Lorsque CloudTrail les opérations de l'API Amazon Transcribe sont enregistrées, l'entrée du CloudTrail journal utilise des chaînes vides pour les informations sensibles contenues dans les paramètres de demande et de réponse, tels que les valeurs d'URI Amazon S3. ``` { "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" } ] } ``` # Utilisation Amazon EventBridge avec Amazon Transcribe Avec Amazon EventBridge, vous pouvez répondre aux changements d'état de vos Amazon Transcribe tâches en déclenchant des événements dans d'autres tâches Services AWS. Lorsqu'une tâche de transcription change d'état, envoie EventBridge automatiquement un événement vers un flux d'événements. Vous pouvez créer des règles qui définissent les événements que vous souhaitez surveiller dans le flux d’événements et l’action que EventBridge doit prendre lorsque ces événements se produisent. Par exemple, le routage de l’événement vers un autre service (ou une autre cible) qui peut alors effectuer une action. Vous pouvez, par exemple, configurer une règle pour acheminer un événement vers une AWS Lambda fonction lorsqu'une tâche de transcription est terminée avec succès. Pour définir des [règles EventBridge](#defining-rules), reportez-vous aux sections suivantes. Vous pouvez recevoir des notifications d'événements via plusieurs canaux, notamment par e-mail, [Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), les notifications par chat ou les notifications [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Vous pouvez également consulter les notifications dans le [Centre de notifications de la console](https://console.aws.amazon.com/notifications/). Si vous souhaitez configurer des notifications, vous pouvez utiliser [Notifications des utilisateurs AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). Notifications des utilisateurs AWS prend en charge l'agrégation, ce qui peut réduire le nombre de notifications que vous recevez lors d'événements spécifiques. ## Définition des EventBridge règles Pour définir EventBridge des règles, utilisez le [AWS Management Console](https://console.aws.amazon.com/events). Lorsque vous définissez une règle, utilisez Amazon Transcribe comme nom de service. Pour un exemple de création d'une EventBridge règle, consultez la section [Amazon EventBridge règles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). Avant utilisation EventBridge, prenez note des définitions suivantes : + **Événement** – Un événement indique un changement d’état de l’une de vos tâches de transcription. Par exemple, lorsque l’état `TranscriptionJobStatus` d’une tâche passe de `IN_PROGRESS` à `COMPLETED`. + **Cible** – Une cible est un autre Service AWS qui traite un événement. Par exemple, AWS Lambda ou Amazon Simple Notification Service (Amazon SNS). Les cibles reçoivent les événements au format JSON. + **Règle** : une règle fait correspondre les événements entrants que vous EventBridge souhaitez surveiller et les achemine vers une ou plusieurs cibles à des fins de traitement. Si une règle achemine un événement vers plusieurs cibles, toutes les cibles traitent l’événement en parallèle. Une règle peut personnaliser le fichier JSON envoyé à la cible. Amazon EventBridge les événements sont émis dans la mesure du possible. Pour plus d'informations sur la création et la gestion d'événements dans EventBridge, consultez la section [Amazon EventBridge événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) du *Guide de Amazon EventBridge l'utilisateur*. Voici un exemple de EventBridge règle initiée lorsque Amazon Transcribe le statut d'une tâche de transcription devient `COMPLETED` ou`FAILED`. ``` { "source": [ "aws.transcribe" ], "detail-type": [ "Transcribe Job State Change" ], "detail": { "TranscriptionJobStatus": [ "COMPLETED", "FAILED" ] } } ``` La règle contient les champs suivants : + `source` – La source de l’événement. Car Amazon Transcribe c'est toujours le cas`aws.transcribe`. + `detail-type` – Un identifiant pour les détails de l’événement. Pour Amazon Transcribe, c’est toujours `Transcribe Job State Change`. + `detail` – Le nouvel état de la tâche de transcription. Dans cet exemple, la règle déclenche un événement lorsque l’état de la tâche devient `COMPLETED` ou `FAILED`. ## Amazon Transcribe événements Amazon EventBridge enregistre plusieurs Amazon Transcribe événements : + [Événements de tâche de transcription](#job-event) + [Événements d’identification des langues](#lang-id-event) + [Événements Call Analytics](#analytics-event) + [Événements après appel Call Analytics](#analytics-stream-event) + [Événements de vocabulaire](#vocab-event) Ces événements contiennent tous les champs partagés suivants : + `version` : la version des données de l’événement. Cette valeur est toujours `0`. + `id`: identifiant unique généré par EventBridge l'événement. + `detail-type` : un identifiant pour les détails de l’événement. Par exemple, `Transcribe Job State Change`. + `source` : la source de l’événement. Car Amazon Transcribe c'est toujours le cas`aws.transcribe`. + `account`: Compte AWS ID du compte qui a généré l'appel d'API. + `time` : la date et l’heure de diffusion de l’événement. + `region`: L' Région AWS endroit dans lequel la demande est faite. + `resources` : les ressources utilisées par l’appel d’API. Car Amazon Transcribe ce champ est toujours vide. + `detail` : des détails supplémentaires sur l’événement. + `FailureReason` : ce champ est présent si l’état ou le statut passe à `FAILED` et décrit la raison de cet état ou de ce statut `FAILED`. + Chaque type d’événement comporte des champs uniques supplémentaires qui sont affichés sous `detail`. Ces champs uniques sont définis dans les sections suivantes après chaque exemple d’événement. ### Événements de tâche de transcription Lorsque l'état d'une tâche passe `IN_PROGRESS` de `COMPLETED` ou`FAILED`, cela Amazon Transcribe génère un événement. Pour identifier la tâche qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ `TranscriptionJobName` de l’événement. Un Amazon Transcribe événement contient les informations suivantes. Un champ `FailureReason` est ajouté sous `detail` si le statut de votre tâche de transcription est `FAILED`. Notez que cet événement s’applique uniquement à l’opération de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html). ``` { "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` : nom unique que vous avez choisi pour votre tâche de transcription. + `TranscriptionJobStatus ` : statut de la tâche de transcription. La valeur peut être `COMPLETED` ou `FAILED`. ### Événements d’identification des langues Quand vous activez l’[identification automatique des langues](lang-id.md), Amazon Transcribe génère un événement lorsque l’état d’identification des langues est `COMPLETED` ou`FAILED`. Pour identifier la tâche qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ `JobName` de l’événement. Un événement Amazon Transcribe contient les informations suivantes : Un champ `FailureReason` est ajouté sous `detail` si votre statut d’identification des langues est `FAILED`. Notez que cet événement s’applique uniquement à l’opération de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) lorsque le paramètre [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) est inclus. ``` { "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` : pour les tâches de transcription, cette valeur doit être `TranscriptionJob`. + `JobName` : nom unique de votre tâche de transcription. + `LanguageIdentificationStatus` : statut de l’identification des langues dans une tâche de transcription. La valeur peut être `COMPLETED` ou `FAILED`. ### Événements Call Analytics Lorsque l’état d’une tâche [Call Analytics](call-analytics.md) passe de `IN_PROGRESS` à `COMPLETED` ou `FAILED`, Amazon Transcribe génère un événement. Pour identifier la tâche Call Analytics qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ `JobName` de l’événement. Un événement Amazon Transcribe contient les informations suivantes : Un champ `FailureReason` est ajouté sous `detail` si le statut de votre tâche Call Analytics est `FAILED`. Notez que cet événement s’applique uniquement à l’opération de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html). ``` { "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` : nom unique de votre tâche de transcription Call Analytics. + `JobStatus` : statut de votre tâche de transcription Call Analytics. Il peut correspondre à `COMPLETED` ou `FAILED`. + `FailureReason`: Ce champ n'est présent que lorsque `JobStatus` c'est `FAILED` le cas et décrit la raison de l'échec. + `AnalyticsJobDetails`: les détails de votre tâche de transcription Call Analytics, y compris les informations sur les fonctionnalités d'analyse ignorées. ### Événements après appel Call Analytics Lorsque l’état d’une transcription d’[analyse après appel](tca-post-call.md) passe de `IN_PROGRESS` à `COMPLETED` ou `FAILED`, Amazon Transcribe génère un événement. Pour identifier la tâche après appel Call Analytics qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ `StreamingSessionId` de l’événement. Notez que cet événement s’applique uniquement à l’opération de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html) lorsque le paramètre [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) est inclus. Un événement `COMPLETED` contient les informations suivantes : ``` { "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" } } } ``` Un événement `FAILED` contient les informations suivantes : ``` { "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` : numéro d’identification attribué à votre demande de transcription Call Analytics en temps réel. + `PostCallStatus` : statut de votre transcription Call Analytics après appel. Il peut correspondre à `COMPLETED` ou `FAILED`. + `Transcript` : URI de vos transcriptions expurgées et non expurgées. + `Media` : URI de vos fichiers audio expurgés et non expurgés. ### AWS HealthScribe événements d'analyse post-stream Lorsqu'un état change pour une opération d'analyse AWS HealthScribe post-stream, telle que le [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)passage de `IN_PROGRESS` à`COMPLETED`, AWS HealthScribe génère un événement contenant les informations suivantes : ``` { "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`: type d'opération d'analyse post-stream qui a généré l'événement. Le contenu de l'objet obtenu varie en fonction du`UpdateType`. + `SessionId`: le numéro d'identification de votre AWS HealthScribe stream. Utilisez cet identifiant pour identifier la session de streaming d'origine, puis recherchez les analyses post-diffusion qui ont généré l'événement. + `Status`: État de l'opération d'analyse post-stream. Cette valeur peut être `IN_PROGRESS`, `COMPLETED` ou `FAILED`. + `ClinicalNoteOutputLocation`: URI du compartiment Amazon S3 de sortie pour le`ClinicalNoteGenerationResult`. + `TranscriptOutputLocation`: URI de votre transcription. ### Événements de vocabulaire Lorsque l'état d'un [vocabulaire personnalisé](custom-vocabulary.md) passe `PENDING` de `READY` ou`FAILED`, cela Amazon Transcribe génère un événement. Pour identifier le vocabulaire personnalisé qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ `VocabularyName` de l’événement. Un Amazon Transcribe événement contient les informations suivantes. Un champ `FailureReason` est ajouté sous `detail` si l’état de votre vocabulaire personnalisé est`FAILED`. **Note** Cet événement s'applique uniquement au fonctionnement de l'[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` : nom unique de votre vocabulaire personnalisé. + `VocabularyState` : état de traitement de votre vocabulaire personnalisé. La valeur peut être `READY` ou `FAILED`.