Installer et gérer l'agent Ops à l'aide des règles VM Extension Manager

Vous pouvez installer et gérer l'Agent Ops sur un parc de VM Compute Engine à l'échelle mondiale ou dans une zone spécifique à l'aide des règles du gestionnaire d'extensions de VM. Par exemple, vous pouvez utiliser ces règles pour effectuer des tâches telles que :

  • Installation à l'échelle du parc : installez l'agent Ops sur les éléments suivants :

    • Toutes les VM d'une ou plusieurs zones de votre projet Google Cloud .
    • Toutes les VM à l'échelle mondiale (dans votre projet Google Cloud ).
    • Sous-ensemble de VM dans une zone, identifié par des libellés.
    • Sous-ensemble de VM dans les zones de votre projet Google Cloud , identifié par des libellés.

  • Contrôle des versions :

    • Maintenez l'agent Ops à jour.
    • Épinglez la version de l'agent Ops sur une version spécifique.

  • Gestion de la configuration : appliquez une configuration personnalisée à l'agent Ops sur toutes les VM gérées par une règle.

VM Extension Manager vous permet de créer des règles qui déclarent les extensions que vous souhaitez installer sur les VM. L'agent Ops est l'une des extensions disponibles. Les règles VM Extension Manager peuvent gérer la version 2.58.0 ou ultérieure de l'agent Ops, lorsque celui-ci a été installé à l'aide de VM Extension Manager. Ces règles ne peuvent pas gérer les versions de l'agent Ops antérieures à la version 2.58.0, les instances de l'agent Ops installées par d'autres moyens, ni aucune version de l'ancien agent Monitoring ou agent Logging.

Vous pouvez créer et gérer des stratégies d'extension de VM zonales à l'aide de la consoleGoogle Cloud ou de la Google Cloud CLI, gcloud. Vous pouvez créer et gérer des règles d'extension de VM mondiales à l'aide de gcloud.

Avant de commencer

Avant de commencer à utiliser les règles de l'extension VM Extension Manager, procédez comme suit :

Consulter les systèmes d'exploitation compatibles

Avant d'essayer d'utiliser les règles VM Extension Manager pour gérer l'agent Ops, vérifiez que votre système d'exploitation cible est compatible avec l'agent Ops et VM Extension Manager.

VM Extension Manager est compatible avec tous les systèmes d'exploitation compatibles avec l'agent Ops, à l'exception de SUSE Linux Enterprise Server (SLES) et d'Ubuntu. Pour en savoir plus sur les systèmes d'exploitation compatibles avec l'agent Ops, consultez Systèmes d'exploitation.

Si votre système d'exploitation est compatible à la fois avec l'agent Ops et avec VM Extension Manager, suivez le reste de ce document.

Activer les API requises pour utiliser l'agent Ops

Pour utiliser l'agent Ops afin d'écrire des journaux et des métriques, vous devez activer les API Cloud Logging et API Cloud Monitoring sur votre projet Google Cloud .

Rôles requis pour activer les API

Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

Activer les API

Attribuer les rôles requis pour utiliser l'agent Ops

Pour obtenir les autorisations nécessaires pour utiliser l'agent Ops afin d'écrire des journaux et des métriques, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre compte de service :

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 en savoir plus sur les rôles et l'agent Ops, consultez Autoriser l'agent Ops.

Accorder les rôles requis pour utiliser VM Extension Manager

Pour obtenir les autorisations nécessaires pour créer, afficher, modifier et supprimer des règles d'extension de VM, demandez à votre administrateur de vous accorder les rôles IAM suivants 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.

Ces rôles prédéfinis contiennent les autorisations requises pour créer, afficher, modifier et supprimer des règles d'extension de VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour créer, afficher, modifier et supprimer des règles d'extension de VM :

  • Pour créer des règles d'extension : compute.vmExtensionPolicies.create
  • Pour afficher les règles des extensions : compute.vmExtensionPolicies.list
  • Pour afficher les détails d'une règle d'extension : compute.vmExtensionPolicies.get
  • Pour modifier les règles d'extension : compute.vmExtensionPolicies.update
  • Pour supprimer des règles d'extension : compute.vmExtensionPolicies.delete

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et autorisations IAM dans Compute Engine, consultez Rôles et autorisations Compute Engine.

Installer Google Cloud CLI

Vous pouvez créer et gérer des stratégies d'extension de VM à l'aide de la console Google Cloud ou de Google Cloud CLI, gcloud. Pour utiliser gcloud, vous devez d'abord installer la Google Cloud CLI.

Pour afficher les composants que vous avez installés, exécutez la commande suivante :

gcloud components list

Pour vérifier que vous disposez de la dernière version, exécutez la commande suivante :

gcloud components update

Désinstaller les agents d'observabilité

Avant de créer une règle VM Extension Manager pour gérer l'agent Ops sur une VM, assurez-vous qu'aucune instance de l'agent Ops ni des anciens agents Monitoring et Logging ne sont déjà présents sur la VM. L'exécution de l'agent Ops et des anciens agents sur la même VM peut entraîner l'ingestion de journaux en double ou créer des conflits dans l'ingestion des métriques.

