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 outras métricas 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 do job visualizando métricas.
Antes de começar
- Se você nunca usou o Batch, consulte Primeiros passos com ele e ative-o concluindo os pré-requisitos para projetos e usuários.
- Ative as APIs Cloud Monitoring e Cloud Logging no seu projeto:
-
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 ver os registros:
Visualizador de registros (
roles/logging.viewer
) no projeto
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Também é possível receber as permissões necessárias com papéis personalizados ou 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 do job planejado atende aos requisitos do Agente de operações.
Requisitos do Agente de operações
Para criar e executar um job que use o Agente de operações, ele precisa estar em conformidade com 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 para 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 que não seja padrão ou usar VPC Service Controls, verifique se ele atende aos requisitos de acesso do Agente de operações. Para mais informações, consulte VMs sem acesso remoto ao pacote na documentação de observabilidade do Google Cloud.
Verifique se o job não instala um agente legado do Cloud Logging ou do Cloud Monitoring, por exemplo, por uma imagem personalizada ou um modelo de instância.
Para mais informações sobre os recursos e requisitos do Agente de operações, consulte Visão geral do Agente de operações na documentação de observabilidade do Google Cloud.
Criar um job que instale 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 ao seguinte:
{
"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, será possível ver as métricas do Agente de operações da mesma forma que qualquer outra métrica de recursos. Para mais informações, consulte Monitorar e otimizar recursos do job visualizando métricas.
A seguir
- Se você tiver problemas para criar ou executar um job, consulte Solução de problemas.
- Ver tarefas e tarefas.
- Saiba mais sobre as opções de criação de jobs.