Cloud Monitoring-Agent auf einer einzelnen VM installieren

Der Cloud Monitoring-Agent erfasst System- und Anwendungsmesswerte aus Ihren VM-Instanzen und sendet diese an Monitoring. Sie können den Monitoring-Agent auch so konfigurieren, dass er Daten von Drittanbieteranwendungen erfasst.

In diesem Leitfaden wird die Installation des Cloud Monitoring-Agents für Monitoring auf Compute Engine- und Amazon Elastic Compute Cloud-VMs (EC2) erläutert. Die Verwendung des Agents ist optional, wird aber für Compute Engine-VM-Instanzen empfohlen. Bei diesen VMs kann Monitoring ohne den Agent auf einige Messwerte des VM-Hypervisors zugreifen, unter anderem auf Messwerte über die CPU-Auslastung, den Laufwerktraffic, den Netzwerktraffic und die Betriebszeit. Die Verwendung des Agents ist für Amazon Elastic Compute Cloud (EC2)-VMs erforderlich.

Auf Instanzen, die Microsoft Windows ausführen, zeichnet der Agent die CPU-Auslastung, den Speicher, die Auslagerungsdatei sowie die Volume-Nutzung auf. Wenn Sie einen IIS- oder SQL-Server ausführen, erfasst der Agent Messwerte dieser Dienste standardmäßig.

Hinweis

Prüfen Sie vor der Installation des Agents, dass folgende Komponenten vorhanden sind:

  • Eine unterstützte VM-Instanz in einem Google Cloud-Projekt oder Amazon Web Services-Konto (AWS-Konto).

    • Mindestens 250 MB an residentem Arbeitsspeicher (RSS) werden zum Ausführen des Monitoring-Agents empfohlen.

    Stellen Sie außerdem sicher, dass Ihre VM ein unterstütztes Betriebssystem ausführt.

  • Ein Arbeitsbereich zur Überwachung des AWS-Kontos, das die VM-Instanz enthält. Preisinformationen finden Sie unter Preise für die Operations Suite von Google Cloud.

  • Anmeldedaten für die VM-Instanz, um die Kommunikation mit Cloud Logging oder Cloud Monitoring zu autorisieren. Compute Engine-VM-Instanzen enthalten die Anmeldedaten in der Regel standardmäßig. Wenn eines der nachfolgenden Szenarien auf Sie zutrifft, haben Sie möglicherweise nicht die richtigen Anmeldedaten. Folgen Sie dann den Schritten unter Agent autorisieren:

    • Sie führen AWS EC2-VM-Instanzen aus und müssen auf den VMs Autorisierungsdaten installieren, bevor Sie den Agent installieren.

    • Sie führen sehr alter Compute Engine-Instanzen oder Compute Engine-Instanzen aus, die ohne die Standardanmeldedaten erstellt wurden.

    Führen Sie die Schritte unter Anmeldedaten für Compute Engine prüfen aus, um festzustellen, ob Sie die richtigen Anmeldedaten haben.

Google Cloud-Projekte für AWS EC2-VM-Instanzen

Wenn sich die Dokumentation auf das mit der VM-Instanz verknüpfte Google Cloud-Projekt, bezieht, ist damit bei EC2-VM-Instanzen das AWS-Connector-Projekt gemeint, das mit Ihrem AWS-Konto verknüpft ist.

Wenn Sie Ihr AWS-Konto mit einem Arbeitsbereich verbinden, wird das AWS-Connector-Projekt erstellt. Rufen Sie den Tab Einstellungen des Arbeitsbereichs auf, um das AWS-Verbindungsprojekt zu identifizieren. Das Verbindungsprojekt wird unter der Überschrift AWS-Konten aufgeführt. In der Spalte Projekt-ID werden die Google Cloud-Projekte angezeigt, die Ihrem Arbeitsbereich zugeordnet sind.

Weitere Informationen zu AWS-Verbindungsprojekten finden Sie auf der Seite "Arbeitsbereiche".

VMs ohne Remote-Paketzugriff