Si vous utilisez une règle d'extension pour installer l'Agent Ops sur une VM sur laquelle un autre agent d'observabilité est déjà installé, la règle installe l'agent, mais celui-ci ne s'exécute pas, car un conflit est détecté.

La procédure à suivre pour supprimer des agents existants dépend de la façon dont ils ont été installés.

Installer l'agent Ops en créant des règles d'extension de VM

Créez des règles d'extension de VM pour installer et gérer automatiquement l'Agent Ops sur un parc de machines virtuelles (VM) Compute Engine. En définissant une règle, vous pouvez vous assurer que des extensions spécifiques, comme l'agent Ops, sont installées et gérées sur toutes les VM qui correspondent aux critères que vous spécifiez, comme les libellés de VM.

Conflits et priorités entre les règles

Le VM Extension Manager associe une priorité à chaque nouvelle règle. Plus le nombre est faible, plus la priorité est élevée. La priorité par défaut est de 1 000. Une VM peut être couverte par plusieurs règles pour une extension comme l'agent Ops, mais une seule règle pour l'extension de l'agent Ops est effective sur la VM.

VM Extension Manager utilise des priorités pour résoudre les conflits entre les règles appliquées à une VM. Pour en savoir plus sur la procédure de résolution, consultez Priorité des règles et résolution des conflits.

Plans de déploiement des règles pour les règles mondiales

Les règles globales VM Extension Manager utilisent un plan de déploiement pour déterminer comment une règle est distribuée aux VM cibles. Il existe deux types de plans de déploiement :

  • Plans de déploiement prédéfinis. Il existe deux plans de déploiement prédéfinis, choisis en fonction de la valeur utilisée avec l'option --rollout-predefined-plan pour les commandes gcloud CLI.

    • Déploiement lent, qui déploie l'agent Ops progressivement dans différentes zones sur une période donnée. Ce plan de déploiement est recommandé.

      Spécifiez ce plan de déploiement à l'aide de l'option --rollout-predefined-plan=slow_rollout.

    • Déploiement rapide, qui déploie l'agent Ops sur toutes les VM ciblées dans toutes les zones et régions immédiatement.

      Spécifiez ce plan de déploiement à l'aide de l'option --rollout-predefined-plan=fast_rollout.

  • Plans de déploiement personnalisés, spécifiés à l'aide de l'option --rollout-custom-plan pour les commandes gcloud CLI.

    Créez des plans de déploiement personnalisés en les ajoutant à l'ensemble des plans de déploiement de votre projet Google Cloud . Pour en savoir plus, consultez la méthode de l'API Compute Engine rolloutPlans.insert.

Pour en savoir plus sur les plans de déploiement, consultez Plans de déploiement pour les règles mondiales.

Installer la dernière version de l'agent Ops sur toutes les VM

Pour créer une règle qui installe la dernière version de l'agent Ops sur toutes les VM d'une zone ou de manière globale, et qui met à jour l'agent Ops lorsqu'une nouvelle version est publiée, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Cliquez sur + Créer.
  3. Dans le champ Nom, saisissez un nom pour la règle.
  4. Facultatif : Dans le champ Description, saisissez une description de la règle.
  5. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1 000.

  6. Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.

  7. Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :

    1. Dans la liste Extension, sélectionnez Google Cloud's Extension for Ops Agent.
    2. Laissez le champ Version vide.

  8. Cliquez sur Créer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Exécutez la commande gcloud compute zone-vm-extension-policies create suivante pour créer la stratégie :

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

L'option create de gcloud compute zone-vm-extension-policies accepte une option --version. Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée.

Monde

Exécutez la commande gcloud compute global-vm-extension-policies create suivante pour créer la règle :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

L'option create de gcloud compute global-vm-extension-policies accepte une option --version. Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée.

Bloquer l'agent Ops sur une version spécifique sur toutes les VM

Pour créer une règle qui installe une version spécifique de l'agent Ops sur toutes les VM d'une zone ou de manière globale, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Cliquez sur + Créer.
  3. Dans le champ Nom, saisissez un nom pour la règle.
  4. Facultatif : Dans le champ Description, saisissez une description de la règle.
  5. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1 000.

  6. Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.

  7. Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :

    1. Dans la liste Extension, sélectionnez Google Cloud's Extension for Ops Agent.
    2. Dans la liste Version, sélectionnez la version à installer. Utilisez la version 2.58.0 ou ultérieure.

  8. Cliquez sur Créer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Exécutez la commande gcloud compute zone-vm-extension-policies create suivante pour créer la règle :

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

  • VERSION : version de l'agent Ops à installer. Utilisez la version 2.58.0 ou ultérieure.

    Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée, comme indiqué dans l'exemple d'installation de la dernière version.

Monde

