Monitorar o Amazon Textract - Amazon Textract
Como usar métricas do CloudWatch para o Amazon TextractAcesse 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á.

Monitorar o Amazon Textract

Com o CloudWatch, você pode obter métricas para operações individuais do Amazon Textract ou métricas globais do Amazon Textract para a conta. É possível usar métricas para rastrear a integridade da sua solução baseada em Amazon Textact e configurar alarmes para notificação quando uma ou mais métricas estiverem fora de um limite definido. Por exemplo, você pode ver métricas do número de erros de servidor que ocorreram. Você também pode ver métricas para o número de vezes em que uma operação Amazon Textract específica foi bem-sucedida. Para ver métricas, você pode usarAmazon CloudWatch, oAWS CLI, ou oAPI do CloudWatch.

Como usar métricas do CloudWatch para o Amazon Textract

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

  • A dimensão da 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 chamadaOperação. Ele fornece métricas para uma operação específica. Se você não especificar uma dimensão, a métrica terá escopo em todas as operações Amazon Textract dentro da conta.

  • O nome da métrica, como UserErrorCount.

Você pode obter dados de monitoramento para o Amazon Textract usando oAWS Management Console, oAWS CLIou a API do CloudWatch. Além disso, é possível usar a API do CloudWatch por meio de um dos Kits de desenvolvimento de software (SDKs) Amazon AWS ou das ferramentas da API do CloudWatch. O console exibe uma série de gráficos com base nos dados brutos da API do CloudWatch. 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 de operação do Amazon Textract?

Use a métrica ResponseTime.

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

Acesse métricas do Amazon Textract

Os exemplos a seguir mostram como acessar métricas do Amazon Textract usando o console do CloudWatch, oAWS CLIe a API do CloudWatch.

Para exibir métricas (console)

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

  2. SelecioneMétricas, escolha oTodas as métricas doguia e, em seguida, selecioneAmazon Textract.

  3. SelecionePor operaçãoe, em seguida, selecione uma métrica.

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

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

Para visualizar métricas para obter sucessoStartDocumentAnalysisChamadas de operação feitas durante um período (CLI)

  • Abra a AWS CLI e digite o comando a seguir:

    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 (API do CloudWatch)

Criar um alarme

Você pode criar um alarme do CloudWatch 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 alertas invocam ações apenas para alterações de estado mantidas. Os alarmes do CloudWatch não invocam ações somente porque estão em um determinado estado. O estado deve ter sido alterado e mantido por um período especificado.

Para definir um alarme (console)

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

  2. No painel de navegação, selecioneAlarmes, e escolhaCriar alarme. Isso abre oCriar assistente de alarme do.

  3. Escolha Select metric (Selecionar métrica).

  4. NoTodas as métricasguia, selecioneTextract.

  5. SelecionePor operaçãoe, em seguida, selecione uma métrica.

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

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

  7. Em Statistic (Estatística), selecione Sum (Soma).

  8. Escolha Select metric (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 que o CloudWatch envie um e-mail quando o estado do alarme for atingido, paraSempre que este alarme:, escolhaO estado é ALARME. Para enviar alarmes para um tópico do Amazon SNS existente, paraEnviar notificação para:, escolha um tópico do SNS existente. Para definir o nome e os endereços de e-mail para uma nova lista de assinaturas de e-mail, escolhaNova lista. O CloudWatch salva a lista e a exibe no campo, de maneira que você possa usá-la a fim de definir alarmes futuros.

    nota

    Se você usarNova listaPara criar um novo tópico do Amazon SNS, os endereços de e-mail devem ser verificados para os destinatários desejados receberem notificações. O Amazon SNS envia e-mails somente quando o alarme entra em um estado de alarme. Se essa alteração no status de alarme ocorrer antes que os endereços de e-mail sejam verificados, os destinatários desejados não receberão notificação.

  11. Escolha Create Alarm.

Para definir um alarme (AWS CLI)

  • Abra a AWS CLI e digite o comando a seguir. Altere o valor doalarm-actionsPara 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 ocorrem em 5 minutos para as chamadas paraStartDocumentAnalysis. Para obter mais informações, consulte put-metric-alarm.

Para definir um alerta (API do CloudWatch)