GoogleCloudPlatform.google_cloud_ops_agents
Ansible Rolle für Cloud-Operationen
Diese Ansible-Rolle installiert die Cloud-Operations-Agenten.
Rolle installieren
[Empfohlen] Verwenden Sie Ansible Galaxy, um Abhängigkeiten zu verwalten. Verwenden Sie diesen Befehl, um zu installieren:
ansible-galaxy install googlecloudplatform.google_cloud_ops_agents
Um GitHub-Submodule zur Verwaltung von Abhängigkeiten zu verwenden, installieren Sie dieses Verzeichnis in Ihrem Rollenverzeichnis (normalerweise im Rollenverzeichnis neben Ihrem Playbook) unter dem Namen
googlecloudplatform.google_cloud_ops_agents
:git clone <this-git-repo> roles/googlecloudplatform.google_cloud_ops_agents
Es gibt außerdem ein ausführliches Tutorial.
Anforderungen
Berechtigungen für die Google Cloud API. Wenn Sie eine alte Compute Engine-Instanz oder Compute Engine-Instanzen ohne die Standardanmeldeinformationen ausführen, müssen Sie die folgenden Schritte durchführen: https://cloud.google.com/monitoring/agent/authorization#before_you_begin.
Rollenvariablen
Die Variable agent_type
ist erforderlich und wird verwendet, um anzugeben, welcher Agent konfiguriert wird. Die verfügbaren Optionen sind monitoring
, logging
und ops-agent
.
Die Variable package_state
kann verwendet werden, um den gewünschten Zustand des Agenten anzugeben. Die erlaubten Werte sind present
(Standard) und absent
.
Die Variable version
kann verwendet werden, um die zu installierende Version des Agenten anzugeben. Die erlaubten Werte sind latest
(Standard), MAJOR_VERSION.*.*
und MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
, die unten genauer beschrieben werden.
version=latest
Diese Einstellung erleichtert es, die Agenten-Version auf dem neuesten Stand zu halten, birgt jedoch potenzielle Risiken. Wenn eine neue Hauptversion veröffentlicht wird, kann die Richtlinie die neueste Version des Agenten aus der neuen Hauptversion installieren, was zu incompatiblen Änderungen führen kann. Für Produktionsumgebungen sollten Sie die untenstehende Einstellung version=MAJOR_VERSION.*.*
für sicherere Agenten-Installationen in Betracht ziehen.
version=MAJOR_VERSION.*.*
Wenn eine neue Hauptversion verfügbar ist, stellt diese Einstellung sicher, dass nur die neueste Version der angegebenen Hauptversion installiert wird, was verhindert, dass unbeabsichtigt inkompatible Änderungen eingeführt werden. Dies wird für Produktionsumgebungen empfohlen, um sicherere Agenteneinstellungen zu gewährleisten.
version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
Diese Einstellung wird nicht empfohlen, da sie Upgrades neuer Versionen des Agenten verhindert, die Fehlerbehebungen und andere Verbesserungen enthalten.
Die Variable main_config_file
kann verwendet werden, um einen absoluten oder relativen Pfad zu einer benutzerdefinierten Konfigurationsdatei anzugeben. Diese Datei überschreibt die Konfigurationsdatei auf der Ziel-VM.
Für weitere Informationen siehe Konfiguration des Monitoring-Agents, Konfiguration des Logging-Agents oder Konfiguration des Ops-Agents.
Standardmäßig überwacht und protokolliert der Agent nur Systemressourcen wie CPU, Arbeitsspeicher, Festplatte usw. Das Monitoring und Logging von Drittanbieteranwendungen kann konfiguriert werden, indem ein Pfad zu einem Verzeichnis angegeben wird, das Plugin-Konfigurationsdateien enthält, unter Verwendung der Variablen additional_config_dir
. Alle .conf
-Dateien in diesem Verzeichnis werden im Plugin-Verzeichnis des Agenten auf der Ziel-VM bereitgestellt. Die Hauptkonfigurationsdatei sollte eine Zeile enthalten, die dieses Verzeichnis einbezieht. Bitte beachten Sie, dass diese Variable nur beim Konfigurieren der Monitoring- oder Logging-Agents angegeben werden kann.
Für weitere Informationen siehe Monitoring von Drittanbieteranwendungen.
Beispiel-Playbooks
# Installation der Monitoring- und Logging-Agents
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: monitoring
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: logging
# Installation der Monitoring- und Logging-Agents mit benutzerdefinierten Konfigurationen
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: monitoring
version: latest
main_config_file: monitoring_agent.conf
additional_config_dir: monitoring_agent_dir/
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: logging
version: 1.*.*
main_config_file: logging_agent.conf
additional_config_dir: logging_agent_dir/
# Installation des Ops-Agents
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: ops-agent
# Installation des Ops-Agents mit benutzerdefinierter Konfiguration
- hosts: all
become: true
roles:
- role: googlecloudplatform.google_cloud_ops_agents
vars:
agent_type: ops-agent
version: 1.0.1
main_config_file: ops_agent.yaml
Kompatibilität
Die folgende Matrix listet die Versionen dieser Ansible-Rolle und die auf unterstützten Agenten-Versionen auf.
Ansible Rollen-Version | Kompatible Ops-Agent-Version(en) | Kompatible Logging-Agent-Version(en) | Kompatible Monitoring-Agent-Version(en) |
---|---|---|---|
1.x.x | 2.x.x | 1.x.x | 6.x.x |
- Ops-Agent Veröffentlichungen
- Logging-Agent Veröffentlichungen
- Monitoring-Agent Veröffentlichungen
Fehlerbericht und Funktionsanfrage
Bitte melden Sie einen Fall über https://cloud.google.com/support-hub, um offiziellen Support zu erhalten, der SLOs einhält.
Lizenz
Copyright 2020 Google Inc. Alle Rechte vorbehalten.
Lizenz unter der Apache License, Version 2.0 ("Lizenz"); Sie dürfen diese Datei nicht verwenden, es sei denn, Sie halten sich an die Lizenz. Sie können eine Kopie der Lizenz unter
http://www.apache.org/licenses/LICENSE-2.0
erhalten. Sofern nicht gesetzlich vorgeschrieben oder schriftlich vereinbart, wird Software, die unter der Lizenz verteilt wird, auf einer "AS IS"-Basis ohne Gewähr für irgendeine Art, weder ausdrücklich noch stillschweigend, bereitgestellt. Weitere Informationen finden Sie in der Lizenz, die die spezifischen Bedingungen und Einschränkungen regelt.
Install the Google Cloud Ops Agents
ansible-galaxy install GoogleCloudPlatform.google_cloud_ops_agents