Exécutez la commande gcloud compute global-vm-extension-policies create suivante pour créer la règle :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • VERSION : version de l'agent Ops à installer. Utilisez la version 2.58.0 ou ultérieure.

    Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée, comme indiqué dans l'exemple d'installation de la dernière version.

Pour obtenir la liste des versions de l'agent Ops, consultez la page des versions de l'agent Ops sur GitHub.

Installer l'agent Ops sur des VM portant un libellé spécifique

Pour créer une règle qui installe la dernière version de l'agent Ops sur les VM d'une zone ou de manière globale qui possèdent une étiquette spécifique, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Cliquez sur + Créer.
  3. Dans le champ Nom, saisissez un nom pour la règle.
  4. Facultatif : Dans le champ Description, saisissez une description de la règle.
  5. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1 000.

  6. Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.

  7. Dans la section Extensions, cliquez sur Ajouter une extension, puis procédez comme suit :

    1. Dans la liste Extension, sélectionnez Google Cloud's Extension for Ops Agent.
    2. Laissez le champ Version vide.

  8. Dans la section Instances de VM cibles, sélectionnez les VM pour la règle. Pour sélectionner des VM avec des libellés spécifiques, cliquez sur Ajouter des libellés, puis ajoutez la paire clé-valeur.

  9. Cliquez sur Créer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Utilisez l'option --inclusion-labels de la commande gcloud compute zone-vm-extension-policies create pour spécifier une liste de paires clé/valeur séparées par une virgule :

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

  • KEY1=VALUE1,KEY2=VALUE2 : liste de paires clé/valeur séparées par une virgule qui définissent les libellés d'inclusion pour un sélecteur. Pour être incluses, les VM doivent comporter tous les libellés spécifiés dans un sélecteur (ET logique). Si vous spécifiez l'option --inclusion_labels plusieurs fois, la règle cible les VM qui correspondent à tous les libellés de l'un des sélecteurs (OR logique). Si vous omettez cette option, la règle cible toutes les VM de la zone spécifiée.

Monde

Utilisez l'option --inclusion-labels de la commande gcloud compute global-vm-extension-policies create pour spécifier une liste de paires clé/valeur séparées par une virgule :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • KEY1=VALUE1,KEY2=VALUE2 : liste de paires clé/valeur séparées par une virgule qui définissent les libellés d'inclusion pour un sélecteur. Pour être incluses, les VM doivent comporter tous les libellés spécifiés dans un sélecteur (ET logique). Si vous spécifiez l'option --inclusion_labels plusieurs fois, la règle cible les VM qui correspondent à tous les libellés de l'un des sélecteurs (OR logique). Si vous omettez cette option, la règle cible toutes les VM de la zone spécifiée.

Installer l'agent Ops avec une configuration personnalisée sur toutes les VM

Pour créer une règle qui installe la dernière version de l'Agent Ops sur toutes les VM d'une zone ou de manière globale, et qui fournit une configuration personnalisée pour l'Agent Ops, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Cliquez sur + Créer.
  3. Dans le champ Nom, saisissez un nom pour la règle.
  4. Facultatif : Dans le champ Description, saisissez une description de la règle.
  5. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1 000.

  6. Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.

  7. Dans la section Extensions, cliquez sur Ajouter une extension, puis procédez comme suit :

    1. Dans la liste Extension, sélectionnez Google Cloud's Extension for Ops Agent.
    2. Laissez le champ Version vide.
    3. Dans le champ Contenu du fichier de configuration, saisissez la chaîne de configuration YAML pour l'agent Ops.

  8. Cliquez sur Créer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Utilisez l'option --config-from-file de la commande gcloud compute zone-vm-extension-policies create pour spécifier un fichier de configuration :

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

  • OPS_AGENT_CONFIG_PATH : chemin d'accès à un fichier contenant la chaîne de configuration YAML pour l'agent Ops. Ce fichier doit exister dans l'environnement dans lequel vous exécutez la commande gcloud.

    La configuration YAML de l'agent Ops peut être longue. Il est beaucoup moins risqué de placer la configuration dans un fichier et de transmettre ce fichier à la gcloud CLI que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande. Si vous modifiez ce fichier après avoir créé la règle, celle-ci ne sera pas mise à jour. Pour mettre à jour une règle, utilisez la commande gcloud compute zone-vm-extension-policies update.

Monde

Utilisez l'option --config-from-file de la commande gcloud compute global-vm-extension-policies create pour spécifier un fichier de configuration :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • OPS_AGENT_CONFIG_PATH : chemin d'accès à un fichier contenant la chaîne de configuration YAML pour l'agent Ops. Ce fichier doit exister dans l'environnement dans lequel vous exécutez la commande gcloud.

    La configuration YAML de l'agent Ops peut être longue. Il est beaucoup moins risqué de placer la configuration dans un fichier et de transmettre ce fichier à la gcloud CLI que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande. Si vous modifiez ce fichier après avoir créé la règle, celle-ci ne sera pas mise à jour. Pour mettre à jour une règle, utilisez la commande gcloud compute global-vm-extension-policies update.

