En este documento, se describe cómo crear y ejecutar un trabajo por lotes que instala de forma automática el Agente de operaciones. Instala el Agente de operaciones para proporcionar métricas adicionales en Cloud Monitoring sobre el rendimiento de los recursos de un trabajo. Si quieres obtener más información sobre el uso de las métricas de rendimiento de los recursos para un trabajo, consulta Supervisa y optimiza los recursos del trabajo mediante la visualización de las métricas.
Antes de comenzar
- Si no usaste Batch antes, revisa Comienza a usar Batch y habilita Batch. Para ello, completa los requisitos previos para proyectos y usuarios.
- Si tu proyecto aún no lo ha hecho, habilita las APIs de Cloud Monitoring y Cloud Logging:
-
Si deseas 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 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, haz lo siguiente:
Visor de registros (
roles/logging.viewer
) en el proyecto
Si quieres obtener más información para otorgar roles, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios a través de funciones personalizadas o, también, otras funciones predefinidas.
-
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 asegurarte de que la cuenta de servicio del trabajo tenga los permisos necesarios para escribir métricas del Agente de operaciones en Monitoring, pídele a tu administrador que otorgue los siguientes roles de IAM a la cuenta de servicio del trabajo:
-
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 tu trabajo planificado cumpla con los requisitos del Agente de operaciones.
Requisitos del Agente de operaciones
Para crear y ejecutar un trabajo que use el Agente de operaciones, tu trabajo debe cumplir con todos los siguientes requisitos:
Asegúrate de que las VMs del trabajo usen un sistema operativo (SO) compatible con el Agente de operaciones. Para obtener más información sobre la imagen de SO de la VM de un trabajo, consulta la Descripción general del entorno de SO para las VMs de un trabajo.
Si tu trabajo usa una configuración de red no predeterminada o los Controles del servicio de VPC, asegúrate de que el trabajo cumpla con los requisitos de acceso para el 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 el trabajo no instale un agente de Cloud Logging heredado o un agente de Cloud Monitoring, por ejemplo, a través de una imagen personalizada o una plantilla de instancias.
Para obtener más información sobre las funciones y los requisitos del Agente de operaciones, consulta 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 como true
en el campo allocationPolicy.instances
del cuerpo principal del archivo JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por ejemplo, un trabajo que instala 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"
}
}
Después de que las VMs del trabajo comiencen a ejecutarse, podrás ver las métricas del Agente de operaciones al igual que cualquier otra métrica de recursos. Para obtener más información, consulta Supervisa y optimiza los recursos del trabajo mediante la visualización de métricas.
¿Qué sigue?
- Si tienes problemas para crear o ejecutar un trabajo, consulta Solución de problemas.
- Visualiza trabajos y tareas.
- Obtén más información sobre las opciones de creación de trabajos.