View a markdown version of this page

Monitoramento do Amazon Textract - Amazon Textract
Usando CloudWatch métricas para o Amazon TextractAcesse as métricas do Amazon TextractCriar um alarme

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitoramento do Amazon Textract

Com CloudWatch, você pode obter métricas para operações individuais do Amazon Textract ou métricas globais do Amazon Textract para sua conta. Você pode usar métricas para monitorar a integridade da sua solução baseada no Amazon Textract e configurar alarmes para notificá-lo quando uma ou mais métricas estiverem fora de um limite definido. Por exemplo, você pode ver as métricas do número de erros de servidor que ocorreram. Você também pode ver as métricas do número de vezes que uma operação específica do Amazon Textract foi bem-sucedida. Para ver as métricas, você pode usar a Amazon CloudWatch AWS CLI, a ou a CloudWatch API.

Usando CloudWatch métricas para o Amazon Textract

Para usar métricas, você deve especificar as seguintes informações:

  • A dimensão métrica ou nenhuma dimensão. Uma dimensão é um par nome/valor, que ajuda a identificar com exclusividade uma métrica. O Amazon Textract tem uma dimensão, chamada Operação. Ele fornece métricas para uma operação específica. Se você não especificar uma dimensão, a métrica terá como escopo todas as operações do Amazon Textract em sua conta.

  • O nome da métrica, como UserErrorCount.

Você pode obter dados de monitoramento para o Amazon Textract usando a Console de gerenciamento da AWS AWS CLI, a ou a CloudWatch API. Você também pode usar a CloudWatch API por meio de um dos kits de desenvolvimento de software (SDKs) da Amazon AWS ou das ferramentas de CloudWatch API. O console exibe uma série de gráficos com base nos dados brutos da CloudWatch API. Dependendo das necessidades, você pode preferir usar os gráficos exibidos no console ou recuperados da API.

A lista a seguir mostra alguns usos comuns para as métricas. Essas são sugestões para você começar, e não uma lista abrangente.

Como eu faço para... Métricas relevantes

Como sei se meu aplicativo atingiu o número máximo de solicitações por segundo?

Monitore a estatística Sum da métrica ThrottledCount.

Como posso monitorar os erros de solicitação?

Use a estatística Sum da métrica UserErrorCount.

Como posso encontrar o número total de solicitações?

Use a estatística SampleCount da métrica ResponseTime. Isso inclui qualquer solicitação que resulte em um erro. Se você quiser ver apenas as chamadas de operação bem-sucedidas, use a métrica SuccessfulRequestCount.

Como posso monitorar a latência das chamadas operacionais do Amazon Textract?

Use a métrica ResponseTime.

Você deve ter as CloudWatch permissões apropriadas para monitorar o Amazon Textract. CloudWatch Para obter mais informações, consulte Autenticação e controle de acesso para o Amazon CloudWatch.

Acesse as métricas do Amazon Textract

Os exemplos a seguir mostram como acessar as métricas do Amazon Textract usando o CloudWatch console AWS CLI, o e a CloudWatch API.

Para visualizar métricas (console)

  1. Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

  2. Escolha Métricas, escolha a guia Todas as métricas e, em seguida, escolha Amazon Textract.

  3. Escolha Por operação e, em seguida, escolha uma métrica.

    Por exemplo, escolha a StartDocumentAnalysis métrica para medir quantas vezes a análise assíncrona de documentos foi iniciada.

  4. Escolha um valor para o intervalo de datas. A contagem de métricas exibidas no gráfico.

Para visualizar métricas de chamadas StartDocumentAnalysis operacionais bem-sucedidas que foram feitas durante um período de tempo (CLI)

  • Abra o AWS CLI e digite o seguinte 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 exemplo mostra as chamadas de operação StartDocumentAnalysis bem-sucedidas feitas ao longo de um período. Para obter mais informações, consulte get-metric-statistics.

Para acessar métricas (CloudWatch API)

Criar um alarme

Você pode criar um CloudWatch alarme que envia uma mensagem do Amazon Simple Notification Service (Amazon SNS) quando o alarme muda de estado. Um alarme observa uma única métrica por um período tempo que você especifica. Ele executa uma ou mais ações com base no valor da métrica em relação a um limite especificado ao longo de vários períodos. A ação é uma notificação enviada a um tópico do Amazon SNS ou a uma política de Auto Scaling.

Os alarmes invocam ações somente para mudanças de estado sustentadas. CloudWatch os alarmes não invocam ações simplesmente porque estão em um estado específico. O estado deve ter sido alterado e mantido por um período especificado.

Para definir um alarme (console)

  1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação, escolha Alarmes e escolha Criar alarme. Isso abre o Assistente de criação de alarme.

  3. Escolha Selecionar métrica.

  4. Na guia Todas as métricas, escolha Extrair.

  5. Escolha Por operação e, em seguida, escolha uma métrica.

    Por exemplo, escolha definir um alarme StartDocumentAnalysis para um número máximo de operações assíncronas de análise de documentos.

  6. Escolha a guia Graphed metrics (Métricas em gráfico).

  7. Em Estatística, selecione Soma.

  8. Escolha Selecionar métrica.

  9. Preencha o Name e a Description. Em Whenever, escolha >= e digite um valor máximo de sua escolha.

  10. Se você quiser CloudWatch enviar um e-mail quando o estado do alarme for atingido, em Sempre que este alarme:, escolha Estado é ALARME. Para enviar alarmes para um tópico existente do Amazon SNS, em Enviar notificação para:, escolha um tópico existente do SNS. Para definir o nome e os endereços de e-mail para uma nova lista de assinaturas de e-mail, escolha Nova lista. CloudWatch salva a lista e a exibe no campo para que você possa usá-la para definir alarmes futuros.

    nota

    Se você usar Nova lista para criar um novo tópico do Amazon SNS, os endereços de e-mail deverão ser verificados antes que os destinatários desejados recebam as notificações. O Amazon SNS envia só e-mails quando o alarme entra em um estado de alarme. Se essa alteração no estado do alarme ocorrer antes da verificação dos endereços de e-mail, os destinatários pretendidos não receberão uma notificação.

  11. Escolha Criar Alarm.

Para definir um alarme (AWS CLI)

  • Abra o AWS CLI e digite o comando a seguir. Altere o valor do parâmetro alarm-actions para fazer referência a um tópico do Amazon SNS criado anteriormente por você. 

    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

    Este exemplo mostra como criar um alarme para quando mais de 10 erros de usuário ocorrerem em 5 minutos para chamadas para StartDocumentAnalysis o. Para obter mais informações, consulte put-metric-alarm.

Para definir um alarme (CloudWatch API)