Si vous fournissez une configuration personnalisée pour l'agent Ops lorsque vous créez ou mettez à jour une règle d'extension, la règle déploie l'agent Ops avec la configuration personnalisée. Vous n'avez pas besoin de redémarrer l'agent manuellement.

La configuration est stockée avec la règle d'extension. N'incluez donc pas de données sensibles telles que des mots de passe dans la configuration. Étant donné que la configuration est stockée avec la règle d'extension, la modification du fichier de configuration ne modifie pas la configuration de l'agent. Vous devez mettre à jour la configuration stockée avec la règle à l'aide de la commande gcloud appropriée :

Lorsque vous fournissez une configuration personnalisée pour l'Agent Ops, VM Extension Manager copie la configuration à l'emplacement utilisé par l'Agent Ops pour les fichiers de configuration spécifiés par l'utilisateur sur la VM cible :

  • Linux : /etc/google-cloud-ops-agent/config.yaml
  • Windows : C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Si un fichier config.yaml est présent sur la VM, la règle d'extension l'écrase.

Pour obtenir des informations générales sur l'utilisation de la consoleGoogle Cloud et de gcloud CLI pour créer des règles d'extension de VM, consultez Installer des extensions de VM en créant des règles d'extension .

Installer l'agent Ops avec un plan de déploiement rapide à priorité élevée (global uniquement)

Pour créer une règle globale qui installe la dernière version de l'agent Ops en utilisant une priorité supérieure à celle par défaut et le plan de déploiement rapide, utilisez la commande gcloud compute global-vm-extension-policies create suivante :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

Installer l'agent Ops sur un sous-ensemble de zones dans un projet Google Cloud (global uniquement)

Pour créer une stratégie globale qui ne s'applique qu'à un sous-ensemble de zones dans un projetGoogle Cloud , vous devez utiliser un plan de déploiement personnalisé qui spécifie les zones dans lesquelles appliquer la stratégie. Pour savoir comment créer des plans de déploiement personnalisés, consultez À propos des plans de déploiement. Pour spécifier un ensemble de zones, utilisez le champ locationSelector.includedLocations lorsque vous créez le plan de déploiement.

Pour créer une règle d'extension qui utilise un plan de déploiement personnalisé, utilisez la commande gcloud compute global-vm-extension-policies create suivante :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • CUSTOM_PLAN_NAME : nom associé à votre plan de déploiement personnalisé.

Gérer l'agent Ops en mettant à jour les règles d'extension de VM

Pour modifier la façon dont une règle gère l'agent Ops, mettez à jour la règle. Lorsque vous mettez à jour une règle, VM Extension Manager déploie les modifications sur toutes les VM applicables, généralement en une minute. Si vous modifiez les libellés d'inclusion, l'agent Ops peut être installé sur de nouvelles VM ou désinstallé des VM existantes, selon que les VM correspondent aux libellés mis à jour.

Les sections suivantes expliquent comment gérer l'agent Ops pour effectuer les opérations suivantes :

Mettre à jour la version épinglée de l'agent Ops sur toutes les VM d'une zone

Pour modifier la version épinglée de l'Agent Ops sur toutes les VM d'une zone, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Sélectionnez le règlement que vous souhaitez modifier.
  3. Cliquez sur Modifier.
  4. Dans la section Gérer les extensions, procédez comme suit :
    1. Sélectionnez Google Cloud's Extension for Ops Agent.
    2. Modifiez le champ Version. Utilisez la version 2.58.0 ou ultérieure.
    3. Cliquez sur OK.
  5. Cliquez sur Enregistrer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Utilisez la commande gcloud compute zone-vm-extension-policies update avec l'option --version pour modifier la version de l'agent épinglée.

Lorsque vous mettez à jour une règle à l'aide de gcloud, la requête remplace complètement la règle existante. Tous les champs facultatifs que vous omettez reviennent à leur valeur par défaut au lieu de conserver les valeurs existantes de la règle modifiée.

Pour modifier la version de l'agent Ops installé sur toutes les VM d'une zone à l'aide d'une règle, utilisez la commande suivante :

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

  • VERSION : version de l'agent Ops à installer. Utilisez la version 2.58.0 ou ultérieure. Pour obtenir la liste des versions, consultez la page des versions de l'agent Ops sur GitHub.

    Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée, comme indiqué dans l'exemple d'installation de la dernière version.

Monde

Utilisez la commande gcloud compute global-vm-extension-policies update avec l'option --version pour modifier la version de l'agent épinglée.

Lorsque vous mettez à jour une règle à l'aide de gcloud, la requête remplace complètement la règle existante. Tous les champs facultatifs que vous omettez reviennent à leur valeur par défaut au lieu de conserver les valeurs existantes de la règle modifiée.

Pour modifier la version de l'agent Ops installé sur toutes les VM à l'aide d'une règle globale, utilisez la commande suivante :

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • VERSION : version de l'agent Ops à installer. Utilisez la version 2.58.0 ou ultérieure. Pour obtenir la liste des versions, consultez la page des versions de l'agent Ops sur GitHub.

    Si vous omettez l'option --version, la règle installe la dernière version et met à jour l'agent Ops lorsqu'une nouvelle version est publiée, comme indiqué dans l'exemple d'installation de la dernière version.

