En este documento, se describe cómo crear y ejecutar un trabajo por lotes que instale automáticamente el Agente de operaciones. Instalar el Agente de operaciones para proporcionar métricas adicionales en Cloud Monitoring sobre el rendimiento de la de Google Cloud. Para obtener más información sobre el uso de las métricas de rendimiento de los recursos en un trabajo, consulta Supervisa y optimiza los recursos del trabajo mediante la visualización de 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:
-
A fin de obtener los permisos que necesitas para crear un trabajo, solicita a tu administrador que te otorgue el 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
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 asegurarte de que la cuenta de servicio del trabajo tenga permisos para escribir métricas del Agente de operaciones a Monitoring, solicita a tu administrador que otorgue 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 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 requisitos siguientes:
Asegúrate de que las VMs del trabajo usen una sistema operativo (SO) compatible con el Agente de operaciones. Para obtener más información sobre la imagen de SO de la VM para un trabajo, consulta Descripción general del entorno del SO para las VMs de un trabajo.
Si tu trabajo usa una configuración de red no predeterminada los Controles del servicio de VPC, asegúrate de que el trabajo cumpla con 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 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
incluye el
Campo installOpsAgent
Establécelo en true
en el campo allocationPolicy.instances
del cuerpo principal de la
Archivo JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Por ejemplo, un trabajo que instala automáticamente el Agente de operaciones puede tener un archivo de Terraform que es 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 para 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 las 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.