En este documento, se describe cómo crear y ejecutar un trabajo por lotes que instale automáticamente el Agente de operaciones. Instala el agente de Ops para proporcionar métricas adicionales en Cloud Monitoring sobre el rendimiento de los recursos de una tarea. Para obtener más información sobre el uso de métricas de rendimiento de recursos para un trabajo, consulta Cómo supervisar y optimizar los recursos de un trabajo mediante las métricas.
Antes de comenzar
- Si nunca usaste Batch, consulta Cómo comenzar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.
- Si tu proyecto aún no lo hizo, habilita las APIs de Cloud Monitoring y Cloud Logging:
-
Para obtener los permisos que necesitas para crear un trabajo, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Para crear un trabajo, sigue estos pasos:
-
Editor de trabajos por lotes (
roles/batch.jobsEditor
) en el proyecto -
Usuario de la cuenta de servicio (
roles/iam.serviceAccountUser
) en la cuenta de servicio del trabajo, que de forma predeterminada es la cuenta de servicio predeterminada de Compute Engine
-
Editor de trabajos por lotes (
-
Para ver los registros, usa el Visualizador de registros (
roles/logging.viewer
) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
-
Para crear un trabajo, sigue estos pasos:
A menos que uses la configuración predeterminada para la cuenta de servicio del trabajo, asegúrate de que tenga los permisos necesarios.
Para garantizar que la cuenta de servicio del trabajo tenga los permisos necesarios para escribir métricas del agente de operaciones en la supervisión, pídele al administrador que le otorgue a la cuenta de servicio del trabajo los siguientes roles de IAM:
-
Escritor de métricas de Monitoring (
roles/monitoring.metricWriter
) en el proyecto -
Escritor de registros (
roles/logging.logWriter
) en el proyecto
-
Escritor de métricas de Monitoring (
- Asegúrate de que la configuración de la tarea planificada cumpla con los requisitos del agente de operaciones.
Requisitos del agente de operaciones
Para crear y ejecutar una tarea que use el Agente de operaciones, esta debe cumplir con los siguientes requisitos:
Asegúrate de que las VMs del trabajo usen un sistema operativo (SO) que admita el Agente de operaciones. Para obtener más información sobre la imagen del SO de la VM de un trabajo, consulta Descripción general del entorno del SO de las VMs de un trabajo.
Si tu trabajo usa una configuración de red no predeterminada o usa Controles del servicio de VPC, asegúrate de que cumpla con los requisitos de acceso del agente de operaciones. Para obtener más información, consulta VMs sin acceso a paquetes remotos en la documentación de Google Cloud Observability.
Asegúrate de que la tarea no instale un agente de Cloud Logging ni de Cloud Monitoring heredados, por ejemplo, a través de una imagen o plantilla de instancia personalizadas.
Para obtener más información sobre las funciones y los requisitos del agente de operaciones, consulta la descripción general del agente de operaciones en la documentación de Google Cloud Observability.
Crea un trabajo que instale automáticamente el Agente de operaciones
Usa Google Cloud CLI o la API de REST para
crear un trabajo que
incluya el
campo installOpsAgent
configurado en true
en el campo allocationPolicy.instances
en el cuerpo principal del
archivo JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por ejemplo, un trabajo que instale automáticamente el agente de operaciones puede tener un archivo de configuración JSON similar al siguiente:
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Una vez que las VMs de la tarea comiencen a ejecutarse, podrás ver las métricas del agente de operaciones de la misma manera que cualquier otra métrica de recursos. Para obtener más información, consulta Cómo supervisar y optimizar los recursos de trabajo a través de las métricas.
¿Qué sigue?
- Si tienes problemas para crear o ejecutar una tarea, consulta Solución de problemas.
- Ver trabajos y tareas.
- Obtén más información sobre las opciones de creación de trabajos.