Modifier la configuration de l'Agent Ops sur toutes les VM

Pour modifier la configuration de l'agent Ops, procédez comme suit :

Console

Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Sélectionnez le règlement que vous souhaitez modifier.
  3. Cliquez sur Modifier.
  4. Dans la section Gérer les extensions, procédez comme suit :
    1. Sélectionnez Google Cloud's Extension for Ops Agent.
    2. Modifiez le champ Contenu du fichier de configuration.
    3. Cliquez sur OK.
  5. Cliquez sur Enregistrer.

gcloud

Pour créer une stratégie zonale ou globale, vous pouvez utiliser gcloud CLI.

Zonal

Utilisez gcloud compute zone-vm-extension-policies update avec l'option --config-from-file ou --config pour spécifier une nouvelle configuration.

Lorsque vous mettez à jour une règle à l'aide de gcloud, la requête remplace complètement la règle existante. Tous les champs facultatifs que vous omettez reviennent à leur valeur par défaut au lieu de conserver les valeurs existantes de la règle modifiée.

Pour modifier la configuration de l'agent Ops installé sur toutes les VM d'une zone à l'aide d'une règle, utilisez la commande suivante :

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

  • OPS_AGENT_CONFIG_PATH : chemin d'accès à un fichier contenant la chaîne de configuration YAML pour l'agent Ops. Ce fichier doit exister dans l'environnement dans lequel vous exécutez la commande gcloud.

    La configuration YAML de l'agent Ops peut être longue. Il est beaucoup moins risqué de placer la configuration dans un fichier et de transmettre ce fichier à la gcloud CLI que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande.

Monde

Utilisez gcloud compute global-vm-extension-policies update avec l'option --config-from-file ou --config pour spécifier une nouvelle configuration.

Lorsque vous mettez à jour une règle à l'aide de gcloud, la requête remplace complètement la règle existante. Tous les champs facultatifs que vous omettez reviennent à leur valeur par défaut au lieu de conserver les valeurs existantes de la règle modifiée.

Pour modifier la configuration de l'agent Ops installé sur toutes les VM à l'aide d'une règle, utilisez la commande suivante :

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • OPS_AGENT_CONFIG_PATH : chemin d'accès à un fichier contenant la chaîne de configuration YAML pour l'agent Ops. Ce fichier doit exister dans l'environnement dans lequel vous exécutez la commande gcloud.

    La configuration YAML de l'agent Ops peut être longue. Il est beaucoup moins risqué de placer la configuration dans un fichier et de transmettre ce fichier à la gcloud CLI que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande.

Si vous fournissez une configuration personnalisée pour l'agent Ops lorsque vous créez ou mettez à jour une règle d'extension, la règle déploie l'agent Ops avec la configuration personnalisée. Vous n'avez pas besoin de redémarrer l'agent manuellement.

La configuration est stockée avec la règle d'extension. N'incluez donc pas de données sensibles telles que des mots de passe dans la configuration. Étant donné que la configuration est stockée avec la règle d'extension, la modification du fichier de configuration ne modifie pas la configuration de l'agent. Vous devez mettre à jour la configuration stockée avec la règle à l'aide de la commande gcloud appropriée :

Lorsque vous fournissez une configuration personnalisée pour l'Agent Ops, VM Extension Manager copie la configuration à l'emplacement utilisé par l'Agent Ops pour les fichiers de configuration spécifiés par l'utilisateur sur la VM cible :

  • Linux : /etc/google-cloud-ops-agent/config.yaml
  • Windows : C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Si un fichier config.yaml est présent sur la VM, la règle d'extension l'écrase.

Pour obtenir des informations générales sur l'utilisation de la consoleGoogle Cloud et de la gcloud CLI pour gérer les règles d'extension de VM, consultez Modifier les extensions en mettant à jour une règle d'extension de VM.

Étendre une règle globale existante pour inclure de nouvelles zones (global uniquement)

Lorsque des VM sont créées dans de nouvelles zones après la création et le déploiement d'une règle globale, VM Extension Manager n'applique pas automatiquement la règle aux VM des nouvelles zones. Pour inclure les VM dans de nouvelles zones, vous devez redémarrer le déploiement de la stratégie globale.

Pour redémarrer le déploiement d'une règle globale, utilisez la commande gcloud compute global-vm-extension-policies update et fournissez l'option --rollout-retry-uuid=UUID.

Par exemple, supposons que vous ayez créé et déployé une stratégie globale à l'aide de la commande suivante :

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Pour étendre la règle aux VM créées dans des zones précédemment inutilisées, redémarrez le déploiement à l'aide de la commande suivante :

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • UUID : identifiant unique universel (UUID) qui identifie la demande de nouvelle tentative. Vous pouvez utiliser n'importe quel générateur d'UUID pour en créer un. Pour en savoir plus, consultez Réessayer un déploiement .

