Este documento descreve como criar e executar um job em lote que instala automaticamente o Agente de operações. Instale o agente de operações para fornecer mais métricas no Cloud Monitoring sobre a performance dos recursos de um job. Para saber mais sobre como usar métricas de performance de recursos para um job, consulte Monitorar e otimizar recursos de jobs visualizando métricas.
Antes de começar
- Se você nunca usou o Batch, consulte Introdução ao Batch e ative o Batch concluindo os pré-requisitos para projetos e usuários.
- Se o projeto ainda não tiver, ative as APIs Cloud Monitoring e Cloud Logging:
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (
roles/serviceusage.serviceUsageAdmin), que contém a permissãoserviceusage.services.enable. Saiba como conceder papéis. -
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 do Batch (
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 do Batch (
-
Para visualizar 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 usando personalizados papéis ou outros predefinidos papéis.
-
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 os seguintes papéis do IAM à conta de serviço do job:
- 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 usa o agente de operações, ele precisa atender 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 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 do Cloud Logging ou do Cloud Monitoring legados, 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 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
installOpsAgent campo
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, você poderá conferir 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.
- Visualizar jobs e tarefas.
- Saiba mais sobre outras opções de criação de jobs .