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á.

# Usando CloudWatch métricas com AWS Batch
<a name="using_cloudwatch_metrics"></a>

AWS Batch publica métricas de trabalho na Amazon CloudWatch para monitorar as transições de estado e a duração dos trabalhos à medida que eles avançam em seu ciclo de vida. AWS Batch publica essas métricas no `AWS/Batch` namespace sem custo adicional.

As métricas são emitidas à medida que os trabalhos transitam entre estados e quando as tentativas de trabalho são concluídas. As métricas de transição de estado rastreiam quantos empregos entraram em um determinado estado, e as métricas de duração rastreiam quanto tempo os empregos ou tentativas de emprego passaram na mudança entre os estados. Use essas métricas para criar CloudWatch painéis, definir CloudWatch alarmes e estabelecer linhas de base de desempenho para suas cargas de trabalho. Para obter mais informações, consulte [ Uso de CloudWatch métricas ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) e [ Uso de CloudWatch alarmes ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) no Guia * do CloudWatch usuário * da Amazon.

O comportamento de geração de relatórios para [Trabalhos de matriz](array_jobs.md) e [Multi-node trabalhos paralelos](multi-node-parallel-jobs.md) difere dos trabalhos de nó único. A ** coluna Comportamento de ** relatórios na tabela a seguir observa esses casos e [Métricas para trabalhos de matriz e trabalhos paralelos de vários nós](#cloudwatch_metrics_array_mnp) descreve detalhadamente o comportamento da matriz e do MNP.

**nota**  
AWS Batch emite essas métricas para trabalhos enviados a uma fila de trabalhos. Todas as métricas são publicadas com a `JobQueueName` dimensão. Você pode usar essa dimensão para agrupar e filtrar dados métricos pela fila de trabalhos para a qual um trabalho foi enviado.

**Importante**  
Essas métricas são fornecidas com base no melhor esforço possível e têm como objetivo monitorar e observar, em vez de cobrança, auditoria ou reconciliação. Como as transições de estado de trabalho são orientadas por eventos, uma métrica pode ser perdida ocasionalmente. Por exemplo, se um trabalho começar a ser executado e, em seguida, for bem-sucedido ou falhar quase imediatamente, a transição para o `RUNNING` estado pode não ser observada antes que o trabalho atinja seu estado terminal. Nesse caso, AWS Batch não emite as métricas associadas à `RUNNING` transição para esse trabalho. Crie alarmes ou painéis para tolerar lacunas ocasionais e não confie nas contagens exatas derivadas dessas métricas.

## AWS Batch CloudWatch métricas
<a name="cloudwatch_metrics_available"></a>

AWS Batch envia as seguintes métricas de trabalho para CloudWatch. As métricas de transição de estado usam a `Count` unidade e as métricas de duração usam a `Milliseconds` unidade.

As métricas a seguir se aplicam aos AWS Batch trabalhos, independentemente do tipo.


| Métrica | Description | Unidades | Relatório resultante | 
| --- | --- | --- | --- | 
| `JobsSubmitted` | O número de trabalhos que foram enviados para a fila de trabalhos. | Contagem | Emitido quando um trabalho é enviado pela primeira vez (entra no `SUBMITTED` estado). Para um trabalho de matriz, o valor é o tamanho da matriz. | 
| `JobsMovedToPending` | O número de empregos que foram transferidos para o `PENDING` estado. | Contagem | Emitido quando uma tarefa é transferida para`PENDING`. Normalmente, um trabalho ocorre `PENDING` enquanto espera por uma dependência de trabalho. | 
| `JobsMovedToRunnable` | O número de empregos que foram transferidos para o `RUNNABLE` estado. | Contagem | Emitido quando um trabalho é transferido para`RUNNABLE`, pela primeira vez ou como resultado de uma nova tentativa. | 
| `JobsMovedToStarting` | O número de empregos que foram transferidos para o `STARTING` estado. | Contagem | Emitido quando uma tarefa é transferida para`STARTING`. | 
| `JobsMovedToRunning` | O número de empregos que foram transferidos para o `RUNNING` estado. | Contagem | Emitido quando uma tarefa é transferida para`RUNNING`. | 
| `JobsMovedToSucceeded` | O número de trabalhos concluídos com êxito. | Contagem | Emitido quando uma tarefa é transferida para`SUCCEEDED`. | 
| `JobsMovedToFailed` | O número de empregos que foram transferidos para o `FAILED` estado. | Contagem | Emitido quando um trabalho entra no `FAILED` estado. Inclui trabalhos que foram cancelados ou encerrados. | 
| `JobsCancelled` | O número de trabalhos que foram cancelados. | Contagem | Emitido quando um trabalho entra no `FAILED` estado como resultado de uma solicitação de cancelamento (antes de o trabalho começar a ser executado). | 
| `JobsTerminated` | O número de trabalhos que foram encerrados. | Contagem | Emitido quando um trabalho entra no `FAILED` estado como resultado de uma solicitação de encerramento. | 
| `JobsRetried` | O número de tentativas de trabalho que foram repetidas. | Contagem | Emitido quando uma tentativa de trabalho falha e o trabalho é devolvido `RUNNABLE` para ser repetido. | 
| `JobSubmittedToRunnableDuration` | O tempo que um trabalho levou para `SUBMITTED` ir de`RUNNABLE`. | Milissegundos | Emitido quando o trabalho é inserido. `RUNNABLE` Para um trabalho secundário de matriz, isso mede o tempo desde o momento em que o trabalho principal foi submetido até o momento em que o trabalho secundário se tornou`RUNNABLE`. | 
| `JobAttemptStartingToRunningDuration` | O tempo gasto por uma tentativa de trabalho `STARTING` antes de começar a ser executada. | Milissegundos | Emitido por tentativa quando o trabalho é inserido. `RUNNING` Uma nova tarefa emite um ponto de dados por tentativa alcançada. `RUNNING` | 
| `JobAttemptExecutionDuration` | O tempo gasto em execução por uma tentativa de trabalho, medido desde o início até o momento em que foi interrompida. | Milissegundos | Emitido quando uma tentativa de trabalho é concluída, medido desde quando a tentativa começou a ser executada até quando foi interrompida. | 
| `JobAttemptDuration` | O tempo total de duração de uma tentativa de trabalho, medido desde a entrada `STARTING` até o término da tentativa. | Milissegundos | Emitido quando uma tentativa termina. A tentativa termina quando a tarefa atinge um estado terminal (`SUCCEEDED`ou`FAILED`) ou quando volta `RUNNABLE` a ser repetida. | 

As métricas a seguir se aplicam somente a trabalhos AWS Batch de computação.


| Métrica | Description | Unidades | Relatório resultante | 
| --- | --- | --- | --- | 
| `JobSubmittedToFirstStartingDuration` | O tempo que um trabalho levou `SUBMITTED` para passar da primeira vez em`STARTING`. | Milissegundos | Emitido na primeira tentativa, quando a tarefa é iniciada pela primeira vez. `STARTING`  | 
| `JobAttemptRunnableToStartingDuration` | O tempo gasto em uma tentativa de emprego `RUNNABLE` antes de começar. | Milissegundos | Emitido quando o trabalho é inserido. `STARTING` | 

As métricas a seguir se aplicam somente [Empregos de serviços em AWS Batch](service-jobs.md) a.


| Métrica | Description | Unidades | Relatório resultante | 
| --- | --- | --- | --- | 
| `JobsMovedToScheduled` | O número de empregos que foram transferidos para o `SCHEDULED` estado. | Contagem | Emitido para tarefas de serviço quando a tarefa é transferida pela primeira vez e novamente sempre que a tarefa é transferida `SCHEDULED` após uma preempção. `SCHEDULED` | 
| `JobSubmittedToFirstScheduledDuration` | O tempo que um trabalho de serviço levou para passar de `SUBMITTED` sua primeira vez em`SCHEDULED`. | Milissegundos | Emitido para trabalhos de serviço quando o trabalho é transferido pela primeira vez para`SCHEDULED`. | 
| `JobAttemptRunnableToScheduledDuration` | O tempo gasto por uma tentativa de emprego `RUNNABLE` antes de ser transferida para`SCHEDULED`. | Milissegundos | Emitido por tentativa quando uma tarefa de serviço é transferida para`SCHEDULED`, tanto na primeira vez em que a tarefa é transferida `SCHEDULED` quanto a cada vez que ela é transferida `SCHEDULED` após uma preempção. | 
| `JobAttemptScheduledToStartingDuration` | O tempo gasto por uma tentativa de serviço de serviços entre a primeira mudança `SCHEDULED` e a mudança para`STARTING`. | Milissegundos | Emitido para trabalhos de serviço quando o trabalho passa de `SCHEDULED` para`STARTING`. | 
| `JobsPreempted` | O número de empregos que foram cancelados. | Contagem | Emitido para tarefas de gerenciamento de cotas sempre que a tarefa é cancelada. | 

## Métricas para trabalhos de matriz e trabalhos paralelos de vários nós
<a name="cloudwatch_metrics_array_mnp"></a>

AWS Batch representa [Trabalhos de matriz](array_jobs.md) e [Multi-node trabalhos paralelos](multi-node-parallel-jobs.md) como um * trabalho * dos pais que rastreia um ou mais * empregos * infantis. Para que um único trabalho lógico não seja contado duas vezes, AWS Batch emite métricas de apenas um desses dois registros, dependendo do tipo de trabalho.

Trabalhos de matriz  
O trabalho principal da matriz não emite métricas, exceto por`JobsSubmitted`. Em vez disso, cada trabalho secundário de matriz emite essas métricas de forma independente à medida que avança pelo ciclo de vida do trabalho, de modo que as contagens de métricas reflitam o número de trabalhos secundários em vez do número de trabalhos secundários enviados.  
A `JobsSubmitted` métrica é emitida uma vez para o trabalho principal da matriz no envio, e seu valor é o tamanho da matriz (o número de trabalhos secundários). Por exemplo, enviar um trabalho de matriz com 1.000 filhos publica um único ponto de `JobsSubmitted` dados com um valor de. `1000`  
As métricas de duração que medem o tempo desde o envio, como`JobSubmittedToRunnableDuration`, são emitidas por trabalho secundário da matriz e medem desde o momento em que o pai da matriz foi enviado até o momento em que o filho atingiu o estado em questão.

Multi-node trabalhos paralelos (MNP)  
As métricas de MNP são emitidas do trabalho principal do MNP, que representa o trabalho como um todo. Os trabalhos secundários individuais do MNP (node) não emitem essas métricas. Como resultado, uma tarefa MNP é contada uma vez, independentemente de quantos nós ela usa.

## Dimensões do AWS Batch CloudWatch métricas
<a name="cloudwatch_metrics_dimensions"></a>

AWS Batch métricas de trabalho em CloudWatch uso em uma única dimensão:`JobQueueName`. Todos os dados métricos são agrupados e filtrados pelo nome da fila de trabalhos para a qual um trabalho foi enviado.

## Visualizar AWS Batch CloudWatch métricas
<a name="viewing-batch-cloudwatch-metrics"></a>

Você pode visualizar as métricas do AWS Batch trabalho no AWS Batch console ou no CloudWatch console sob o `AWS/Batch` namespace.

**Importante**  
A exibição de métricas no console gera CloudWatch cobranças padrão. Você pode desativar a visualização métrica a qualquer momento para interromper as cobranças. Para obter mais informações, consulte CloudWatch Preços [ da Amazon](https://aws.amazon.com/cloudwatch/pricing/).

**Para visualizar métricas no painel de métricas do Batch **

1. Abra o [console do AWS Batch](https://console.aws.amazon.com/batch).

1. No painel de navegação, escolha ** Painel e, em seguida**, escolha a ** guia Métricas ** em lote.

1. Ative a opção ** Exibir CloudWatch métricas**.

1. Em ** Filtrar métricas**, selecione até cinco filas de ** trabalhos ** e as ** métricas ** que você deseja representar graficamente.

1. Escolha ** Aplicar filtros**. O console mostra um gráfico por métrica, com uma linha por fila de tarefas.

1. Para recomeçar, escolha ** Limpar filtros ** para remover suas seleções ou ** Redefinir filtros ** para restaurar os padrões.

1. (Opcional) Para reutilizar uma combinação de filas de tarefas e métricas, trabalhe com um conjunto de filtros salvo. Os conjuntos de filtros são salvos nas preferências AWS do usuário, para que persistam em todas as sessões, e você pode salvar até cinco. Gerencie-os no menu ** suspenso Conjuntos de filtros ** salvos e no menu de setas no ** botão ** Limpar filtros e escolha uma das seguintes opções:
   + **Salvar ** - selecione suas filas de trabalho e métricas e escolha ** Salvar como novo conjunto ** de filtros. Insira um nome exclusivo e, opcionalmente, marque-o como padrão.
   + **Aplicar ** - Escolha um conjunto no menu ** suspenso Conjuntos de filtros ** salvos e escolha ** Aplicar filtros**.
   + **Atualizar ** - Com um conjunto selecionado, altere suas seleções e escolha ** Atualizar conjunto ** de filtros atual.
   + **Definir como padrão ** - Com um conjunto selecionado, escolha ** Configurações e, em seguida**, ** Definir como padrão**. O conjunto padrão é carregado automaticamente quando você abre a guia.
   + **Excluir ** - Com um conjunto selecionado, escolha ** Excluir conjunto de filtros atual**.

**Para visualizar as métricas de uma única fila de trabalhos **

1. No painel de navegação, escolha Filas de ** trabalhos e, em seguida**, escolha uma fila de trabalhos.

1. Escolha a guia **Monitoring (Monitoramento)**.

1. Ative a opção ** Exibir CloudWatch métricas**.

1. Nas ** seções Métricas de transição de ** estado**, métricas de eventos ** do ciclo de vida e ** Métricas de ** duração, use cada seletor de métricas para escolher quais métricas representar graficamente.

As métricas mostradas têm como escopo essa fila de trabalhos. Suas seleções são salvas por fila de trabalhos e persistem em todas as sessões.

Para trabalhar com essas métricas diretamente, por exemplo, para criar painéis ou definir alarmes, abra o [ CloudWatch console ](https://console.aws.amazon.com/cloudwatch) e escolha o `AWS/Batch` namespace. CloudWatch