Mettre à jour une règle globale pour exclure un ensemble de zones (global uniquement)

Pour mettre à jour les zones auxquelles s'applique une règle globale qui exclut certaines zones d'un projetGoogle Cloud , vous devez utiliser un nouveau plan de déploiement personnalisé qui spécifie les zones dans lesquelles appliquer la règle. Pour savoir comment créer des plans de déploiement personnalisés, consultez À propos des plans de déploiement. Pour spécifier un ensemble de zones, utilisez le champ locationSelector.includedLocations lorsque vous créez le plan de déploiement.

Pour mettre à jour une règle d'extension qui utilise un plan de déploiement personnalisé, utilisez la commande gcloud compute global-vm-extension-policies update suivante :

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • NEW_CUSTOM_PLAN_NAME : nom associé à votre plan de déploiement personnalisé mis à jour.
  • UUID : identifiant unique universel (UUID) qui identifie la demande de nouvelle tentative. Vous pouvez utiliser n'importe quel générateur d'UUID pour en créer un. Pour en savoir plus, consultez Réessayer un déploiement .

Désinstaller l'Agent Ops en supprimant les règles d'extension de VM

Pour désinstaller l'Agent Ops, supprimez la règle d'extension de VM qui le gère. Si une autre règle active de priorité inférieure s'applique à une VM et gère également l'Agent Ops, l'agent reste installé sur cette VM en fonction de la règle de priorité inférieure.

VM Extension Manager supprime l'agent Ops de toutes les VM accessibles dans la minute qui suit la suppression de la règle. Si une VM est inaccessible, VM Extension Manager ignore la suppression de l'agent. Si la VM redevient disponible, VM Extension Manager supprime l'agent à ce moment-là.

Console

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Sélectionnez la règle que vous souhaitez supprimer.
  3. Cliquez sur Supprimer.
  4. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.

gcloud

Zonal

Pour supprimer la règle d'extension de VM qui gère l'Agent Ops, utilisez la commande gcloud compute zone-vm-extension-policies delete :

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

Monde

Pour supprimer la stratégie d'extension de VM globale qui gère l'Agent Ops, utilisez la commande gcloud compute global-vm-extension-policies delete :

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

Pour accélérer un déploiement de suppression déjà lancé, exécutez une nouvelle commande de suppression qui utilise le plan fast_rollout. Vous devez également spécifier l'option --rollout-retry-uuid=UUID :

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

  • UUID : identifiant unique universel (UUID) qui identifie la demande de nouvelle tentative. Vous pouvez utiliser n'importe quel générateur d'UUID pour en créer un. Pour en savoir plus, consultez Réessayer un déploiement .

Récupérer des informations sur les règles d'extension de VM

Vous pouvez récupérer les informations suivantes sur les règles d'extension de VM existantes :

  • Liste de toutes les règles de votre projet Google Cloud .
  • Informations de configuration sur une règle spécifique.

Console

  1. Dans la console Google Cloud , accédez à la page Règles relatives aux extensions :

    Accéder aux Règles des extensions

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

    Cette page répertorie toutes les règles d'extension de VM de votre projet.
  2. Pour afficher les détails d'une règle d'extension spécifique, cliquez sur son nom.

gcloud

Zonal

Lister les règles d'extension de VM

Pour lister les informations sur toutes les règles d'extension de VM d'une zone, utilisez gcloud compute zone-vm-extension-policies list :

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Remplacez les variables suivantes dans la commande :

  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).
  • PAGE_SIZE_INTEGER : nombre de règles à répertorier par page (par exemple, 2). Pour en savoir plus sur les options de tri et de filtrage, consultez gcloud compute zone-vm-extension-policies list.

Décrire une règle d'extension de VM nommée

Pour récupérer la configuration d'une règle nommée dans une zone, utilisez gcloud compute zone-vm-extension-policies describe :

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.
  • ZONE : zone cible (par exemple, us-central1-f).

Monde

Lister les règles d'extension de VM mondiales

Pour lister les informations sur les règles d'extension de VM globales, utilisez gcloud compute global-vm-extension-policies list :

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Remplacez les variables suivantes dans la commande :

Décrire une règle d'extension de VM globale nommée

Pour récupérer la configuration d'une règle nommée dans une zone, utilisez gcloud compute global-vm-extension-policies describe :

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Remplacez les variables suivantes dans la commande :

  • POLICY_NAME : nom de la règle d'extension de VM.
  • PROJECT_ID : identifiant du projet.

Pour obtenir des informations générales sur l'utilisation de la consoleGoogle Cloud et de gcloud CLI pour récupérer des informations sur les règles d'extension de VM, consultez Afficher les règles d'extension.

Vérifier l'installation de l'agent Ops

Cette page explique comment effectuer les opérations suivantes :

Vérifier l'état ou la version d'une installation de l'agent Ops

Pour déterminer l'état ou la version de l'agent Ops, utilisez l'une des pages de la consoleGoogle Cloud suivantes :

