En este documento se describe cómo crear y ejecutar un trabajo por lotes que instale automáticamente el agente de Ops. Instala el agente de operaciones para proporcionar métricas adicionales en Cloud Monitoring sobre el rendimiento de los recursos de un trabajo. Para obtener más información sobre cómo usar las métricas de rendimiento de los recursos de un trabajo, consulta Monitorizar y optimizar los recursos de los trabajos viendo las métricas.
Antes de empezar
- Si no has usado Batch antes, consulta el artículo Empezar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.
- Si aún no lo ha hecho, habilite las APIs Cloud Monitoring y Cloud Logging en su proyecto:
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 obtener los permisos que necesitas para crear un trabajo, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:
-
Para crear un trabajo, sigue estos pasos:
-
Editor de trabajos por lotes (
roles/batch.jobsEditor
) en el proyecto -
Usuario de 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, sigue estos pasos:
Visualizador de registros (
roles/logging.viewer
) del proyecto
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
-
Para crear un trabajo, sigue estos pasos:
A menos que uses la configuración predeterminada de la cuenta de servicio del trabajo, asegúrate de que tenga los permisos necesarios.
Para asegurarte de que la cuenta de servicio del trabajo tenga los permisos necesarios para escribir métricas del agente de operaciones en Monitoring, pide a tu administrador que conceda a la cuenta de servicio del trabajo los siguientes roles de gestión de identidades y accesos:
-
Editor de las métricas de monitorización (
roles/monitoring.metricWriter
) en el proyecto -
Editor de registros (
roles/logging.logWriter
) en el proyecto
-
Editor de las métricas de monitorización (
- Asegúrate de que la configuración del trabajo planificado cumpla los requisitos del agente de operaciones.
Requisitos del agente de operaciones
Para crear y ejecutar un trabajo que use el agente de operaciones, este debe cumplir todos los requisitos siguientes:
Asegúrate de que las VMs del trabajo usen un sistema operativo compatible con el agente de Ops. Para obtener más información sobre la imagen del SO de la VM de un trabajo, consulta Información general sobre el entorno del SO de las VMs de un trabajo.
Si tu trabajo usa una configuración de red no predeterminada o usa Controles de Servicio de VPC, asegúrate de que cumpla los requisitos de acceso del agente de operaciones. Para obtener más información, consulta el artículo VMs without remote package access (Máquinas virtuales sin acceso a paquetes remotos) en la documentación de Google Cloud Observability.
Asegúrate de que el trabajo no instale un agente de Cloud Logging antiguo ni un agente de Cloud Monitoring (por ejemplo, a través de una imagen personalizada o una plantilla de instancia).
Para obtener más información sobre las funciones y los requisitos del agente de Ops, consulta la descripción general del agente de Ops en la documentación de Observabilidad de Google Cloud.
Crear un trabajo que instale automáticamente el agente de operaciones
Usa Google Cloud CLI o la API REST para crear un trabajo que incluya el campo installOpsAgent
con el valor true
en el campo allocationPolicy.instances
del cuerpo principal del archivo JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por ejemplo, un trabajo que instale automáticamente el agente de Ops 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 del trabajo empiecen a ejecutarse, podrá ver las métricas del agente de operaciones igual que cualquier otra métrica de recursos. Para obtener más información, consulta el artículo Monitorizar y optimizar los recursos de las tareas viendo las métricas.
Siguientes pasos
- Si tienes problemas para crear o ejecutar un trabajo, consulta la sección Solución de problemas.
- Ver trabajos y tareas.
- Consulta más información sobre las opciones para crear trabajos.