Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Supervisión de Amazon Translate La supervisión es una parte importante del mantenimiento de la fiabilidad, la disponibilidad y el rendimiento de Amazon Translate y sus soluciones. AWS proporciona varias herramientas que puede utilizar para supervisar Amazon Translate. Puede configurar algunas de estas herramientas para monitorizar las soluciones automáticamente. Le recomendamos que automatice las tareas de supervisión en la medida de lo posible. Amazon Translate. cuenta con gráficos preconfigurados en los que se muestran las métricas más importantes para la solución. Cada gráfico ofrece una ventana al desempeño de su solución. Para obtener diferentes vistas del rendimiento de su solución a lo largo del tiempo, puede cambiar el intervalo de tiempo que muestran los gráficos. También puedes usar Amazon CloudWatch para supervisar Amazon Translate. Con CloudWatch él, puede automatizar el monitoreo de métricas específicas para sus soluciones. Recibirá un aviso siempre que una métrica esté fuera de los umbrales que haya establecido. También puede usar la CloudWatch API para crear una aplicación de monitoreo personalizada que se adapte a sus necesidades. Para obtener más información, consulta [Qué es Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) en la *Guía del CloudWatch usuario de Amazon*. En la tabla siguiente se describe cada uno de los gráficos preconfigurados que proporciona Amazon Translate. | Gráfico | Description (Descripción) | | --- | --- | | ![\[Gráfico que muestra el número de solicitudes satisfactorias.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-successful-request-count.png) | Recuento de solicitudes correcto Número de solicitudes realizadas correctamente a Amazon Translate durante el periodo de tiempo especificado. | | ![\[Gráfico que muestra el número reducido de solicitudes.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-throttled-request-count.png) | Recuento de solicitudes limitadasNúmero de solicitudes a Amazon Translate que se han limitado durante el periodo de tiempo especificado. Utilice esta información para determinar si la aplicación envía solicitudes a Amazon Translate demasiado rápido. | | ![\[Gráfico que muestra el tiempo medio de respuesta.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-average-response-time.png) | Promedio de tiempo de respuesta Promedio de tiempo que tardó Amazon Translate en procesar su solicitud durante el periodo de tiempo especificado. | | ![\[Gráfico que muestra el número de caracteres.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-character-count.png) | Recuento de caracteresNúmero total de caracteres que ha enviado a Amazon Translate durante el periodo de tiempo especificado. Es el número de caracteres que se le facturarán. | | ![\[Gráfico que muestra los recuentos de errores de los usuarios.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-user-error-count.png) | Recuento de errores de usuarioNúmero de errores de usuario que se produjeron durante el periodo de tiempo especificado. Los errores del usuario se encuentran en el intervalo de códigos de error HTTP de 400 a 499. | | ![\[Gráfico que muestra los recuentos de errores del sistema.\]](http://docs.aws.amazon.com/es_es/translate/latest/dg/images/metric-system-error-count.png) | Recuento de errores del sistemaNúmero de errores del sistema que se produjeron durante el periodo de tiempo especificado. Los errores del sistema se encuentran en el intervalo de códigos de error HTTP de 500 a 599. | ## Supervisión de Amazon Translate Con Amazon CloudWatch, puedes obtener métricas de operaciones individuales de Amazon Translate o métricas globales de Amazon Translate para tu cuenta. Utilice las métricas para realizar el seguimiento del estado de las soluciones de Amazon Translate y configurar alarmas que le avisen cuando una o varias métricas superen un umbral definido. Por ejemplo, puede supervisar el número de solicitudes realizadas a Amazon Translate durante un periodo de tiempo concreto, ver la latencia de las solicitudes correctas o crear una alarma para cuando los errores superen un umbral. ### Descripción de CloudWatch las métricas de Amazon Translate Para obtener métricas de las operaciones de Amazon Translate, especifique la siguiente información: + La dimensión de la métrica. Una *dimensión* es un conjunto de pares nombre-valor que se emplea para identificar una métrica. Amazon Translate tiene dos dimensiones: + `Operation` + `Language pair` + El nombre de la métrica, como `SuccessfulRequestCount` o `RequestCharacters`. Para obtener una lista completa de métricas, consulte [CloudWatch Métricas de Amazon Translate](translate-cloudwatch.md#translate-cloudwatch-metrics). Puedes obtener métricas de Amazon Translate con la Consola de administración de AWS AWS CLI, la o la CloudWatch API. Puede usar la CloudWatch API a través de uno de los kits de desarrollo de software de Amazon AWS (SDKs) o las herramientas de la CloudWatch API. En la siguiente tabla se enumeran algunos usos comunes de CloudWatch las métricas. Se trata de sugerencias que puede usar como punto de partida y no de una lista completa. | ¿Cómo? | Supervisar esta métrica | | --- | --- | | Realizar el seguimiento el número de solicitudes realizadas correctamente | La estadística sum de la métrica SuccessfulRequestCount. | | Saber si mi aplicación ha alcanzado su desempeño máximo | La estadística sum de la métrica ThrottledCount. | | Buscar el tiempo de respuesta de mi aplicación | La estadística average de la métrica ResponseTime. | | Buscar el número de errores de mi aplicación | La estadística sum de las métricas ServerErrorCount y UserErrorCount. | | Buscar el número de caracteres facturables | La estadística sum de la métrica CharacterCount. | Debe tener los CloudWatch permisos adecuados para supervisar Amazon Translate. CloudWatch Para obtener más información, consulte [Autenticación y control de acceso para Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) en la *Guía del CloudWatch usuario de Amazon*. ### Visualización de métricas de Amazon Translate Consulta las métricas de Amazon Translate en la CloudWatch consola. **Para ver las métricas (CloudWatch consola)** 1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Elija **Metrics (Métricas)**, **All Metrics (Todas las métricas)** y **AWS/Translate (AWS/Traducir)**. 1. Elija la dimensión, un nombre de métrica y **Add to graph** (Añadir al gráfico). 1. Elija un valor para el intervalo de fechas. El recuento de las métricas del intervalo de fechas especificado se muestra en el gráfico. # Registrar llamadas a la API Amazon Translate con AWS CloudTrail Amazon Translate está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por una entidad o AWS servicio de IAM en Amazon Translate. CloudTrail captura todas las llamadas a la API de Amazon Translate como eventos. Esto incluye llamadas realizadas desde la consola de Amazon Translate y las llamadas desde el código a las operaciones de la API de Amazon Translate. Si crea una CloudTrail ruta, puede habilitar la entrega continua de CloudTrail eventos, incluidos los eventos de Amazon Translate, a un bucket de Amazon Simple Storage Service (Amazon S3). Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en el **historial de eventos**. Puede usar la información recopilada CloudTrail para determinar la solicitud que se realizó a Amazon Translate, la dirección IP desde la que se realizó la solicitud, quién la hizo, cuándo se realizó y detalles adicionales. Para obtener más información CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). **Topics** + [Información de Amazon Translate en CloudTrail](#translate-info-in-cloudtrail) + [Descripción de las entradas de archivos de registro de Amazon Translate](#understanding-translate-entries) ## Información de Amazon Translate en CloudTrail CloudTrail está activado en tu AWS cuenta al crearla. Cuando se produce una actividad en Amazon Translate, esa actividad se registra en un CloudTrail evento junto con otros eventos de AWS servicio en el **historial de eventos**. Puede ver, buscar y descargar los eventos recientes en su AWS cuenta. Para obtener más información, consulte [Visualización de eventos con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Para tener un registro continuo de los eventos de tu AWS cuenta, incluidos los eventos de Amazon Translate, crea una ruta. Un *rastro* permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento mediante la consola, este se aplica a todas las regiones de AWS. El registro de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de S3 especificado. Puede configurar otros AWS servicios para analizar más a fondo los datos de eventos recopilados en los CloudTrail registros y actuar en función de ellos. Para más información, consulte los siguientes temas: + [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [ CloudTrail Servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuración de las notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [Recibir archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recibir archivos de CloudTrail registro](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) de varias cuentas Todas las acciones de Amazon Translate se registran CloudTrail y documentan en la [sección de referencia de la API](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html). Por ejemplo, las llamadas a `ImportTerminology` y `TranslateText` las acciones generan entradas en los archivos de CloudTrail registro. `DeleteTerminology` Cada entrada de registro o evento contiene información sobre quién generó la solicitud. Esta información le ayuda a determinar lo siguiente: + Si la solicitud se realizó con las credenciales del usuario raíz + si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado + Si la solicitud la realizó otro AWS servicio Para obtener más información, consulte el [elemento userIdentity de CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html). ## Descripción de las entradas de archivos de registro de Amazon Translate Un *rastro* es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un registro ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico. En el siguiente ejemplo, se muestra una entrada de CloudTrail registro que demuestra la `TranslateText` acción. ``` { "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 métricas y dimensiones de Amazon Translate Para supervisar el rendimiento de la solución, utiliza las CloudWatch métricas y dimensiones de Amazon para Amazon Translate. ## CloudWatch Métricas de Amazon Translate | Métrica | Description (Descripción) | | --- | --- | | CharacterCount | El número de caracteres facturables en las solicitudes. Dimensiones válidas: Language pair, Operation Estadísticas válidas: Average, Maximum, Minimum, Sum Unidad: recuento | | ResponseTime | El tiempo que se ha tardado en responder a la solicitud. Dimensiones válidas: Language pair, Operation Estadísticas válidas: Data samples, Average Unidad: en las muestras de datos, recuento. En las estadísticas de promedio, milisegundos. | | ServerErrorCount | El número de errores de servidor. El intervalo de códigos de respuesta HTTP de un error de servidor va de 500 a 599. Dimensión válida: Operation Estadísticas válidas: Average, Sum Unidad: recuento | | SuccessfulRequestCount | El número de solicitudes de traducción realizadas correctamente. El código de respuesta para una solicitud realizada correctamente va de 200 a 299. Dimensión válida: Operation Estadísticas válidas: Average, Sum Unidad: recuento | | ThrottledCount | El número de solicitudes sujetas a limitaciones. Utilice `ThrottledCount` para determinar si la aplicación está enviando solicitudes a Amazon Translate más rápido de lo que su cuenta está configurada para aceptar. Para obtener más información, consulte [Límites de Amazon Translate](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate) en la *Referencia general de Amazon Web Services*. Dimensión válida: Operation Estadísticas válidas: Average, Sum Unidad: recuento | | UserErrorCount | El número de errores de usuario que se han producido. El intervalo de códigos de respuesta HTTP de un error de usuario va de 400 a 499. Dimensión válida: Operation Estadísticas válidas: Average, Sum Unidad: recuento | ## CloudWatch Dimensiones para Amazon Translate Utilice las siguientes dimensiones para filtrar métricas de Amazon Translate. Las métricas están agrupadas por idioma de origen e idioma de destino. | Dimensión | Description (Descripción) | | --- | --- | | LanguagePair | Restringe las métricas solo a las que contienen los idiomas especificados. | | Operation | Restringe las métricas solo a las que tienen la operación especificada. | # Supervisión de eventos de Amazon Translate con Amazon EventBridge Amazon Translate se integra con Amazon EventBridge para notificarle los cambios que afecten a sus trabajos de traducción y a sus recursos de datos paralelos. Los eventos de AWS los servicios se entregan EventBridge prácticamente en tiempo real. Puede crear reglas sencillas para indicar qué eventos le resultan de interés, así como qué acciones automatizadas se van a realizar cuando un evento cumple una de las reglas. Por ejemplo, entre las acciones que se pueden iniciar automáticamente se incluyen las siguientes: + Invocar una función AWS Lambda + Invocar el comando Run de AWS Systems Manager + Desviar el evento a Amazon Kinesis Data Streams + Activar una máquina de AWS Step Functions estados + Notificar un tema de Amazon SNS o una cola de Amazon SQS Para obtener más información, consulta [Cómo crear EventBridge reglas de Amazon que reaccionen a los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la *Guía del EventBridge usuario de Amazon*. ## Eventos de Amazon Translate Los siguientes ejemplos corresponden a eventos de Amazon Translate. ### Eventos para trabajos de traducción por lotes Los trabajos de traducción por lotes se ejecutan mediante la consola de Amazon Translate o la [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)operación. Amazon Translate envía eventos cuando estos trabajos se han completado correctamente o no. Estos eventos se parecen al ejemplo siguiente. ``` { "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" } } ``` El valor del atributo `jobStatus` depende del estado del trabajo para el que Amazon Translate envió el evento. Los valores de `jobStatus` son: + `COMPLETED`: el trabajo se ha completado correctamente y la salida está disponible. + `COMPLETED_WITH_ERROR`: el trabajo se ha completado con errores. Los errores se pueden analizar en la salida del trabajo. + `STOPPED`: se ha interrumpido el trabajo. + `FAILED`: el trabajo no se ha completado. Para obtener detalles, utilice la [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)operación. ### Eventos para recursos de datos paralelos Cuando utiliza Amazon Translate para crear o actualizar un recurso de datos en paralelo, envía un evento para indicar si la operación se ha realizado correctamente o no. Los recursos de datos paralelos se crean mediante la consola de Amazon Translate o la [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)operación. Al hacerlo, Amazon Translate envía un evento como el siguiente. ``` { "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" } } ``` Los valores del atributo `status` son: + `ACTIVE`: la operación `CreateParallelData ` se ha realizado correctamente y el recurso está listo para su uso. + `FAILED`: la operación `CreateParallelData` ha fallado. Los recursos de datos paralelos se actualizan mediante la consola de Amazon Translate o la [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)operación. Al hacerlo, Amazon Translate envía un evento como el siguiente. ``` { "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" } } ``` El atributo `status` proporciona el estado de la versión anterior del recurso de datos paralelos, que se sustituye por la actualización. Valores son los siguientes: + `ACTIVE`: la versión anterior se ha creado o se ha actualizado correctamente. + `FAILED`: no se ha podido crear ni actualizar la versión anterior. El atributo `latestUpdateAttemptStatus` proporciona el estado de la nueva versión del recurso de datos paralelos, que se ha creado por la actualización. Valores son los siguientes: + `ACTIVE`: la operación `UpdateParallelData` se ha realizado correctamente y el recurso actualizado está listo para su uso. + `FAILED`: la operación `UpdateParallelData` ha fallado.