Compute Engine

  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

  2. Sélectionnez une VM dans la liste.
  3. Cliquez sur l'onglet Observabilité.

Cloud Monitoring

  1. Dans la console Google Cloud , accédez à la page Instances de VM :

    Accéder à la page Instances de VM

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Sélectionnez la vue Liste.

Une fois l'agent Ops installé sur la VM et qu'il collecte des journaux et des métriques, son état est indiqué par une coche verte à côté du libellé Agent Ops.

Pour déterminer la version de l'agent installé, pointez sur le libellé Agent Ops dans le tableau de bord Compute Engine ou Monitoring.

Vérifier que l'agent Ops collecte la télémétrie

Si l'agent Ops a été installé et s'exécute correctement, il envoie des métriques à Cloud Monitoring et des journaux à Cloud Logging.

Redémarrer un agent Ops installé par une règle d'extension

Lorsque l'agent Ops est installé et géré par VM Extension Manager, il n'est pas géré par le service de gestion du système d'exploitation, c'est-à-dire systemd sur Linux ou le Gestionnaire de services Windows sur Windows. Par conséquent, les commandes Linux systemctl et Windows *-Service ne fonctionnent pas avec un agent Ops installé par une stratégie d'extension.

Pour redémarrer un agent Ops installé par une règle d'extension, procédez de l'une des manières suivantes :

  • Recréez la règle.

    1. Supprimez la règle. Si vous supprimez la règle, l'Agent Ops est arrêté et désinstallé.

    2. Créez une règle. La nouvelle règle installe l'agent Ops et le démarre.

  • Utilisez une règle temporaire de priorité plus élevée. Si la règle d'origine affecte un grand nombre de VM, mais que vous ne souhaitez redémarrer l'agent Ops que sur un petit nombre d'entre elles, ajoutez un libellé à ces VM et configurez la nouvelle règle pour filtrer sur ce libellé.

    Par exemple, si une règle de priorité 1000 n'a pas réussi à démarrer l'Agent Ops sur une VM, vous pouvez ajouter un libellé tel que status=failed à la VM. Ensuite, créez une stratégie avec une priorité plus élevée, comme 500. Par exemple, une commande Google Cloud CLI peut ressembler à ce qui suit :

    Zonal 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Remplacez les variables suivantes dans la commande :

    • POLICY_NAME : nom de la règle d'extension de VM.
    • PROJECT_ID : identifiant du projet.
    • ZONE : zone cible (par exemple, us-central1-f).

    Monde 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Remplacez les variables suivantes dans la commande :

    • POLICY_NAME : nom de la règle d'extension de VM.
    • PROJECT_ID : identifiant du projet.

    Une fois que la nouvelle règle a installé l'agent Ops, supprimez la règle et retirez le libellé des VM. L'Agent Ops reste installé sur la VM, car la règle d'origine est toujours active.

Activer le journal de débogage de l'agent invité sur la VM

Les règles VM Extension Manager utilisent l'agent invité Compute Engine pour gérer l'agent Ops en tant qu'extension de VM. Pour savoir comment activer la journalisation de débogage pour l'agent invité, consultez Afficher les journaux de débogage pour l'agent invité.

Résoudre les problèmes liés aux règles d'extension

Cette section fournit des informations sur la résolution des problèmes liés à l'utilisation des règles d'extension pour gérer l'agent Ops :

Pour savoir comment résoudre les problèmes liés à l'agent Ops, consultez Résoudre les problèmes liés à l'agent Ops.

Échec des commandes gcloud compute zone-vm-extension-policies

Lorsqu'une commande gcloud compute zone-vm-extension-policies échoue, la réponse inclut des suggestions de dépannage. Corrigez les erreurs dans les options ou les arguments de commande suggérés par le message d'erreur.

Si le résultat de la commande mentionne des autorisations IAM insuffisantes, consultez les rôles et autorisations nécessaires décrits dans Accorder les rôles requis pour utiliser VM Extension Manager.

La règle d'extension est créée, mais l'état de l'agent Ops est "non détecté"

Vous avez créé une règle d'extension, mais l'agent Ops affiche l'état "Non détecté" sur la VM.

L'Agent Ops peut s'afficher comme "non détecté" dans les cas suivants :

  • La règle d'extension ne parvient pas à installer l'agent Ops.
  • Un agent Ops installé rencontre une condition d'erreur qui l'empêche de s'exécuter.

Les sections suivantes expliquent comment diagnostiquer ces cas.

Vérifier que l'agent Ops a été installé par la règle

Les règles VM Extension Manager utilisent l'agent invité Compute Engine pour gérer l'agent Ops en tant qu'extension de VM.

Pour déterminer si l'agent Ops a été installé par la règle d'extension, utilisez l'une des méthodes suivantes pour rechercher les entrées de journal de l'agent invité :

Explorateur de journaux

  1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez la requête suivante, puis cliquez sur Exécuter la requête :

    log_id("GCEGuestAgentManager")

