Ce document explique comment créer et exécuter un job Batch qui installe automatiquement l'agent Ops. Installer l'agent Ops pour fournir des métriques supplémentaires dans Cloud Monitoring sur les performances des ressources d'une tâche. Pour en savoir plus sur l'utilisation des métriques de performances des ressources pour un job, consultez la page Surveiller et optimiser les ressources de jobs en affichant les métriques.
Avant de commencer
- Si vous n'avez jamais utilisé Batch auparavant, consultez la page 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 obtenir les autorisations nécessaires à la création d'une tâche, demandez à votre administrateur de vous attribuer les rôles IAM suivants:
-
Pour créer une tâche :
-
Éditeur de jobs 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 jobs par lot (
-
Pour afficher les journaux : Visionneuse de journaux (
roles/logging.viewer
) sur le projet
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
-
Pour créer une tâche :
À moins que vous n'utilisiez la configuration par défaut du compte de service du job, assurez-vous qu'il dispose des autorisations nécessaires.
Pour vous assurer que le compte de service de la tâche 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 de la tâche 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 job planifié répond aux exigences de l'agent Ops.
Conditions requises pour l'Agent Ops
Pour créer et exécuter une tâche qui utilise l'agent Ops, celle-ci doit respecter toutes les exigences suivantes:
Assurez-vous que les VM de la tâche utilisent un système d'exploitation (OS) compatible avec l'agent Ops. Pour en savoir plus sur l'image d'OS d'une VM pour une tâche, consultez la page Présentation de l'environnement d'OS pour les VM d'une tâche.
Si votre tâche utilise une configuration réseau autre que celle par défaut ou utilise VPC Service Controls, assurez-vous qu'elle répond aux conditions d'accès pour l'agent Ops. Pour en savoir plus, consultez la page VM sans accès au package distant dans la documentation sur l'observabilité Google Cloud.
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 personnalisée ou un modèle d'instance.
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 une tâche incluant le champ installOpsAgent
défini sur true
dans le champ allocationPolicy.instances
dans le corps principal du fichier JSON:
"allocationPolicy": {
"instances": [
{
"installOpsAgent": true
}
]
}
Par exemple, une tâche qui installe automatiquement l'agent Ops peut disposer d'un fichier de configuration JSON semblable à celui-ci:
{
"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 de la tâche ont commencé à s'exécuter, les métriques de l'agent Ops sont les mêmes que pour toute autre métrique de ressource. Pour en savoir plus, consultez la page Surveiller et optimiser les ressources de tâches en affichant les métriques.
Étapes suivantes
- Si vous rencontrez des problèmes lors de la création ou de l'exécution d'un job, consultez la section Dépannage.
- Afficher les missions et les tâches
- Découvrez d'autres options de création de tâches.