Die Installation des Monitoring-Agents erfordert Zugriff auf Remote Package Repositories, sowohl für das Agent-Paket als auch (unter Linux) für dessen Abhängigkeiten. Wenn die Sicherheitsrichtlinie Ihres VM-Hosts den Zugriff auf Remote-Paket-Repositories verweigert, wird empfohlen, ein benutzerdefiniertes VM-Image mit dem vorinstallierten Agent zu erstellen und die Paketverwaltung in diesem Image zu deaktivieren.

Agent auf einer einzelnen VM installieren

So installieren Sie den Agent auf einer VM-Instanz, auf der Linux oder Microsoft Windows ausgeführt wird:

AMAZON LINUX AMI/CENTOS/RHEL

  1. Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her.

  2. Prüfen Sie, ob Sie Zugriff auf sudo haben.

  3. Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.

  4. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
  5. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo yum list --showduplicates stackdriver-agent
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Führen Sie zum Anheften an eine Hauptversion folgenden Befehl aus:

      sudo yum install -y stackdriver-agent-major-versio.*
      

      Führen Sie beispielsweise folgenden Befehl aus, um die 6.x.x des Agents anzuheften:

      sudo yum install -y stackdriver-agent-6.*
      
    3. Wenn Sie nicht an eine Hauptversion anheften möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo yum install -y stackdriver-agent-version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo yum install -y stackdriver-agent
        
  6. Agent-Dienst starten

    sudo service stackdriver-agent start
    

Sie können das Installationsskript nach erfolgreicher Ausführung löschen.

  • Führen Sie folgenden Befehl aus, um zu prüfen, ob der Agent wie erwartet funktioniert:

    sudo service stackdriver-agent status
    

    Der Status des Agents sollte OK sein.

  • Sie können auch die Protokolle überprüfen und sicherstellen, dass keine Fehler vorliegen:

    sudo grep collectd /var/log/{syslog,messages} | tail
    

Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

DEBIAN/UBUNTU

  1. Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her.

  2. Prüfen Sie, ob Sie Zugriff auf sudo haben.

  3. Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.

  4. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    sudo apt-get update
    
  5. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo apt-cache madison stackdriver-agent
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Führen Sie zum Anheften an eine Hauptversion folgenden Befehl aus:

      sudo apt-get install -y 'stackdriver-agent=major-version.*'
      

      Führen Sie beispielsweise folgenden Befehl aus, um die 6.x.x des Agents anzuheften:

      sudo apt-get install -y 'stackdriver-agent=6.*'
      
    3. Wenn Sie nicht an eine Hauptversion anheften möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo apt-get install -y stackdriver-agent=version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo apt-get install stackdriver-agent
        
  6. Agent-Dienst starten

    sudo service stackdriver-agent start
    

Sie können das Installationsskript nach erfolgreicher Ausführung löschen.

  • Führen Sie folgenden Befehl aus, um zu prüfen, ob der Agent wie erwartet funktioniert:

    sudo service stackdriver-agent status
    

    Der Status des Agents sollte OK sein.

  • Sie können auch die Protokolle überprüfen und sicherstellen, dass keine Fehler vorliegen:

    sudo grep collectd /var/log/{syslog,messages} | tail
    

Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

SLES/SUSE

  1. Stellen Sie mit SSH oder einem ähnlichen Tool eine Terminalverbindung zu Ihrer VM-Instanz her.

  2. Prüfen Sie, ob Sie Zugriff auf sudo haben.

  3. Wechseln Sie in ein Verzeichnis, auf das Sie Schreibzugriff haben, z. B. Ihr Basisverzeichnis.

  4. Fügen Sie das Package Repository des Agents hinzu:

    curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
    sudo bash add-monitoring-agent-repo.sh
    
  5. Installieren Sie den Agent:

    1. Listen Sie die verfügbaren Versionen des Agents auf, um auszuwählen, welche Version installiert werden soll:

      sudo zypper search -s stackdriver-agent
      
    2. In Produktionsumgebungen empfiehlt es sich, eine Hauptversion anzuhängen, um Hauptversionen zu vermeiden, die möglicherweise nicht abwärts kompatible Änderungen enthalten. Führen Sie zum Anheften an eine Hauptversion folgenden Befehl aus:

      sudo zypper install -y 'stackdriver-agent<major-version.0.0'
      

      Führen Sie beispielsweise folgenden Befehl aus, um die 6.x.x des Agents anzuheften:

      sudo zypper install -y 'stackdriver-agent<6+1.0.0'
      
    3. Wenn Sie nicht an eine Hauptversion anheften möchten, können Sie eine der anderen Installationsoptionen auswählen:

      1. Führen Sie folgenden Befehl aus, um eine bestimmte Version des Agents zu installieren:

          sudo zypper install -y stackdriver-agent=version-number
        
      2. Führen Sie Folgendes aus, um die neueste Version des Agents zu installieren:

          sudo zypper install stackdriver-agent
        
  6. Agent-Dienst starten

    sudo service stackdriver-agent start
    

