Ce document explique comment créer et exécuter un job Batch qui installe automatiquement l'agent Ops. Installez l'agent Ops pour fournir des métriques supplémentaires dans Cloud Monitoring sur les performances des ressources d'un job. Pour savoir comment utiliser les métriques de performances des ressources pour un job, consultez Surveiller et optimiser les ressources des jobs en affichant les métriques.
Avant de commencer
- Si vous n'avez jamais utilisé Batch, consultez Premiers pas avec Batch et activez Batch en remplissant les conditions préalables pour les projets et les utilisateurs.
- Si ce n'est pas déjà fait, activez les API Cloud Monitoring et Cloud Logging pour votre projet :
-
Pour obtenir les autorisations nécessaires pour créer un job, demandez à votre administrateur de vous accorder les rôles IAM suivants :
-
Pour créer un job :
-
Éditeur de tâches par lot (
roles/batch.jobsEditor
) sur le projet -
Utilisateur du compte de service (
roles/iam.serviceAccountUser
) sur le compte de service du job, qui est par défaut le compte de service Compute Engine par défaut
-
Éditeur de tâches par lot (
-
Pour afficher les journaux :
Lecteur de journaux (
roles/logging.viewer
) sur le projet
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
-
Pour créer un job :
À moins que vous n'utilisiez la configuration par défaut pour le compte de service du job, assurez-vous qu'il dispose des autorisations nécessaires.
Pour vous assurer que le compte de service du job dispose des autorisations nécessaires pour écrire des métriques de l'agent Ops dans Monitoring, demandez à votre administrateur d'accorder au compte de service du job les rôles IAM suivants :
-
Rédacteur de métriques Monitoring (
roles/monitoring.metricWriter
) sur le projet -
Rédacteur de journaux (
roles/logging.logWriter
) sur le projet
-
Rédacteur de métriques Monitoring (
- Assurez-vous que la configuration de votre tâche planifiée répond aux exigences de l'agent Ops.
Exigences de l'agent Ops
Pour créer et exécuter un job qui utilise l'agent Ops, votre job doit répondre à toutes les exigences suivantes :
Assurez-vous que les VM du job utilisent un système d'exploitation compatible avec l'Agent Ops. Pour en savoir plus sur l'image de l'OS de VM pour un job, consultez Présentation de l'environnement OS pour les VM d'un job.
Si votre job utilise une configuration réseau non définie par défaut ou VPC Service Controls, assurez-vous qu'il répond aux exigences d'accès de l'agent Ops. Pour en savoir plus, consultez VM sans accès au package distant dans la documentation Google Cloud Observability.
Assurez-vous que la tâche n'installe pas d'ancien agent Cloud Logging ni d'ancien agent Cloud Monitoring (par exemple, via une image ou un modèle d'instance personnalisés).
Pour en savoir plus sur les fonctionnalités et les exigences de l'agent Ops, consultez la présentation de l'agent Ops dans la documentation Google Cloud Observability.
Créer un job qui installe automatiquement l'agent Ops
Utilisez la Google Cloud CLI ou l'API REST pour créer un job qui inclut le champ installOpsAgent
défini sur true
dans le champ allocationPolicy.instances
du corps principal du fichier JSON :
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Par exemple, un job qui installe automatiquement l'agent Ops peut avoir un fichier de configuration JSON semblable à ce qui suit :
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello World! This is task $BATCH_TASK_INDEX."
}
}
]
},
"taskCount": 3,
}
],
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Une fois que les VM du job ont commencé à s'exécuter, vous pouvez afficher les métriques de l'agent Ops de la même manière que les métriques d'autres ressources. Pour en savoir plus, consultez Surveiller et optimiser les ressources des jobs en affichant les métriques.
Étapes suivantes
- Si vous rencontrez des problèmes pour créer ou exécuter un job, consultez la section Dépannage.
- Afficher les jobs et les tâches
- Découvrez d'autres options de création de tâches.