Installare l'Ops Agent durante la creazione della VM
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento descrive come la console Google Cloud può installare automaticamente Ops Agent per te quando crei un'istanza VM. Durante il processo di installazione, VM Manager di Compute Engine crea una policy del sistema operativo Ops Agent che installa l'agente e lo reinstalla quando necessario. VM Manager ti aiuta a eseguire Ops Agent sulla tua VM e garantisce che l'agente sia sempre installato.
Panoramica
VM Manager utilizza i criteri del sistema operativo per gestire l'installazione di Ops Agent. Un criterio di configurazione viene applicato a una VM utilizzando una mappatura
chiamata ID assegnazione, simile al seguente esempio:
goog-ops-agent-v2-x86-template-1-0-0-ZONE
Un ID assegnazione per una policy del sistema operativo di Ops Agent è costituito dai seguenti
componenti:
Il nome della norma: "goog-ops-agent"
Un modello per la creazione del criterio: "v2-x86-template"
Una stringa di versione per il modello. La versione, che potrebbe cambiare nel tempo,
è un valore come "1-0-0".
La zona a cui si applica l'ID assegnazione, un valore come "us-central1-a".
A una VM è associato un ID assegnazione utilizzando le etichette sull'istanza VM.
Una VM Compute Engine è una risorsa monitorata di tipo
gce_instance
e include un'etichetta zone. Quando utilizzi la console Google Cloud per
creare una VM con Ops Agent installato, VM Manager aggiunge un'altra
etichetta alla VM, che ha l'aspetto di goog-ops-agent-policy:v2-x86-template-1-0-0. Questa etichetta identifica le
norme, il modello e la versione:
Chiave etichetta, l'identificatore del criterio: goog-ops-agent-policy
Valore etichetta, modello di norma e versione: v2-x86-template-1-0-0
Quando crei una VM nella console Google Cloud , puoi selezionare la casella di controllo
Installa Ops Agent per il monitoraggio e il logging. Quando fai clic su
Crea, VM Manager assegna alla VM l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0 e
installa Ops Agent. Se la VM è la prima nella sua zona, VM Manager crea anche una policy del sistema operativo Ops Agent e un'assegnazione della policy del sistema operativo Ops Agent per quella zona.
Mentre una zona ha un'assegnazione di policy del sistema operativo Ops Agent, la policy del sistema operativo Ops Agent
monitora le VM con le seguenti caratteristiche:
La VM ha l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0.
La VM si trova nella stessa zona dell'assegnazione della policy del sistema operativo di Ops Agent.
Il criterio del sistema operativo Ops Agent verifica ogni ora se le VM coperte hanno installato Ops Agent. Se Ops Agent non è
installato, la policy del sistema operativo di Ops Agent installa l'ultima versione
dell'agente.
Crea una VM con l'installazione automatica di Ops Agent
Per installare Ops Agent automaticamente durante la creazione della VM e applicare l'assegnazione delle policy del sistema operativo di Ops Agent alla VM, segui questi passaggi:
Grant roles to your user account. Run the following command once for each of the following
IAM roles:
roles/osconfig.osPolicyAssignmentEditor
USER_IDENTIFIER: the identifier for your user
account—for example, myemail@example.com.
ROLE: the IAM role that you grant to your user account.
Segui i passaggi descritti in
Crea un'istanza VM da un'immagine pubblica.
Prima di fare clic su Crea, seleziona la casella di controllo
Installa Ops Agent per il monitoraggio e il logging:
Fai clic su Crea.
Quando installi automaticamente Ops Agent per la prima volta in una zona, se non hai abilitato VM Manager per il tuo progetto Google Cloud , la procedura di creazione della VM esegue le seguenti operazioni:
Crea la policy del sistema operativo Ops Agent e un'assegnazione della policy del sistema operativo Ops Agent
per la zona. Il criterio del sistema operativo di Ops Agent è un campo dell'assegnazione
dei criteri.
Attiva la gestione di patch, policy del sistema operativo e inventario del sistema operativo impostando l'etichetta dei metadati della VM enable-osconfig su TRUE.
Crea la VM e le assegna l'etichetta della policy del sistema operativo Ops Agent.
Se crei una VM e installi automaticamente Ops Agent in una zona
in cui esiste già un'assegnazione delle policy del sistema operativo Ops Agent, il processo di creazione della VM crea la VM e le assegna l'etichetta della policy del sistema operativo Ops Agent.
Esempio
Il tuo Google Cloud progetto non ha assegnazioni di policy del sistema operativo dell'agente Ops. Crea due VM, instance-1 e instance-2 nella zona
us-central1-a. Poi crei instance-3 e instance-4 nella zona us-east1-b. Le caselle di controllo instance-1, instance-2 e instance-3 sono state selezionate durante la creazione.
Quando crei instance-1, VM Manager crea una policy del sistema operativo Ops Agent
per la zona us-central1-a e un'assegnazione delle policy del sistema operativo
con l'ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a.
VM Manager imposta quindi l'etichetta del criterio su instance-1.
Quando crei instance-2, VM Manager imposta la stessa etichetta della policy su instance-2.
Quando crei instance-3,
VM Manager crea una policy del sistema operativo Ops Agent per la zona us-east1-b
e un'assegnazione delle policy del sistema operativo con l'ID
goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. VM Manager assegna quindi l'etichetta della policy a instance-3.
Le policy del sistema operativo dell'agente Ops coprono quindi le seguenti VM in base agli
ID assegnazione delle policy del sistema operativo dell'agente Ops:
Per impostazione predefinita, instance-4 non è coperta perché non hai selezionato
Installa Ops Agent per il monitoraggio e il logging, quindi non ha l'etichetta
goog-ops-agent-policy:v2-x86-template-1-0-0. Se vuoi applicare la policy del sistema operativo di Ops Agent anche a
instance-4, consulta
Aggiungere la copertura della policy del sistema operativo di Ops Agent a una VM esistente.
Gestire le versioni dell'agente operativo sulle VM coperte dal criterio del sistema operativo dell'agente operativo
La policy del sistema operativo di Ops Agent non aggiorna l'agente quando vengono rilasciate nuove versioni
dell'agente. Se nella VM è installata una versione di Ops Agent, il criterio non ha effetto. Se disinstalli Ops Agent, il criterio rileva che non è installato e installa l'ultima versione.
Per eseguire l'upgrade della VM all'ultima versione di Ops Agent, disinstalla la
versione attualmente in esecuzione e lascia che il criterio del sistema operativo Ops Agent
installi l'ultima versione.
I criteri del sistema operativo sono strumenti generici per l'installazione di pacchetti. Per impostazione predefinita, quando VM Manager è abilitato perché hai creato una VM con Ops Agent installato automaticamente, VM Manager è abilitato in modalità limitata.
Per informazioni sulle modalità e sui prezzi di VM Manager, consulta
Prezzi di VM Manager.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[],[],null,["# Install the Ops Agent during VM creation\n\nThis document describes how the Google Cloud console can automatically install the\nOps Agent for you when you create a VM instance. During the installation\nprocess, the Compute Engine [VM Manager](/compute/docs/vm-manager) creates an\nOps Agent OS policy\nthat installs the agent and reinstalls it when necessary. The\nVM Manager helps you get the Ops Agent running on your VM and ensures\nthat the agent is always installed.\n\nOverview\n--------\n\nThe VM Manager uses OS policies to manage the Ops Agent\ninstallation. A configuration policy is applied to a VM by using a mapping\ncalled an *assignment ID*, which looks like the following example: \n\n```\ngoog-ops-agent-v2-x86-template-1-0-0-ZONE\n```\n\nAn assignment ID for an Ops Agent OS policy consists of the following\ncomponents:\n\n- The name of the policy: \"goog-ops-agent\"\n- A template for creating the policy: \"v2-x86-template\"\n- A version string for the template. The version, which might change over time, is a value like \"\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e\".\n- The zone to which the assignment ID applies, a value like \"us-central1-a\".\n\nA VM is associated with an assignment ID by using the labels on the VM instance.\nA Compute Engine VM is a monitored resource of type\n[`gce_instance`](/monitoring/api/resources#tag_gce_instance)\nand includes a `zone` label. When you use the Google Cloud console to\ncreate a VM with the Ops Agent installed, the VM Manager adds another\nlabel to the VM, which looks like `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e. This label identifies the\npolicy, template, and version:\n\n- Label key, the identifier for the policy: `goog-ops-agent-policy`\n- Label value, the policy template and version: `v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e\n\nWhen you create a VM in the Google Cloud console, you can select the\n**Install Ops Agent for Monitoring and Logging** checkbox. When you click\n**Create** , VM Manager assigns the VM a label of `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e and\ninstalls the Ops Agent. If the VM is the first VM in its zone, then\nVM Manager also creates an Ops Agent OS policy and an Ops Agent OS\npolicy assignment for that zone.\n\nWhile a zone has an Ops Agent OS policy assignment, the Ops Agent OS policy\nmonitors VMs that have the following characteristics:\n\n- The VM has the `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e label.\n- The VM is in the same zone as the Ops Agent OS policy assignment.\n\nThe Ops Agent OS policy checks every hour whether its\ncovered VMs have the Ops Agent installed. If the Ops Agent isn't\ninstalled, then the Ops Agent OS policy installs the latest version\nof the agent.\n\nCreate a VM with automatic installation of the Ops Agent\n--------------------------------------------------------\n\nTo install the Ops Agent automatically during VM creation and apply the\nOps Agent OS policy assignment to the VM, do the following:\n\n1.\n Grant roles to your user account. Run the following command once for each of the following\n IAM roles:\n `roles/osconfig.osPolicyAssignmentEditor`\n\n ```bash\n gcloud projects add-iam-policy-binding PROJECT_ID --member=\"user:\u003cvar translate=\"no\"\u003eUSER_IDENTIFIER\u003c/var\u003e\" --role=ROLE\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID.\n - \u003cvar translate=\"no\"\u003eUSER_IDENTIFIER\u003c/var\u003e: the identifier for your user account---for example, `myemail@example.com`.\n - \u003cvar translate=\"no\"\u003eROLE\u003c/var\u003e: the IAM role that you grant to your user account.\n2. Follow the steps in [Create a VM instance from a public image](/compute/docs/instances/create-start-instance#publicimage). Before you click **Create** , select the **Install Ops Agent for Monitoring and Logging** checkbox:\n\n | **Note:** When you select the **Install Ops Agent for Monitoring and Logging** checkbox during VM creation, the examples on the tabs in the **Equivalent code** flyout are updated to include the steps for creating the Ops Agent OS policy. There is no REST equivalent for creating an Ops Agent OS policy.\n3. Click **Create** .\n\n When you install the Ops Agent automatically for the first time in a zone,\n if you don't have VM Manager enabled for your Google Cloud project,\n then the VM-creation process does the following:\n 1. Enables VM Manager to operate in [restricted mode](/compute/docs/vm-manager#pricing).\n 2. Creates the Ops Agent OS policy and an Ops Agent OS policy assignment for the zone. The Ops Agent OS policy is a field of the policy assignment.\n 3. Enables Patch, OS policies, and OS inventory management by setting the VM metadata label `enable-osconfig` to `TRUE`.\n 4. Creates the VM and assigns it the Ops Agent OS policy label.\n\n \u003cbr /\u003e\n\n If you create a VM and automatically install the Ops Agent in a zone\n where an Ops Agent OS policy assignment already exists, then the VM-creation\n process creates the VM and assigns it the Ops Agent OS policy label.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n\u003cbr /\u003e\n\nExample\n-------\n\nYour Google Cloud project doesn't have any Ops Agent OS\npolicy assignments. You create two VMs, *instance-1* and *instance-2* in the\n`us-central1-a` zone. You\nthen create *instance-3* and *instance-4* in the `us-east1-b` zone. *instance-1* , *instance-2* , and\n*instance-3* had the **Install Ops Agent for Monitoring and Logging** checkbox\nselected during creation.\n\n- When you create *instance-1* , VM Manager creates an Ops Agent OS policy for the `us-central1-a` zone and an OS policy assignment with the ID `goog-ops-agent-v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e`-us-central1-a`. VM Manager then sets the policy label on *instance-1*.\n- When you create *instance-2* , VM Manager sets the same policy label on *instance-2*.\n- When you create *instance-3* , VM Manager creates an Ops Agent OS policy for the `us-east1-b` zone and an OS policy assignment with the ID `goog-ops-agent-v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e`-us-east1-b`. VM Manager then assigns the policy label to *instance-3*.\n\nThe Ops Agent OS policies then cover the following VMs based on the\nOps Agent OS policy assignment IDs:\n\nBy default, *instance-4* isn't covered because you didn't select\n**Install Ops Agent for Monitoring and Logging** , so it doesn't have the\n`goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e label. If you also want to apply the Ops Agent OS policy to\n*instance-4* , then see\n[Add Ops Agent OS policy coverage to an existing VM](/monitoring/agent/ops-agent/manage-policies-auto-install#add-coverage).\n\nManage Ops Agent versions on VMs covered by the Ops Agent OS policy\n-------------------------------------------------------------------\n\nThe Ops Agent OS policy doesn't update the Ops Agent when new versions of the\nagent are released. As long as the VM has some version of the Ops Agent\ninstalled, the policy does nothing. If you uninstall the Ops Agent, then the\npolicy detects that the Ops Agent isn't installed and then installs the latest\nversion.\n\nTo upgrade your VM to the latest version of the Ops Agent, uninstall the\nversion that you are currently running and let the Ops Agent OS policy\ninstall the latest version.\n\nIf you need to install a previous version of the Ops Agent, you can\n[uninstall the Ops Agent on VMs covered by the Ops Agent OS policy](/monitoring/agent/ops-agent/manage-policies-auto-install#uninstall)\nand then [install a specific version of the agent](/monitoring/agent/ops-agent/installation#install-specific-version).\n\nTroubleshooting\n---------------\n\nFor information about troubleshooting agent installation and Ops Agent OS\npolicies, see [Manage VMs covered by the Ops Agent OS policy](/monitoring/agent/ops-agent/manage-policies-auto-install)\nand\n[Agent diagnostics tool for automatic installation policies](/monitoring/agent/ops-agent/troubleshoot-find-info#agent_diagnostics_tool_for_automatic_installation_policies).\n\nPricing\n-------\n\nOS policies are generic tools for installing packages. By default, when\nVM Manager is enabled because you've created a VM with the Ops Agent\nautomatically installed, VM Manager is enabled in the limited mode.\nFor information about VM Manager modes and pricing, see\n[VM Manager Pricing](/compute/docs/vm-manager#pricing).\n\nWhat's next\n-----------\n\nFor information about managing VMs covered by the Ops Agent OS policy, see\n[Manage VMs covered by the Ops Agent OS policy](/monitoring/agent/ops-agent/manage-policies-auto-install)."]]