Linux

Exécutez la commande suivante sur la VM Compute Engine :

journalctl -u google-guest-agent-manager

Windows

Exécutez la commande suivante sur la VM Compute Engine :

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Si vous voyez des journaux contenant une chaîne telle que Failed to install plugin "ops-agent-plugin" ... ou si la requête ne renvoie aucun journal, cela signifie que la règle d'extension n'a pas réussi à installer l'agent Ops. Pour connaître les étapes suivantes, consultez Échec de l'installation de l'agent Ops par la règle d'extension.

Si vous voyez des journaux contenant une chaîne telle que Successfully installed plugin "ops-agent_nnnnnnnn", cela signifie que la stratégie d'extension a bien installé l'agent Ops. Pour connaître les étapes suivantes, consultez L'agent Ops installé n'est pas détecté.

Échec de l'installation de l'agent Ops par la règle d'extension

Une politique de prolongation pourrait s'avérer inefficace si l'une des conditions suivantes est remplie :

L'agent Ops installé a le statut « non détecté ».

L'état de l'Agent Ops peut être "Non détecté" si l'une des conditions suivantes est remplie :

Vérifiez que la configuration de l'agent Ops est valide.

Vous avez fourni une configuration personnalisée à l'agent Ops en créant ou en mettant à jour une règle d'extension, mais l'état de l'agent est "non détecté". Il peut s'agir d'une erreur dans votre configuration personnalisée. Utilisez les journaux de débogage de l'agent invité pour rechercher les erreurs de configuration.

Activer la journalisation des données de débogage de l'agent invité

Pour savoir comment activer la journalisation de débogage pour l'agent invité, consultez Afficher les journaux de débogage pour l'agent invité.

Examiner les journaux de débogage

Explorateur de journaux

  1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez la requête suivante, puis cliquez sur Exécuter la requête :

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Exécutez la commande suivante sur la VM Linux Compute Engine :

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Exécutez la commande suivante sur la VM Windows Compute Engine :

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Si vous voyez des journaux contenant la chaîne The agent config file is not valid, cela signifie que la configuration personnalisée de l'agent Ops que vous avez fournie lors de la création ou de la mise à jour de la règle d'extension n'est pas valide.

Pour résoudre ce problème, procédez comme suit :

  • Corrigez la configuration en vous reportant à Configurer l'agent Ops. Pour en savoir plus sur la structure d'un fichier de configuration de l'agent Ops.

  • Mettez à jour la règle d'extension avec la configuration corrigée.

Les commandes Linux systemctl status et Windows Get-Service ne fonctionnent pas avec l'agent Ops

Vous exécutez une commande telle que sudo systemctl status google-cloud-ops-agent"*", mais elle ne renvoie aucune information.

Lorsque l'agent Ops est installé et géré par VM Extension Manager, il n'est pas géré par le service de gestion du système d'exploitation, c'est-à-dire systemd sur Linux ou le Gestionnaire de services Windows sur Windows.

Pour trouver les informations sur l'état d'un agent Ops géré par VM Extension Manager, consultez les éléments suivants :

Les commandes Linux systemctl restart et Windows Restart-Service ne fonctionnent pas avec l'agent Ops

Vous exécutez une commande telle que sudo systemctl restart google-cloud-ops-agent, mais l'agent Ops n'est pas redémarré.

Lorsque l'agent Ops est installé et géré par VM Extension Manager, il n'est pas géré par le service de gestion du système d'exploitation, c'est-à-dire systemd sur Linux ou le Gestionnaire de services Windows sur Windows. Par conséquent, vous ne pouvez pas arrêter ni démarrer l'agent Ops manuellement, et les commandes telles que les suivantes ne fonctionnent pas avec l'agent Ops :

  • Linux : sudo systemctl [stop|start|restart]
  • Windows : Stop-Service, Start-Service, Restart-Service

Pour arrêter ou redémarrer un agent Ops géré par VM Extension Manager, vous devez désinstaller l'agent en supprimant la règle d'extension. Pour en savoir plus sur l'arrêt ou le redémarrage de l'agent Ops, consultez Redémarrer un agent Ops installé par une règle d'extension.

Informations de dépannage supplémentaires

Pour en savoir plus sur le dépannage de la création et de l'utilisation des règles du VM Extension Manager, consultez Dépanner les extensions de VM.

Pour en savoir plus sur le dépannage de l'agent Ops, consultez Résoudre les problèmes liés à l'agent Ops.

Quota

Pour en savoir plus sur le nombre de règles d'extension que vous pouvez créer dans un projet Google Cloud , consultez Quota.

Tarifs

Pour en savoir plus sur les coûts associés à l'utilisation de VM Extension Manager, consultez la page Tarifs.

Si vous installez l'agent Ops, les métriques, les journaux ou les traces envoyés par l'agent à votre projet Google Cloud peuvent vous être facturés. Pour en savoir plus sur les tarifs, consultez la page Tarifs de Google Cloud Observability.

Étapes suivantes