Este documento descreve como criar e executar uma tarefa em lote 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 uma tarefa. Para saber como usar as métricas de desempenho dos recursos para uma tarefa, consulte o artigo Monitorize e otimize os recursos das tarefas através da visualização de métricas.
Antes de começar
- Se nunca usou o Batch, reveja o artigo Comece a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e utilizadores.
- Se ainda não o fez, ative as APIs Cloud Monitoring e Cloud Logging:
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles. -
Para receber as autorizações de que precisa para criar uma tarefa, peça ao seu administrador para lhe conceder as seguintes funções de IAM:
-
Para criar uma tarefa:
-
Editor de tarefas de lote (
roles/batch.jobsEditor
) no projeto -
Utilizador da conta de serviço (
roles/iam.serviceAccountUser
) na conta de serviço da tarefa, que, por predefinição, é a conta de serviço predefinida do Compute Engine
-
Editor de tarefas de lote (
-
Para ver registos:
Visualizador de registos (
roles/logging.viewer
) no projeto
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.
-
Para criar uma tarefa:
A menos que esteja a usar a configuração predefinida para a conta de serviço da tarefa, certifique-se de que tem as autorizações necessárias.
Para garantir que a conta de serviço da tarefa tem as autorizações necessárias para escrever métricas do agente de operações no Monitoring, peça ao seu administrador para conceder à conta de serviço da tarefa as seguintes funções do IAM:
-
Monitoring Metric Writer (
roles/monitoring.metricWriter
) no projeto -
Logs Writer (
roles/logging.logWriter
) no projeto
-
Monitoring Metric Writer (
- Certifique-se de que a configuração da tarefa planeada cumpre os requisitos do agente de operações.
Requisitos do Ops Agent
Para criar e executar uma tarefa que use o agente de operações, a tarefa tem de estar em conformidade com todos os seguintes requisitos:
Certifique-se de que as VMs da tarefa usam um sistema operativo (SO) que o agente do Ops suporta. Para mais informações sobre a imagem do SO da VM para uma tarefa, consulte o artigo Vista geral do ambiente do SO para as VMs de uma tarefa.
Se o seu trabalho usar uma configuração de rede não predefinida ou usar os VPC Service Controls, certifique-se de que o trabalho cumpre os requisitos de acesso do agente de operações. Para mais informações, consulte o artigo VMs sem acesso a pacotes remotos na documentação do Google Cloud Observability.
Certifique-se de que a tarefa não instala um agente do Cloud Logging antigo ou um agente do Cloud Monitoring, por exemplo, através de uma imagem personalizada ou de um modelo de instância.
Para mais informações acerca das funcionalidades e dos requisitos do agente de operações, consulte a vista geral do agente de operações na documentação do Google Cloud Observability.
Crie uma tarefa que instale automaticamente o agente de operações
Use a CLI Google Cloud ou a API REST para criar uma tarefa que inclua o campo installOpsAgent
definido como true
no campo allocationPolicy.instances
no corpo principal do ficheiro JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por exemplo, uma tarefa que instala automaticamente o agente de operações pode ter um ficheiro 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 de as VMs da tarefa começarem a ser executadas, pode ver as métricas do agente de operações da mesma forma que qualquer outra métrica de recursos. Para mais informações, consulte o artigo Monitorize e otimize os recursos de tarefas através da visualização de métricas.
O que se segue?
- Se tiver problemas ao criar ou executar uma tarefa, consulte a secção Resolução de problemas.
- Ver empregos e tarefas.
- Saiba mais sobre as opções de criação de tarefas.