Sie können das Installationsskript nach erfolgreicher Ausführung löschen.

  • Führen Sie folgenden Befehl aus, um zu prüfen, ob der Agent wie erwartet funktioniert:

    sudo service stackdriver-agent status
    

    Der Status des Agents sollte OK sein.

  • Sie können auch die Protokolle überprüfen und sicherstellen, dass keine Fehler vorliegen:

    sudo grep collectd /var/log/{syslog,messages} | tail
    

Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

WINDOWS

Führen Sie die folgenden Schritte aus, um den Agent auf einer VM-Instanz unter Windows zu installieren:

  1. Stellen Sie mithilfe von RDP oder einem ähnlichen Tool eine Verbindung zu Ihrer Instanz her und melden Sie sich bei Windows an.

  2. Öffnen Sie ein PowerShell-Terminal und führen Sie die folgenden PowerShell-Befehle aus. Sie benötigen keine Administratorberechtigungen.

    cd $env:UserProfile;
    (New-Object Net.WebClient).DownloadFile("https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe", ".\StackdriverMonitoring-GCM-46.exe")
    .\StackdriverMonitoring-GCM-46.exe
    

    Alternativ können Sie die folgende URL aufrufen, um das Installationsprogramm des Agents herunterzuladen und auszuführen:

    https://repo.stackdriver.com/windows/StackdriverMonitoring-GCM-46.exe

    Wenn Sie den Agent automatisch installieren möchten, hängen Sie beim Aufruf des Installationsprogramms die Option /S an:

    .\StackdriverMonitoring-GCM-46.exe /S
    

    Verwenden Sie im automatischen Modus die Option /D, um das Installationsverzeichnis anzugeben. Beispiel:

    .\StackdriverMonitoring-GCM-46.exe /S /D="C:\Google Cloud's operations suite\Monitoring\"
    

    Sie können das Installationsprogramm nach erfolgreichem Abschluss löschen.

    Wenn Sie Probleme mit der Installation haben, lesen Sie die Informationen auf der Seite Fehlerbehebung.

Optionale Aufgaben

In diesem Abschnitt wird beschrieben, wie Sie allgemeine Wartungsaufgaben durchführen.

HTTP-Proxy konfigurieren

Wenn Sie einen HTTP-Proxy für Proxy-Anfragen an die Logging API und Monitoring API verwenden, gehen Sie so vor:

LINUX

  1. Bearbeiten Sie die folgende Konfigurationsdatei (sollte erstellt werden, falls sie nicht vorhanden ist):

    • Bearbeiten Sie für Agent-Versionen ab 6.0.0 Folgendes:

      /etc/default/stackdriver-agent
      
    • Bearbeiten Sie für Agent-Versionen vor 6.0.0 die entsprechende Datei für Ihr Betriebssystem:

      Bearbeiten Sie für Debian und Ubuntu:

      /etc/default/stackdriver-agent
      

      Bearbeiten Sie für CentOS und SLES:

      /etc/default/stackdriver-collectd
      
  2. Fügen Sie die folgenden Zeilen hinzu:

     export http_proxy="http://proxy-ip:proxy-port"
     export https_proxy="http://proxy-ip:proxy-port"
     export no_proxy=169.254.169.254  # Skip proxy for the local Metadata Server.
    
  3. Starten Sie den Monitoring-Agent neu. Dazu führen Sie auf Ihrer VM-Instanz folgenden Befehl aus:

     sudo service stackdriver-agent restart
    

