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 Translate
O monitoramento é uma parte importante da manutenção da confiabilidade, disponibilidade e desempenho do Amazon Translate e de suas soluções. AWS fornece várias ferramentas que você pode usar para monitorar o Amazon Translate. Você pode configurar algumas dessas ferramentas para monitorar suas soluções para você. Recomendamos que as tarefas de monitoramento sejam automatizadas ao máximo possível.
O Amazon Translate fornece gráficos pré-configurados que mostram as métricas mais importantes para a sua solução. Cada gráfico oferece uma janela para o desempenho da sua solução. Para obter visualizações diferentes de como a solução está funcionando ao longo do tempo, você pode alterar o período exibido nos gráficos.
Você também pode usar CloudWatch a Amazon para monitorar o Amazon Translate. Com isso CloudWatch, você pode automatizar o monitoramento de métricas específicas para suas soluções. Você recebe um aviso sempre que uma métrica está fora dos limites definidos. Você também pode usar a CloudWatch API para criar um aplicativo de monitoramento personalizado adequado às suas necessidades. Para obter mais informações, consulte [O que é a Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) no *Guia CloudWatch do usuário da Amazon*.
A tabela a seguir descreve cada um dos gráficos pré-configurados fornecidos pelo Amazon Translate.
| Gráfico | Description |
| --- | --- |
| ![\[Gráfico mostrando a contagem de solicitações bem-sucedidas.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-successful-request-count.png) | Contagem de solicitações bem-sucedidas A quantidade de solicitações bem-sucedidas para o Amazon Translate durante o período especificado. |
| ![\[Gráfico mostrando contagens de solicitações limitadas.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-throttled-request-count.png) | Contagem de solicitações limitadasA quantidade de solicitações para Amazon Translate que foram limitadas durante o período especificado. Use essas informações para determinar se a aplicação está enviando solicitações ao Amazon Translate de maneira muito rápida. |
| ![\[Gráfico mostrando o tempo médio de resposta.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-average-response-time.png) | Tempo médio de resposta O tempo médio que o Amazon Translate demorou para processar a solicitação durante o período especificado. |
| ![\[Gráfico mostrando a contagem de caracteres.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-character-count.png) | Contagem de caracteresO número total de caracteres que você enviou para o Amazon Translate durante o período especificado. Essa é a quantidade de caracteres pela qual você será cobrado. |
| ![\[Gráfico mostrando as contagens de erros do usuário.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-user-error-count.png) | Contagem de erros do usuárioA quantidade de erros do usuário durante o período especificado. Os erros do usuário estão no intervalo de 400 a 499 dos códigos de erros HTTP. |
| ![\[Gráfico mostrando as contagens de erros do sistema.\]](http://docs.aws.amazon.com/pt_br/translate/latest/dg/images/metric-system-error-count.png) | Contagem de erros do sistemaA quantidade de erros do sistema durante o período especificado. Os erros do sistema estão no intervalo de 500 a 599 dos códigos de erros HTTP. |
## Monitoramento do Amazon Translate
Com a Amazon CloudWatch, você pode obter métricas para operações individuais do Amazon Translate ou métricas globais do Amazon Translate para sua conta. Use métricas para rastrear a integridade das soluções do Amazon Translate e configurar alarmes para notificar você quando uma ou mais métricas estiverem fora de um limite definido. Por exemplo, você pode monitorar o número de solicitações feitas para o Amazon Translate em um determinado período, além de ver a latência das solicitações ou acionar um alarme quando os erros excederem um limite.
### Entendendo CloudWatch as métricas do Amazon Translate
Para obter métricas para as operações do Amazon Translate, especifique as seguintes informações:
+ A dimensão da métrica. Uma *dimensão* é um conjunto de pares de nome-valor que você usa para identificar uma métrica. O Amazon Translate tem duas dimensões:
+ `Operation`
+ `Language pair`
+ O nome da métrica, como `SuccessfulRequestCount` ou `RequestCharacters`. Para obter uma lista completa de métricas, consulte [CloudWatch Métricas para o Amazon Translate](translate-cloudwatch.md#translate-cloudwatch-metrics).
Você pode obter métricas para o Amazon Translate com a Console de gerenciamento da AWS AWS CLI, a ou a CloudWatch API. Você pode usar a CloudWatch API por meio de um dos kits de desenvolvimento de software da Amazon AWS (SDKs) ou das ferramentas de CloudWatch API.
A tabela a seguir lista alguns usos comuns CloudWatch das métricas. Essas são sugestões para você começar, e não uma lista abrangente.
| Como eu faço para... | Monitorar esta métrica |
| --- | --- |
| Acompanhar o número de solicitações bem-sucedidas | A estatística sum da métrica SuccessfulRequestCount |
| Verificar se meu aplicativo atingiu a taxa de transferência máxima | A estatística sum da métrica ThrottledCount |
| Verificar o tempo de resposta do meu aplicativo | A estatística average da métrica ResponseTime |
| Encontrar a quantidade de erros do meu aplicativo | A estatística sum das métricas ServerErrorCount e UserErrorCount |
| Encontrar a quantidade de caracteres faturáveis | A estatística sum da métrica CharacterCount |
Você deve ter as CloudWatch permissões apropriadas para monitorar o Amazon Translate com. CloudWatch Para obter mais informações, consulte [Autenticação e controle de acesso para a Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) *no Guia CloudWatch do usuário* da Amazon.
### Visualizar métricas do Amazon Translate
Veja as métricas do Amazon Translate no CloudWatch console.
**Para visualizar métricas (CloudWatch console)**
1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Metrics**, **All Metrics** e, em seguida, selecione **AWS/Translate**.
1. Escolha a dimensão, informe um nome de métrica e selecione **Add to graph**.
1. Escolha um valor para o intervalo de datas. A contagem da métrica para o intervalo de datas específico é exibida no gráfico.
# Registro de chamadas da API Amazon Translate com AWS CloudTrail
O Amazon Translate é integrado com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por uma entidade ou AWS serviço do IAM no Amazon Translate. CloudTrail captura todas as chamadas de API para o Amazon Translate como eventos. Isso inclui chamadas do console do Amazon Translate e as chamadas de código para as operações de API do Amazon Translate. Se você criar uma CloudTrail trilha, poderá permitir a entrega contínua de CloudTrail eventos, incluindo eventos para o Amazon Translate, para um bucket do Amazon Simple Storage Service (Amazon S3). Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**. Você pode usar as informações coletadas por CloudTrail para determinar a solicitação que foi feita ao Amazon Translate, o endereço IP a partir do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.
Para saber mais CloudTrail, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
**Topics**
+ [Informações do Amazon Translate em CloudTrail](#translate-info-in-cloudtrail)
+ [Noções básicas sobre entradas de arquivos de log do Amazon Translate](#understanding-translate-entries)
## Informações do Amazon Translate em CloudTrail
CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando a atividade ocorre no Amazon Translate, essa atividade é registrada em um CloudTrail evento junto com outros eventos AWS de serviço no **histórico de eventos**. Você pode visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte [Visualização de eventos com histórico de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para um registro contínuo de eventos em sua AWS conta, incluindo eventos para o Amazon Translate, crie uma trilha. Uma *trilha* permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, ao criar uma trilha com o console, a trilha é aplicada a todas as regiões da AWS. A trilha registra eventos de todas as regiões na partição da AWS e fornece os arquivos de log ao bucket do S3 que você especificar. Você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros. Para saber mais, consulte:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [ CloudTrail Serviços e integrações compatíveis](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurando notificações do Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Recebendo arquivos de CloudTrail log de](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) várias contas
Todas as ações do Amazon Translate são registradas CloudTrail e documentadas na [seção de referência da API](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html). Por exemplo, chamadas para o `DeleteTerminology` `ImportTerminology` e `TranslateText` as ações geram entradas nos arquivos de CloudTrail log.
Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações ajudam a identificar:
+ Se a solicitação foi feita com credenciais de usuário raiz.
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado
+ Se a solicitação foi feita por outro AWS serviço
Para obter mais informações, consulte [Elemento userIdentity do CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Noções básicas sobre entradas de arquivos de log do Amazon Translate
Uma *trilha* é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.
O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a `TranslateText` ação.
```
{
"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 e dimensões do Amazon Translate
Para monitorar o desempenho da sua solução, use as CloudWatch métricas e dimensões da Amazon para o Amazon Translate.
## CloudWatch Métricas para o Amazon Translate
| Métrica | Description |
| --- | --- |
| CharacterCount | O número de caracteres faturáveis nas solicitações. Dimensões válidas: par de idiomas e operação Estatísticas válidas: média, máximo, mínimo e soma Unidade: Contagem |
| ResponseTime | O tempo que levou para responder a uma solicitação. Dimensões válidas: par de idiomas e operação Estatísticas válidas: exemplos de dados, média Unidade: para exemplos de dados, contagem. Para estatísticas médias, milissegundos. |
| ServerErrorCount | O número de erros do servidor. O intervalo de códigos de resposta HTTP para um erro de servidor vai de 500 até 599. Dimensão válida: operação Estatísticas válidas: média e soma Unidade: Contagem |
| SuccessfulRequestCount | A quantidade de solicitações de tradução bem-sucedidas. O código de resposta para uma solicitação bem-sucedida vai de 200 até 299. Dimensão válida: operação Estatísticas válidas: média e soma Unidade: Contagem |
| ThrottledCount | A quantidade de solicitações sujeitas ao controle de utilização. Use `ThrottledCount` para determinar se a aplicação está enviando solicitações ao Amazon Translate de maneira mais rápida do que sua conta está configurada para aceitar. Para obter mais informações, consulte [Limites de tradução da Amazon](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate) em *Referência geral da Amazon Web Services*. Dimensão válida: operação Estatísticas válidas: média e soma Unidade: Contagem |
| UserErrorCount | A quantidade de erros de usuário. O intervalo de códigos de resposta HTTP para um erro de usuário vai de 400 até 499. Dimensão válida: operação Estatísticas válidas: média e soma Unidade: Contagem |
## CloudWatch Dimensões do Amazon Translate
Use as seguintes dimensões para filtrar as métricas do Amazon Translate. As métricas são agrupadas pelo idioma de origem e o idioma de destino.
| Dimensão | Description |
| --- | --- |
| LanguagePair | Restringe as métricas apenas àquelas que contêm os idiomas especificados. |
| Operation | Restringe as métricas apenas àquelas que contêm a operação especificada. |
# Monitoramento de eventos do Amazon Translate com a Amazon EventBridge
O Amazon Translate se integra EventBridge à Amazon para notificá-lo sobre mudanças que afetam seus trabalhos de tradução e recursos de dados paralelos. Os eventos dos AWS serviços são entregues quase EventBridge em tempo real. Você pode escrever regras simples para indicar quais eventos são do seu interesse, e as ações automatizadas a serem tomadas quando um evento corresponder à regra. Por exemplo, ações que podem ser iniciadas automaticamente incluem:
+ Invocando uma função AWS Lambda
+ Invocando o comando de execução do AWS Systems Manager
+ Transmitir o evento Amazon Kinesis Data Streams
+ Ativando uma máquina de AWS Step Functions estado
+ Notificar um tópico do Amazon SNS ou uma fila do Amazon SQS
Para obter mais informações, consulte [Criação de EventBridge regras da Amazon que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia EventBridge do usuário da Amazon*.
## Eventos do Amazon Translate
Veja a seguir exemplos de eventos do Amazon Translate.
### Eventos para trabalhos de tradução em lote
Você executa trabalhos de tradução em lote usando o console do Amazon Translate ou a [StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)operação. O Amazon Translate envia eventos quando esses trabalhos são concluídos, com ou sem sucesso. Esses eventos se assemelham ao exemplo a seguir.
```
{
"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"
}
}
```
O valor do atributo `jobStatus` depende do estado do trabalho para o qual o Amazon Translate enviou o evento. Os valores `jobStatus` são:
+ `COMPLETED` – O trabalho foi concluído com êxito e a saída está disponível.
+ `COMPLETED_WITH_ERROR` – O trabalho foi concluído com erros. Os erros podem ser analisados na saída do trabalho.
+ `STOPPED` – O trabalho foi interrompido.
+ `FAILED` – O trabalho não foi concluído. Para obter detalhes, use a [DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)operação.
### Eventos para recursos de dados paralelos
Quando você usa o Amazon Translate para criar ou atualizar um recurso de dados paralelo, ele envia um evento para indicar se a operação foi bem-sucedida ou falhou.
Você cria recursos de dados paralelos usando o console do Amazon Translate ou a [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)operação. Ao fazer isso, o Amazon Translate envia um evento como o seguinte.
```
{
"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"
}
}
```
Os valores do atributo `status` são:
+ `ACTIVE`: a operação `CreateParallelData ` foi bem-sucedida e o recurso está pronto para ser usado.
+ `FAILED` – Falha na operação `CreateParallelData`.
Você atualiza recursos de dados paralelos usando o console do Amazon Translate ou a [UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)operação. Ao fazer isso, o Amazon Translate envia um evento como o seguinte.
```
{
"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"
}
}
```
O atributo `status` fornece o status da versão anterior do recurso de dados paralelo, que está sendo substituído pela atualização. Os valores são:
+ `ACTIVE` – A versão anterior foi criada ou atualizada com sucesso.
+ `FAILED` – A versão anterior falhou ao ser criada ou atualizada.
O atributo `latestUpdateAttemptStatus` fornece o status da nova versão do recurso de dados paralelo, que está sendo criado pela atualização. Os valores são:
+ `ACTIVE` – A operação `UpdateParallelData` foi bem-sucedida e o recurso atualizado está pronto para ser usado.
+ `FAILED`: a operação `UpdateParallelData` falhou.