En este documento, se describe cómo crear y ejecutar un trabajo por lotes que instala automáticamente 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. Para obtener más información sobre el uso de métricas de rendimiento de recursos para un trabajo, consulta Supervisa y optimiza los recursos del trabajo mediante la visualización de métricas.
Antes de comenzar
- Si nunca usaste Batch, revisa Comienza 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:
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles. -
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:
- Editor de trabajos de Batch (
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 de Batch (
-
Para ver los registros:
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:
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 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 del 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 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 o usa 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 ni un agente de Cloud Monitoring heredados, 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 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
installOpsAgent campo
establecido en true en el campo allocationPolicy.instances en el 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 de la misma manera 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.
- Consulta trabajos y tareas.
- Obtén información sobre más opciones de creación de trabajos.