Den Ops-Agent während des VM-Erstellungsvorgangs installieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument wird beschrieben, wie der Ops-Agent automatisch über die Google Cloud Konsole installiert werden kann, wenn Sie eine VM-Instanz erstellen. Während der Installation erstellt der VM Manager von Compute Engine eine Ops-Agent-Betriebssystemrichtlinie, mit der der Agent installiert und bei Bedarf neu installiert wird. Mit dem VM Manager können Sie den Ops-Agent auf Ihrer VM ausführen und dafür sorgen, dass der Agent immer installiert ist.
Übersicht
VM Manager verwendet Betriebssystemrichtlinien, um die Ops-Agent-Installation zu verwalten. Eine Konfigurationsrichtlinie wird auf eine VM angewendet, indem eine Zuordnung verwendet wird, die als Zuweisungs-ID bezeichnet wird und wie im folgenden Beispiel aussieht:
goog-ops-agent-v2-x86-template-1-0-0-ZONE
Eine Zuweisungs-ID für eine Ops-Agent-Betriebssystemrichtlinie besteht aus den folgenden Komponenten:
Der Name der Richtlinie: „goog-ops-agent“
Eine Vorlage zum Erstellen der Richtlinie: „v2-x86-template“
Ein Versionsstring für die Vorlage. Die Version, die sich im Laufe der Zeit ändern kann, ist ein Wert wie „1-0-0“.
Zone, für die die Zuweisungs-ID gilt, z. B. "us-central1-a".
Eine VM wird einer Zuweisungs-ID über die Labels der VM-Instanz zugeordnet.
Eine Compute Engine-VM ist eine überwachte Ressource vom Typ gce_instance und enthält ein zone-Label. Wenn Sie die Google Cloud -Konsole verwenden, um eine VM mit installiertem Ops-Agent zu erstellen, fügt der VM Manager der VM ein weiteres Label hinzu, das so aussieht: goog-ops-agent-policy:v2-x86-template-1-0-0. Dieses Label gibt die Richtlinie, die Vorlage und die Version an:
Label-Schlüssel, die Kennung für die Richtlinie: goog-ops-agent-policy
Labelwert, Richtlinienvorlage und ‑version: v2-x86-template-1-0-0
Wenn Sie eine VM in der Google Cloud Console erstellen, können Sie das Kästchen Ops-Agent für Monitoring und Logging installieren auswählen. Wenn Sie auf Erstellen klicken, weist VM Manager der VM das Label goog-ops-agent-policy:v2-x86-template-1-0-0 zu und installiert den Ops-Agent. Wenn die VM die erste VM in ihrer Zone ist, erstellt VM Manager auch eine Ops-Agent-Betriebssystemrichtlinie und eine Zuweisung von Ops-Agent-Betriebssystemrichtlinien für diese Zone.
Solange einer Zone eine Zuweisung von Ops-Agent-Betriebssystemrichtlinien zugewiesen ist, werden VMs mit den folgenden Merkmalen von der Ops-Agent-Betriebssystemrichtlinie überwacht:
Die VM hat das Label goog-ops-agent-policy:v2-x86-template-1-0-0.
Die VM befindet sich in derselben Zone wie die Zuweisung der Ops-Agent-Betriebssystemrichtlinie.
Die Ops-Agent-Betriebssystemrichtlinie prüft stündlich, ob der Ops-Agent auf den abgedeckten VMs installiert ist. Wenn der Ops-Agent nicht installiert ist, wird durch die Ops-Agent-Betriebssystemrichtlinie die neueste Version des Agents installiert.
VM mit automatischer Installation des Ops-Agents erstellen
So installieren Sie den Ops-Agent während der VM-Erstellung automatisch und wenden die Zuweisung der Ops-Agent-Betriebssystemrichtlinie auf die VM an:
Grant roles to your user account. Run the following command once for each of the following
IAM roles:
roles/osconfig.osPolicyAssignmentEditor
Wenn Sie den Ops-Agent zum ersten Mal automatisch in einer Zone installieren und VM Manager für Ihr Google Cloud -Projekt nicht aktiviert ist, wird beim Erstellen der VM Folgendes ausgeführt:
Erstellt die Betriebssystemrichtlinie für den Ops-Agent und eine Zuweisung der Betriebssystemrichtlinie für den Ops-Agent für die Zone. Die Ops-Agent-Betriebssystemrichtlinie ist ein Feld der Richtlinienzuweisung.
Aktiviert Patch-, Betriebssystemrichtlinien- und OS Inventory Management durch Festlegen des VM-Metadatenlabels enable-osconfig auf TRUE.
Erstellt die VM und weist ihr das Ops-Agent-Betriebssystemrichtlinien-Label zu.
Wenn Sie eine VM erstellen und den Ops-Agent automatisch in einer Zone installieren, in der bereits eine Zuweisung der Ops-Agent-Betriebssystemrichtlinie vorhanden ist, wird die VM erstellt und ihr wird das Label der Ops-Agent-Betriebssystemrichtlinie zugewiesen.
Beispiel
Für Ihr Google Cloud Projekt sind keine Ops-Agent-OS-Richtlinienzuweisungen vorhanden. Sie erstellen zwei VMs, instance-1 und instance-2, in der Zone us-central1-a. Anschließend erstellen Sie instance-3 und instance-4 in der us-east1-b-Zone. instance-1, instance-2 und instance-3 hatte das Kästchen Ops-Agent für Monitoring und Logging installieren bei der Erstellung ausgewählt.
Wenn Sie instance-1 erstellen, erstellt VM Manager eine Ops-Agent-Betriebssystemrichtlinie für die Zone us-central1-a und eine Zuweisung von Betriebssystemrichtlinien mit der ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a.
VM Manager legt dann das Richtlinienlabel für instance-1 fest.
Wenn Sie instance-2 erstellen, legt VM Manager dasselbe Richtlinienlabel für instance-2 fest.
Wenn Sie instance-3 erstellen, erstellt VM Manager eine Ops-Agent-Betriebssystemrichtlinie für die Zone us-east1-b und eine Zuweisung von Betriebssystemrichtlinien mit der ID goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. VM Manager weist dann das Richtlinienlabel instance-3 zu.
Die Betriebssystemrichtlinien des Ops-Agents decken dann die folgenden VMs basierend auf den Zuweisungs-IDs der Betriebssystemrichtlinien des Ops-Agents ab:
Standardmäßig ist instance-4 nicht abgedeckt, weil Sie Ops-Agent für Monitoring und Logging installieren nicht ausgewählt haben. Darum enthält es nicht das goog-ops-agent-policy:v2-x86-template-1-0-0-Label Wenn Sie die Ops-Agent-Betriebssystemrichtlinie auch auf instance-4 anwenden möchten, lesen Sie den Abschnitt Abdeckung der Ops-Agent-Betriebssystemrichtlinie auf eine vorhandene VM ausweiten.
Ops-Agent-Versionen auf VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden
Die Ops-Agent-Betriebssystemrichtlinie aktualisiert den Ops-Agent nicht, wenn neue Versionen des Agents veröffentlicht werden. Solange auf der VM eine Version des Ops-Agents installiert ist, hat die Richtlinie keine Auswirkungen. Wenn Sie den Ops-Agent deinstallieren, erkennt die Richtlinie, dass der Ops-Agent nicht installiert ist, und installiert dann die neueste Version.
Wenn Sie Ihre VM auf die neueste Version des Ops-Agents aktualisieren möchten, deinstallieren Sie die Version, die Sie derzeit verwenden, und lassen Sie die neueste Version durch die Ops-Agent-Betriebssystemrichtlinie installieren.
Betriebssystemrichtlinien sind generische Tools zum Installieren von Paketen. Wenn VM Manager standardmäßig aktiviert wird, weil Sie eine VM mit automatisch installiertem Ops-Agent erstellt haben, wird VM Manager im eingeschränkten Modus aktiviert.
Informationen zu VM Manager-Modi und ‑Preisen finden Sie unter Preise für VM Manager.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-28 (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)."]]
