Les règles de VM Extension Manager vous permettent d'installer l'agent Ops sur un parc de VM Compute Engine. Une règle d'extension peut installer l'agent Ops de manière globale dans votre projet Google Cloud ou dans une zone spécifique, maintenir la version de l'agent à jour et appliquer une configuration personnalisée à l'agent.
Avant de commencer
Avant de créer des règles d'extension VM Extension Manager pour gérer l'agent Ops, procédez comme suit :
Consultez les informations générales sur VM Extension Manager.
Consultez les systèmes d'exploitation compatibles pour vérifier que l'agent Ops et VM Extension Manager sont compatibles avec vos systèmes d'exploitation.
Supprimez tous les agents d'observabilité déjà installés sur vos VM.
Activez les API utilisées par l'agent Ops et par VM Extension Manager.
Attribuez les rôles requis pour utiliser le VM Extension Manager.
Si vous souhaitez utiliser une interface de ligne de commande pour créer et gérer des règles d'extension, installez la Google Cloud CLI.
Vous pouvez créer et gérer des règles d'extension de VM zonales à l'aide de la consoleGoogle Cloud ou de Google Cloud CLI, gcloud. Vous créez et gérez des règles d'extension de VM globales à l'aide de gcloud.
Supprimer les agents d'observabilité existants
Avant de créer une règle VM Extension Manager pour l'agent Ops, assurez-vous qu'aucune instance de l'agent Ops ou de l'ancien agent Monitoring et de l'agent Logging n'est déjà présente 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 où 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 de suppression des agents existants dépend de la façon dont ils ont été installés.
Agents installés par une règle OS Config de VM Manager, qui inclut les éléments suivants :
- Agent Ops installé à l'aide de la consoleGoogle Cloud lors de la création de la VM.
- Agent Ops installé par une règle OS Config de VM Manager en DG.
- Agent Ops, ou ancien agent Monitoring ou Logging installé par une règle OS Config VM Manager bêta.
Pour savoir comment identifier les VM utilisant ces règles, consultez Rechercher les VM soumises aux règles d'OS de l'Agent Ops.
Pour savoir comment désinstaller l'agent et supprimer les règles OS Config, consultez Désinstaller l'agent Ops sur les VM couvertes par les règles d'OS de l'agent Ops.
Agents installés manuellement à l'aide d'un script d'installation. Pour en savoir plus sur la désinstallation des agents, consultez les pages suivantes :
- Agent Ops : désinstallez l'agent.
- Ancien agent Monitoring : désinstallez l'agent.
- Ancien agent Logging : désinstallez l'agent.
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 l'API Cloud Logging et l'API Cloud Monitoring dans votre projet Google Cloud .
Rôles requis pour activer les API
Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.
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 écrire des journaux : Rédacteur de journaux Logging (
roles/logging.logWriter) -
To write metrics:
Monitoring Metric Writer (
roles/monitoring.metricWriter)
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.
Activer l'API utilisée par VM Extension Manager
VM Extension Manager utilise l'API Compute Engine. Activez cette API dans votre projet Google Cloud si ce n'est pas déjà fait.
Attribuer les rôles requis pour utiliser VM Extension Manager
Pour obtenir les autorisations nécessaires pour créer des règles d'extension de VM, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
-
Pour créer des règles d'extension : Administrateur de règles d'extension de VM (
roles/compute.vmExtensionPolicyAdmin)
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 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 des règles d'extension de VM :
-
Pour créer des règles d'extension :
compute.vmExtensionPolicies.create
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 les autorisations IAM dans Compute Engine, consultez Rôles et autorisations Compute Engine.
Installer Google Cloud CLI
Vous pouvez créer et gérer des règles d'extension de VM à l'aide de la console Google Cloud ou de la 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
Conflits et priorités des règles
VM Extension Manager associe une priorité à chaque nouvelle stratégie, les nombres les plus bas indiquant les priorités les plus élevées. La priorité par défaut est 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 le processus de résolution, consultez Priorité des règles et résolution des conflits.
Plans de déploiement des règles globales
Les règles globales de 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 par la valeur utilisée avec l'option
--rollout-predefined-planpour 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 immédiatement l'agent Ops sur toutes les VM ciblées dans l'ensemble des zones et des régions.
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-planpour 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 stratégies globales.
Créer des règles d'extension de VM pour installer l'agent Ops
Avec VM Extension Manager, vous créez des règles qui déclarent les extensions que vous souhaitez installer sur les VM. L'agent Ops est l'une des extensions disponibles. En définissant une règle, vous pouvez vous assurer que les extensions compatibles, y compris l'agent Ops, sont installées et gérées sur toutes les VM qui correspondent aux critères que vous spécifiez, tels que les étiquettes de VM.
Vous pouvez utiliser des règles d'extension pour l'agent Ops afin d'effectuer des tâches telles que les suivantes :
Installation à l'échelle du parc : installez l'agent Ops sur les éléments suivants :
- Toutes les VM d'une ou de plusieurs zones de votre projet Google Cloud .
- Toutes les VM de manière globale (dans votre projet Google Cloud ).
- Un sous-ensemble de VM d'une zone, identifié par des étiquettes.
- Un sous-ensemble de VM dans les zones de votre projet Google Cloud , identifiées par des étiquettes.
Contrôle des versions :
- Maintenez l'Agent Ops à jour avec la dernière version.
- Épinglez la version de l'agent Ops à 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.
Les sections suivantes fournissent des exemples de règles qui installent l'agent Ops selon des critères spécifiques.
VM Extension Manager est compatible avec l'agent Ops version 2.58.0 ou ultérieure, lorsque l'agent Ops a été installé par une règle d'extension. VM Extension Manager ne peut pas gérer les versions antérieures de l'agent Ops, les instances de l'agent Ops installées par d'autres moyens, ni l'ancien agent Monitoring ou l'ancien agent Logging.
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 .
-
Dans la console Google Cloud , accédez à la page Règles d'extension :
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.
- Cliquez sur + Créer.
- Dans le champ Nom, saisissez un nom pour la stratégie.
- Facultatif : Dans le champ Description, saisissez une description de la stratégie.
- Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus la valeur est faible, plus la priorité est élevée. La valeur par défaut est 1 000.
- Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.
- Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :
- Dans la liste Extension, sélectionnez
Google Cloud's Extension for Ops Agent. - Laissez le champ Version vide.
- Dans la liste Extension, sélectionnez
- Cliquez sur Créer.
gcloud
Pour créer une stratégie zonale ou globale, vous pouvez utiliser la 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.
La commande gcloud compute zone-vm-extension-policies create 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 stratégie :
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.
La commande gcloud compute global-vm-extension-policies create 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.
Épingler l'Agent Ops à 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 .
-
Dans la console Google Cloud , accédez à la page Règles d'extension :
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.
- Cliquez sur + Créer.
- Dans le champ Nom, saisissez un nom pour la stratégie.
- Facultatif : Dans le champ Description, saisissez une description de la stratégie.
- Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus la valeur est faible, plus la priorité est élevée. La valeur par défaut est 1 000.
- Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.
- Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :
- Dans la liste Extension, sélectionnez
Google Cloud's Extension for Ops Agent. - Dans la liste Version, sélectionnez la version à installer. Utilisez la version 2.58.0 ou une version ultérieure.
- Dans la liste Extension, sélectionnez
- Cliquez sur Créer.
gcloud
Pour créer une stratégie zonale ou globale, vous pouvez utiliser la 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 \
--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 une version 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 illustré dans l'exemple qui installe la dernière version.
Monde
Exécutez la commande gcloud compute global-vm-extension-policies create suivante pour créer la stratégie :
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 une version 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 illustré dans l'exemple qui installe 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 les VM dotées d'une étiquette 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, et qui ont un libellé spécifique, procédez comme suit :
Console
Pour créer une règle zonale, vous pouvez utiliser la console Google Cloud .
-
Dans la console Google Cloud , accédez à la page Règles d'extension :
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.
- Cliquez sur + Créer.
- Dans le champ Nom, saisissez un nom pour la stratégie.
- Facultatif : Dans le champ Description, saisissez une description de la stratégie.
- Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus la valeur est faible, plus la priorité est élevée. La valeur par défaut est 1 000.
- Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.
- Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :
- Dans la liste Extension, sélectionnez
Google Cloud's Extension for Ops Agent. - Laissez le champ Version vide.
- Dans la liste Extension, sélectionnez
- Dans la section Instances de VM cibles, sélectionnez les VM pour la règle. Pour sélectionner des VM avec des étiquettes spécifiques, cliquez sur Ajouter des étiquettes et ajoutez la paire clé-valeur.
- Cliquez sur Créer.
gcloud
Pour créer une stratégie zonale ou globale, vous pouvez utiliser la 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 étiquettes d'inclusion d'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_labelsplusieurs fois, la règle cible les VM qui correspondent à toutes les étiquettes de l'un des sélecteurs (opérateur logique OU). 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 étiquettes d'inclusion d'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_labelsplusieurs fois, la règle cible les VM qui correspondent à toutes les étiquettes de l'un des sélecteurs (opérateur logique OU). 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 .
-
Dans la console Google Cloud , accédez à la page Règles d'extension :
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.
- Cliquez sur + Créer.
- Dans le champ Nom, saisissez un nom pour la stratégie.
- Facultatif : Dans le champ Description, saisissez une description de la stratégie.
- Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus la valeur est faible, plus la priorité est élevée. La valeur par défaut est 1 000.
- Dans la liste Zone, sélectionnez la zone dans laquelle vous souhaitez appliquer cette règle.
- Dans la section Gérer les extensions, cliquez sur Ajouter une extension, puis procédez comme suit :
- Dans la liste Extension, sélectionnez
Google Cloud's Extension for Ops Agent. - Laissez le champ Version vide.
- Dans le champ Contenu du fichier de configuration, saisissez la chaîne de configuration YAML de l'agent Ops.
- Dans la liste Extension, sélectionnez
- Cliquez sur Créer.
gcloud
Pour créer une stratégie zonale ou globale, vous pouvez utiliser la 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 de l'agent Ops. Ce fichier doit exister dans l'environnement où vous exécutez la commande gcloud.
La configuration YAML de l'agent Ops peut être longue. Placer la configuration dans un fichier et transmettre ce fichier à la gcloud CLI est beaucoup moins sujet aux erreurs que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande. La modification de ce fichier après la création de la règle ne met pas à jour la règle. Pour mettre à jour une règle, utilisez la commande
gcloud compute zone-vm-extension-policiesupdate.
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 de l'agent Ops. Ce fichier doit exister dans l'environnement où vous exécutez la commande gcloud.
La configuration YAML de l'agent Ops peut être longue. Placer la configuration dans un fichier et transmettre ce fichier à la gcloud CLI est beaucoup moins sujet aux erreurs que d'essayer de saisir du code YAML correctement formaté sur la ligne de commande. La modification de ce fichier après la création de la règle ne met pas à jour la règle. Pour mettre à jour une règle, utilisez la commande
gcloud compute global-vm-extension-policiesupdate.
Si vous fournissez une configuration personnalisée pour l'agent Ops lors de la création ou de la mise à jour d'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 manuellement l'agent.
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 stratégie à l'aide de la commande gcloud appropriée :
- Pour les règles zonales, utilisez la commande
gcloud compute zone-vm-extension-policiesupdate. - Pour les stratégies globales, utilisez la commande
gcloud compute global-vm-extension-policiesupdate.
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 en savoir plus sur l'utilisation de la consoleGoogle Cloud et de la gcloud CLI pour créer des règles d'extension de VM, consultez Installer des extensions de VM à l'aide de règles d'extension .
Installer l'agent Ops avec un plan de déploiement rapide à priorité plus é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 à la valeur 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 règle globale qui ne s'applique qu'à un sous-ensemble de zones d'un projetGoogle Cloud , vous devez utiliser un plan de déploiement personnalisé qui spécifie les zones dans lesquelles appliquer la règle. Pour en savoir plus sur la création de 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 lors de la création du plan de déploiement.
Pour créer une règle d'extension qui utilise un plan de déploiement personnalisé, exécutez 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é.
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
- Vérifier que l'agent Ops collecte des données de télémétrie
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
-
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.
- Sélectionnez une VM dans la liste.
- Cliquez sur l'onglet Observabilité.
Cloud Monitoring
-
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.
- Sélectionnez la vue Liste.
Une fois l'agent Ops installé sur la VM et qu'il collecte les journaux et les métriques, l'état de l'agent 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 sur le tableau de bord Compute Engine ou Monitoring.
Vérifier que l'agent Ops collecte des données de télémétrie
Si l'agent Ops a bien été installé et fonctionne correctement, il envoie des métriques à Cloud Monitoring et des journaux à Cloud Logging.
- Pour en savoir plus sur la vérification de la collecte des métriques, consultez L'agent est en cours d'exécution, mais les données ne sont pas ingérées.
- Pour en savoir plus sur la vérification de la collecte des journaux, consultez Vérifier la réussite de la collecte de journaux.
Étapes suivantes
- Modifiez l'installation en mettant à jour vos règles d'extension.
- Résoudre les problèmes liés aux règles d'extension
- En savoir plus sur VM Extension Manager
- Consultez des informations détaillées sur la configuration de l'agent Ops.