View a markdown version of this page

Supervisión de Amazon Textract - Amazon Textract
Uso de CloudWatch métricas para Amazon TextractAcceda a las métricas de Amazon TextractCrear una alarma

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 Textract

Con ella CloudWatch, puede obtener las métricas de las operaciones individuales de Amazon Textract o las métricas globales de Amazon Textract para su cuenta. Puede utilizar las métricas para realizar un seguimiento del estado de su solución basada en Amazon Textract y configurar alarmas para que le notifiquen cuando una o más métricas superen un umbral definido. Por ejemplo, puede ver las métricas del número de errores de servidor que se han producido. También puede ver las métricas del número de veces que una operación específica de Amazon Textract se ha realizado correctamente. Para ver las métricas, puede usar Amazon CloudWatch AWS CLI, la API o la CloudWatch API.

Uso de CloudWatch métricas para Amazon Textract

Para utilizar métricas, debe especificar la siguiente información:

  • La dimensión métrica o ninguna dimensión. Una dimensión es un par de nombre-valor que le ayuda a identificar una métrica de forma inequívoca. Amazon Textract tiene una dimensión, denominada Operation. Proporciona métricas para una operación específica. Si no especifica ninguna dimensión, la métrica se aplica a todas las operaciones de Amazon Textract de su cuenta.

  • El nombre de la métrica, como UserErrorCount.

Puede obtener datos de supervisión de Amazon Textract mediante la API Consola de administración de AWS, la API o la AWS CLI API. CloudWatch También puede usar la CloudWatch API mediante uno de los kits de desarrollo de software (SDK) de Amazon AWS o las herramientas de la CloudWatch API. La consola muestra una serie de gráficos basados en los datos sin procesar de la CloudWatch API. En función de sus necesidades, es posible que prefiera utilizar los gráficos que se muestran en la consola o que se recuperan de la API.

En la siguiente lista se indican algunos usos frecuentes de las métricas. Se trata de sugerencias que puede usar como punto de partida y no de una lista completa.

¿Cómo? Métricas relevantes

¿Cómo puedo saber si mi aplicación ha alcanzado el número máximo de solicitudes por segundo?

Monitorice la estadística Sum de la métrica ThrottledCount.

¿Cómo puedo monitorizar los errores de solicitud?

Utilice la estadística Sum de la métrica UserErrorCount.

¿Cómo puedo encontrar el número total de solicitudes?

Utilice la estadística SampleCount de la métrica ResponseTime. Esto incluye cualquier solicitud que genere un error. Si desea ver únicamente las llamadas a operaciones que se han realizado con éxito, use la métrica SuccessfulRequestCount.

¿Cómo puedo supervisar la latencia de las llamadas de operación de Amazon Textract?

Utilice la métrica ResponseTime.

Debe disponer de los CloudWatch permisos adecuados para supervisar Amazon Textract. CloudWatch Para obtener más información, consulte Autenticación y control de acceso de Amazon CloudWatch.

Acceda a las métricas de Amazon Textract

Los siguientes ejemplos muestran cómo acceder a las métricas de Amazon Textract mediante la CloudWatch consola AWS CLI, la API y la CloudWatch API.

Para ver las métricas (consola)

  1. Abra la CloudWatch consola en. https://console.aws.amazon.com/cloudwatch/

  2. Seleccione Métricas, elija la pestaña Todas las métricas y, a continuación, elija Amazon Textract.

  3. Seleccione Por operación y, a continuación, elija una métrica.

    Por ejemplo, elija la StartDocumentAnalysis métrica para medir cuántas veces se ha iniciado el análisis asincrónico de documentos.

  4. Elija un valor para el intervalo de fechas. El número de métricas se muestra en el gráfico.

