Neste documento, descrevemos como criar e executar um job do Batch que instala automaticamente o Agente de operações. Instale o Agente de operações para fornecer métricas adicionais no Cloud Monitoring sobre o desempenho dos recursos de um job. Para saber mais sobre como usar métricas de desempenho de recursos em um job, consulte Monitorar e otimizar recursos de jobs visualizando métricas.
Antes de começar
- Se você nunca usou o Batch, leia Começar a usar o Batch e ative o serviço concluindo os pré-requisitos para projetos e usuários.
- Se ainda não tiver feito isso, ative as APIs Cloud Monitoring e Cloud Logging:
-
Para receber as permissões necessárias para criar um job, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Para criar um job:
-
Editor de jobs em lote (
roles/batch.jobsEditor
) no projeto -
Usuário da conta de serviço (
roles/iam.serviceAccountUser
) na conta de serviço do job, que por padrão é a conta de serviço padrão do Compute Engine
-
Editor de jobs em lote (
-
Para conferir os registros:
Leitor de registros (
roles/logging.viewer
) no projeto
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
-
Para criar um job:
A menos que você esteja usando a configuração padrão para a conta de serviço do job, verifique se ela tem as permissões necessárias.
Para garantir que a conta de serviço do job tenha as permissões necessárias para gravar métricas do agente de operações no Monitoring, peça ao administrador para conceder à conta de serviço do job os seguintes papéis do IAM:
-
Gravador de métricas do Monitoring (
roles/monitoring.metricWriter
) no projeto -
Gravador de registros (
roles/logging.logWriter
) no projeto
-
Gravador de métricas do Monitoring (
- Verifique se a configuração planejada do job atende aos requisitos do Agente de operações.
Requisitos do agente de operações
Para criar e executar um job que usa o Agente de operações, ele precisa obedecer a todos os requisitos a seguir:
Verifique se as VMs do job usam um sistema operacional (SO) compatível com o agente de operações. Para mais informações sobre a imagem do SO da VM de um job, consulte Visão geral do ambiente do SO para as VMs de um job.
Se o job usar uma configuração de rede não padrão ou o VPC Service Controls, verifique se ele atende aos requisitos de acesso do Agente de operações. Para mais informações, consulte VMs sem acesso a pacotes remotos na documentação do Google Cloud Observability.
Verifique se o job não instala um agente legado do Cloud Logging ou do Cloud Monitoring, por exemplo, usando uma imagem personalizada ou um modelo de instância.
Para mais informações sobre os recursos e requisitos do agente de operações, consulte a visão geral do agente de operações na documentação do Google Cloud Observability.
Criar um job que instala automaticamente o agente de operações
Use a Google Cloud CLI ou a API REST para criar um job que inclua o campo installOpsAgent
definido como true
no campo allocationPolicy.instances
no corpo principal do arquivo JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por exemplo, um job que instala automaticamente o Agente de operações pode ter um arquivo de configuração JSON semelhante a este:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Depois que as VMs do job começarem a ser executadas, você poderá ver as métricas do Agente de operações da mesma forma que qualquer outra métrica de recurso. Para mais informações, consulte Monitorar e otimizar recursos de jobs visualizando métricas.
A seguir
- Se você tiver problemas para criar ou executar um job, consulte Solução de problemas.
- Ver jobs e tarefas.
- Saiba mais sobre outras opções de criação de jobs.