Usando CloudWatch métricas com AWS Batch

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 e Uso de CloudWatch alarmes no Guia do CloudWatch usuário da Amazon.

O comportamento de geração de relatórios para Trabalhos de matriz e Multi-node trabalhos paralelos 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 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

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 paraPENDING. 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 paraRUNNABLE, 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 paraSTARTING.
JobsMovedToRunning	O número de empregos que foram transferidos para o RUNNING estado.	Contagem	Emitido quando uma tarefa é transferida paraRUNNING.
JobsMovedToSucceeded	O número de trabalhos concluídos com êxito.	Contagem	Emitido quando uma tarefa é transferida paraSUCCEEDED.
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 deRUNNABLE.	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 tornouRUNNABLE.
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 (SUCCEEDEDouFAILED) 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 emSTARTING.	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 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 emSCHEDULED.	Milissegundos	Emitido para trabalhos de serviço quando o trabalho é transferido pela primeira vez paraSCHEDULED.
JobAttemptRunnableToScheduledDuration	O tempo gasto por uma tentativa de emprego RUNNABLE antes de ser transferida paraSCHEDULED.	Milissegundos	Emitido por tentativa quando uma tarefa de serviço é transferida paraSCHEDULED, 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 paraSTARTING.	Milissegundos	Emitido para trabalhos de serviço quando o trabalho passa de SCHEDULED paraSTARTING.
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

AWS Batch representa Trabalhos de matriz e Multi-node trabalhos paralelos 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 porJobsSubmitted. 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, comoJobSubmittedToRunnableDuration, 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

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

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.

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

1. Abra o console do AWS Batch.

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

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

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

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

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

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

2. Escolha a guia Monitoring (Monitoramento).

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

4. 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 e escolha o AWS/Batch namespace. CloudWatch