Para ver las métricas de las llamadas de StartDocumentAnalysis operación exitosas que se han realizado durante un período de tiempo (CLI)

  • Abra AWS CLI e introduzca el siguiente comando:

    aws cloudwatch get-metric-statistics \
    --metric-name SuccessfulRequestCount \
    --start-time 2019-02-01T00:00:00Z \
    --period 3600 \
    --end-time 2019-03-01T00:00:00Z \
    --namespace AWS/Textract \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --statistics Sum

    Este ejemplo muestra las llamadas a la operación StartDocumentAnalysis que se han realizado correctamente durante un periodo de tiempo. Para obtener más información, consulte get-metric-statistics.

Para acceder a las métricas (CloudWatch API)

Crear una alarma

Puede crear una CloudWatch alarma que envíe un mensaje de Amazon Simple Notification Service (Amazon SNS) cuando la alarma cambie de estado. Una alarma vigila una métrica determinada durante el periodo especificado. Realiza una o varias acciones según el valor de la métrica con respecto a un umbral dado durante varios períodos de tiempo. La acción es una notificación que se envía a un tema de Amazon SNS o a una política de Auto Scaling.

Las alarmas invocan acciones únicamente para cambios de estado sostenidos. CloudWatch las alarmas no invocan acciones simplemente porque se encuentran en un estado determinado. El estado debe haber cambiado y debe haberse mantenido durante el número de periodos de tiempo especificado.

Para configurar una alarma (consola)

  1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, seleccione Alarmas y, a continuación, seleccione Crear alarma. Esto abre el Asistente para crear alarmas.

  3. Elija Seleccionar métrica.

  4. En la pestaña Todas las métricas, elige Textract.

  5. Seleccione Por operación y, a continuación, elija una métrica.

    Por ejemplo, puede configurar StartDocumentAnalysis una alarma para un número máximo de operaciones asincrónicas de análisis de documentos.

  6. Elija la pestaña Métricas diagramadas.

  7. En Statistic (Estadística), elija Sum (Suma).

  8. Elija Seleccionar métrica.

  9. Rellene Nombre y Descripción. Para Siempre que, elija >= e introduzca un valor máximo de su elección.

  10. Si CloudWatch desea enviarle un correo electrónico cuando se alcance el estado de alarma, en Cuando esta alarma:, seleccione El estado es ALARMA. Para enviar alarmas a un tema de Amazon SNS existente, en Enviar notificación a:, elija un tema de SNS existente. Para configurar el nombre y las direcciones de correo electrónico de una nueva lista de suscripción de correo electrónico, seleccione Nueva lista. CloudWatch guarda la lista y la muestra en el campo para que pueda usarla para configurar futuras alarmas.

    nota

    Si utiliza Nueva lista para crear un nuevo tema de Amazon SNS, deben verificarse las direcciones de correo electrónico para que los destinatarios previstos puedan recibir las notificaciones. Amazon SNS envía solo mensajes de correo electrónico cuando la alarma entra en un estado de alarma. Si este cambio de estado de alarma se produce antes de que se verifiquen las direcciones de correo electrónico, los destinatarios previstos no recibirán ninguna notificación.

  11. Elija Crear alarma.

Para configurar una alarma (AWS CLI)

  • Abra AWS CLI e introduzca el siguiente comando. Cambie el valor del parámetro alarm-actions de forma que haga referencia a un tema de Amazon SNS que haya creado anteriormente. 

    aws cloudwatch put-metric-alarm \
    --alarm-name StartDocumentAnalysisUserErrors \
    --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
    --metric-name UserErrorCount \
    --namespace AWS/Textract \
    --statistic Sum \
    --period 300 \
    --threshold 10 \
    --comparison-operator GreaterThanThreshold \
    --evaluation-periods 1 \
    --unit Count \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic

    En este ejemplo se muestra cómo crear una alarma para cuando se producen más de 10 errores de usuario en 5 minutos cuando se trata de llamadas aStartDocumentAnalysis. Para obtener más información, consulte put-metric-alarm.

Para configurar una alarma (CloudWatch API)