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 usar[Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/), o[AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/), ou o[API do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## 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 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á 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 oConsole de gerenciamento da AWS, 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).
## 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/](https://console.aws.amazon.com/cloudwatch).
1. Selecione**Métricas**, escolha o**Todas as métricas do**guia e, em seguida, selecione**Amazon Textract**.
1. Selecione**Por operação**e, em seguida, selecione uma métrica.
Por exemplo, escolha o**StartDocumentAnalysis**métrica para medir quantas vezes a análise de documentos assíncrona foi iniciada.
1. Escolha um valor para o intervalo de datas. A contagem de métricas exibidas no gráfico.
**Para visualizar métricas para obter sucesso`StartDocumentAnalysis`Chamadas 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](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html).
**Para acessar métricas (API do CloudWatch)**
+ Chame `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Para obter mais informações, consulte o .[Referência da API do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## 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 Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, selecione**Alarmes**, e escolha**Criar alarme**. Isso abre o**Criar assistente de alarme do**.
1. Escolha **Select metric (Selecionar métrica)**.
1. No**Todas as métricas**guia, selecione**Textract**.
1. Selecione**Por operação**e, em seguida, selecione uma métrica.
Por exemplo, escolha**StartDocumentAnalysis**Para definir um alarme para um número máximo de operações de análise de documentos assíncronas.
1. Escolha a guia **Graphed metrics (Métricas em gráfico)**.
1. Em **Statistic (Estatística)**, selecione **Sum (Soma)**.
1. Escolha **Select metric (Selecionar métrica)**.
1. Preencha o **Name** e a **Description**. Em **Whenever**, escolha **>=** e digite um valor máximo de sua escolha.
1. Se você quiser que o CloudWatch envie um e-mail quando o estado do alarme for atingido, para**Sempre que este alarme:**, escolha**O estado é ALARME**. Para enviar alarmes para um tópico do Amazon SNS existente, para**Enviar 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, escolha**Nova 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ê usar**Nova lista**Para 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.
1. Escolha **Create Alarm**.
**Para definir um alarme (AWS CLI)**
+ Abra a AWS CLI e digite o comando a seguir. Altere o valor do`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 ocorrem em 5 minutos para as chamadas para`StartDocumentAnalysis`. Para obter mais informações, consulte [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html).
**Para definir um alerta (API do CloudWatch)**
+ Chame `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Para obter mais informações, consulte*[Referência da API do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.