WINDOWS

  1. Wenn Sie einen HTTP-Proxy verwenden, führen Sie den folgenden Befehl über eine Administrator-Eingabeaufforderung aus. Dadurch werden die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY so festgelegt, dass der Agent Daten über ausgehende HTTPS-Verbindungen an Monitoring senden kann:

    setx HTTP_PROXY http://proxy-ip:proxy-port /m
    setx HTTPS_PROXY http://proxy-ip:proxy-port /m
    setx no_proxy 169.254.169.254 /m
    

Agent-Version ermitteln

Die Version des Monitoring-Agents auf Ihrem System können Sie ermitteln, indem Sie auf Ihrer VM-Instanz folgende Befehle ausführen:

AMAZON LINUX AMI/CENTOS/RHEL

Führen Sie unter Amazon Linux, Red Hat oder CentOS Linux den folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

DEBIAN/UBUNTU

Führen Sie unter Debian oder Ubuntu den folgenden Befehl aus:

dpkg-query --show --showformat \
    '${Package} ${Version} ${Architecture} ${Status}\n' \
     stackdriver-agent

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' \
     stackdriver-agent

WINDOWS

Unter Windows gibt es derzeit keine Möglichkeit, die Version des Monitoring-Agents festzustellen.

Agent neu starten

Sie müssen den Monitoring-Agent neu starten, damit Änderungen in den Konfigurationsdateien wirksam werden. Folgen Sie dieser Anleitung, um den Agent neu zu starten.

LINUX

Führen Sie folgenden Befehl für die Instanz aus:

 sudo service stackdriver-agent restart

WINDOWS

Administratorberechtigungen erforderlich: Führen Sie den folgenden Befehl in einem PowerShell-Terminal aus, um den Agent neu zu starten:

Restart-Service -Name StackdriverMonitoring

Agent-Upgrade durchführen

Folgen Sie dieser Anleitung, um den Monitoring-Agent auf die neueste Version zu aktualisieren:

AMAZON LINUX AMI/CENTOS/RHEL

Führen Sie unter Amazon Linux, Red Hat oder CentOS Linux den folgenden Befehl aus:

sudo yum update stackdriver-agent

DEBIAN/UBUNTU

Führen Sie unter Debian oder Ubuntu die folgenden Befehle aus:

sudo apt-get update
sudo apt-get install stackdriver-agent

SLES/SUSE

Führen Sie unter SUSE den folgenden Befehl aus:

sudo zypper update stackdriver-agent

Wenn Sie ein Upgrade von einem Agent mit der Version <= 6.0.5 durchführen, müssen Sie den Dienst manuell neu starten:

sudo service stackdriver-agent restart

WINDOWS

Installieren Sie den neuesten Agent wie im Abschnitt Unter Windows installieren auf dieser Seite beschrieben, um ein Upgrade auf die aktuelle Agent-Version durchzuführen. Das Installationsprogramm fordert Sie auf, die vorherige Version des Agents zu deinstallieren.

Agent deinstallieren

Folgen Sie der nachstehenden Anleitung, um den Monitoring-Agent und seine Konfigurationsdateien zu entfernen.

AMAZON LINUX AMI/CENTOS/RHEL

Führen Sie unter Amazon Linux, Red Hat oder CentOS Linux den folgenden Befehl aus:

sudo yum remove stackdriver-agent

DEBIAN/UBUNTU

Führen Sie unter Debian oder Ubuntu den folgenden Befehl aus:

sudo apt-get purge stackdriver-agent

SLES/SUSE

Führen Sie unter SUSE Linux folgenden Befehl aus:

sudo zypper remove stackdriver-agent

WINDOWS

Wählen Sie in der Systemsteuerung von Windows Programm deinstallieren aus. Der Monitoring-Agent sollte in der Liste der deinstallierbaren Programme aufgeführt sein.