Skip to main content
Data Infrastructure Insights
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Konfigurieren eines Agenten zum Sammeln von Daten (Windows/Linux)

Beitragende netapp-alavoie dgracenetapp netapp-mjryan
PDFs

Data Infrastructure Insights verwendet"Telegraf" als dessen Agent für die Erfassung von Integrationsdaten. Telegraf ist ein Plugin-gesteuerter Server-Agent, der zum Sammeln und Melden von Metriken, Ereignissen und Protokollen verwendet werden kann. Eingabe-Plugins werden verwendet, um die gewünschten Informationen im Agenten zu sammeln, indem direkt auf das System/Betriebssystem zugegriffen wird, APIs von Drittanbietern aufgerufen werden oder konfigurierte Streams abgehört werden (z. B. Kafka, statsD usw.). Ausgabe-Plugins werden verwendet, um die gesammelten Metriken, Ereignisse und Protokolle vom Agenten an Data Infrastructure Insights zu senden.

Informationen zur Installation auf Kubernetes finden Sie im"NetApp Kubernetes Monitoring Operator" Seite.

Hinweis Für eine genaue Prüfung und Datenberichterstattung wird dringend empfohlen, die Zeit auf dem Agent-Computer mithilfe von Network Time Protocol (NTP) oder Simple Network Time Protocol (SNTP) zu synchronisieren.
Hinweis Wenn Sie die Installationsdateien vor der Installation des Agenten überprüfen möchten, lesen Sie den Abschnitt weiter unten aufÜberprüfen der Prüfsummen von Telegraf-Paketen .

Installieren eines Agenten

Wenn Sie einen Service-Datensammler installieren und noch keinen Agenten konfiguriert haben, werden Sie aufgefordert, zuerst einen Agenten für das entsprechende Betriebssystem zu installieren. Dieses Thema enthält Anweisungen zur Installation des Telegraf-Agenten auf den folgenden Betriebssystemen:

Um einen Agenten zu installieren, müssen Sie unabhängig von der verwendeten Plattform zunächst Folgendes tun:

  1. Melden Sie sich bei dem Host an, den Sie für Ihren Agenten verwenden möchten.

  2. Melden Sie sich bei Ihrer Data Infrastructure Insights Umgebung an und navigieren Sie zu Observability > Collectors.

  3. Klicken Sie auf +Datensammler und wählen Sie einen zu installierenden Datensammler aus.

  4. Wählen Sie die passende Plattform für Ihren Host (Windows, Linux)

  5. Befolgen Sie die verbleibenden Schritte für jede Plattform.

Hinweis Nachdem Sie einen Agenten auf einem Host installiert haben, müssen Sie auf diesem Host keinen weiteren Agenten installieren.
Tipp Sobald Sie einen Agenten auf einem Server/einer VM installiert haben, sammelt Data Infrastructure Insights zusätzlich zu den von Ihnen konfigurierten Datensammlern auch Metriken von diesem System. Diese Kennzahlen werden wie folgt erfasst:"„Knoten“-Metriken" .
Hinweis Wenn Sie einen Proxy verwenden, lesen Sie die Proxy-Anweisungen für Ihre Plattform, bevor Sie den Telegraf-Agenten installieren.

Protokollspeicherorte

Telegraf-Protokollnachrichten werden standardmäßig von stdout in die folgenden Protokolldateien umgeleitet:

  • RHEL/CentOS: /var/log/telegraf/telegraf.log

  • Ubuntu/Debian: /var/log/telegraf/telegraf.log

  • Windows: C:\Programme\telegraf\telegraf.log

Windows

Voraussetzungen:

  • PowerShell muss installiert sein

  • Wenn Sie sich hinter einem Proxy befinden, müssen Sie die Anweisungen im Abschnitt Proxy-Unterstützung für Windows konfigurieren befolgen.

Konfigurieren der Proxy-Unterstützung für Windows

Hinweis Wenn Ihre Umgebung einen Proxy verwendet, lesen Sie diesen Abschnitt vor der Installation.
Hinweis Die folgenden Schritte beschreiben die Aktionen, die zum Festlegen der Umgebungsvariablen http_proxy/https_proxy erforderlich sind. Für einige Proxy-Umgebungen müssen Benutzer möglicherweise auch die Umgebungsvariable no_proxy festlegen.

Führen Sie bei Systemen, die sich hinter einem Proxy befinden, Folgendes aus, um die Umgebungsvariable(n) https_proxy und/oder http_proxy VOR der Installation des Telegraf-Agenten festzulegen:

[System.Environment]:SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]:Machine)

Installieren des Agenten

Windows-Agent-Installation

Schritte zum Installieren des Agenten unter Windows:

  1. Wählen Sie einen Agent-Zugriffsschlüssel.

  2. Kopieren Sie den Befehlsblock aus dem Agent-Installationsdialog. Sie können auf das Zwischenablagesymbol klicken, um den Befehl schnell in die Zwischenablage zu kopieren.

  3. Öffnen Sie ein PowerShell-Fenster

  4. Fügen Sie den Befehl in das PowerShell-Fenster ein und drücken Sie die Eingabetaste.

  5. Der Befehl lädt das entsprechende Agent-Installationsprogramm herunter, installiert es und legt eine Standardkonfiguration fest. Wenn der Vorgang abgeschlossen ist, wird der Agentendienst neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nachdem der Agent installiert wurde, können Sie den Dienst mit den folgenden Befehlen starten/stoppen:

Start-Service telegraf
Stop-Service telegraf

Deinstallation des Agenten

Um den Agenten unter Windows zu deinstallieren, führen Sie in einem PowerShell-Fenster die folgenden Schritte aus:

  1. Stoppen und löschen Sie den Telegraf-Dienst:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Entfernen Sie das Zertifikat aus dem Truststore:

    cd Cert:\CurrentUser\Root
//rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC
rm 1A918038E8E127BB5C87A202DF173B97A05B4996

  3. Löschen Sie den Ordner C:\Programme\telegraf, um die Binär-, Protokoll- und Konfigurationsdateien zu entfernen

  4. Entfernen Sie den Schlüssel SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf aus der Registrierung

Aktualisieren des Agenten

Um den Telegraf-Agenten zu aktualisieren, gehen Sie wie folgt vor:

  1. Stoppen und löschen Sie den Telegraf-Dienst:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Löschen Sie den Schlüssel SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf aus der Registrierung

  3. Löschen Sie C:\Programme\telegraf\telegraf.conf

  4. Löschen Sie C:\Programme\telegraf\telegraf.exe

  5. "Installieren des neuen Agenten" .

RHEL und CentOS

Voraussetzungen:

  • Die folgenden Befehle müssen verfügbar sein: curl, sudo, ping, sha256sum, openssl und dmidecode

  • Wenn Sie sich hinter einem Proxy befinden, müssen Sie die Anweisungen im Abschnitt Proxy-Unterstützung für RHEL/CentOS konfigurieren befolgen.

Konfigurieren der Proxy-Unterstützung für RHEL/CentOS

Hinweis Wenn Ihre Umgebung einen Proxy verwendet, lesen Sie diesen Abschnitt vor der Installation.
Hinweis Die folgenden Schritte beschreiben die Aktionen, die zum Festlegen der Umgebungsvariablen http_proxy/https_proxy erforderlich sind. Für einige Proxy-Umgebungen müssen Benutzer möglicherweise auch die Umgebungsvariable no_proxy festlegen.

Führen Sie bei Systemen hinter einem Proxy die folgenden Schritte VOR der Installation des Telegraf-Agenten aus:

  1. Legen Sie die Umgebungsvariable(n) https_proxy und/oder http_proxy für den aktuellen Benutzer fest:

     export https_proxy=<proxy_server>:<proxy_port>
. Erstellen Sie _/etc/default/telegraf_ und fügen Sie Definitionen für die Variable(n) _https_proxy_ und/oder _http_proxy_ ein:
    https_proxy=<proxy_server>:<proxy_port>

Installieren des Agenten

Rhel/CentOS-Agent-Installation

Schritte zum Installieren des Agenten auf RHEL/CentOS:

  1. Wählen Sie einen Agent-Zugriffsschlüssel.

  2. Kopieren Sie den Befehlsblock aus dem Agent-Installationsdialog. Sie können auf das Zwischenablagesymbol klicken, um den Befehl schnell in die Zwischenablage zu kopieren.

  3. Öffnen Sie ein Bash-Fenster

  4. Fügen Sie den Befehl in das Bash-Fenster ein und drücken Sie die Eingabetaste.

  5. Der Befehl lädt das entsprechende Agent-Installationsprogramm herunter, installiert es und legt eine Standardkonfiguration fest. Wenn der Vorgang abgeschlossen ist, wird der Agentendienst neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nachdem der Agent installiert wurde, können Sie den Dienst mit den folgenden Befehlen starten/stoppen:

Wenn Ihr Betriebssystem systemd verwendet (CentOS 7+ und RHEL 7+):

sudo systemctl start telegraf
sudo systemctl stop telegraf

Wenn Ihr Betriebssystem nicht systemd verwendet (CentOS 7+ und RHEL 7+):

sudo service telegraf start
sudo service telegraf stop

Deinstallation des Agenten

Um den Agenten unter RHEL/CentOS zu deinstallieren, gehen Sie in einem Bash-Terminal wie folgt vor:

  1. Beenden Sie den Telegraf-Dienst:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Entfernen Sie den Telegraf-Agenten:

     yum remove telegraf
. Entfernen Sie alle Konfigurations- oder Protokolldateien, die möglicherweise zurückgeblieben sind:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aktualisieren des Agenten

Um den Telegraf-Agenten zu aktualisieren, gehen Sie wie folgt vor:

  1. Stoppen Sie den Telegraf-Dienst:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Entfernen Sie den vorherigen Telegraf-Agenten:

     yum remove telegraf
. link:#rhel-and-centos["Installieren des neuen Agenten"] .

Ubuntu und Debian

Voraussetzungen:

  • Die folgenden Befehle müssen verfügbar sein: curl, sudo, ping, sha256sum, openssl und dmidecode

  • Wenn Sie sich hinter einem Proxy befinden, müssen Sie die Anweisungen im Abschnitt Proxy-Unterstützung für Ubuntu/Debian konfigurieren befolgen.

Konfigurieren der Proxy-Unterstützung für Ubuntu/Debian

Hinweis Wenn Ihre Umgebung einen Proxy verwendet, lesen Sie diesen Abschnitt vor der Installation.
Hinweis Die folgenden Schritte beschreiben die Aktionen, die zum Festlegen der Umgebungsvariablen http_proxy/https_proxy erforderlich sind. Für einige Proxy-Umgebungen müssen Benutzer möglicherweise auch die Umgebungsvariable no_proxy festlegen.

Führen Sie bei Systemen hinter einem Proxy die folgenden Schritte VOR der Installation des Telegraf-Agenten aus:

  1. Legen Sie die Umgebungsvariable(n) https_proxy und/oder http_proxy für den aktuellen Benutzer fest:

     export https_proxy=<proxy_server>:<proxy_port>
. Erstellen Sie /etc/default/telegraf und fügen Sie Definitionen für die Variable(n) _https_proxy_ und/oder _http_proxy_ ein:
    https_proxy=<proxy_server>:<proxy_port>

Installieren des Agenten

Ubuntu/Debian-Agent-Installation

Schritte zum Installieren des Agenten unter Debian oder Ubuntu:

  1. Wählen Sie einen Agent-Zugriffsschlüssel.

  2. Kopieren Sie den Befehlsblock aus dem Agent-Installationsdialog. Sie können auf das Zwischenablagesymbol klicken, um den Befehl schnell in die Zwischenablage zu kopieren.

  3. Öffnen Sie ein Bash-Fenster

  4. Fügen Sie den Befehl in das Bash-Fenster ein und drücken Sie die Eingabetaste.

  5. Der Befehl lädt das entsprechende Agent-Installationsprogramm herunter, installiert es und legt eine Standardkonfiguration fest. Wenn der Vorgang abgeschlossen ist, wird der Agentendienst neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nachdem der Agent installiert wurde, können Sie den Dienst mit den folgenden Befehlen starten/stoppen:

Wenn Ihr Betriebssystem systemd verwendet:

sudo systemctl start telegraf
sudo systemctl stop telegraf

Wenn Ihr Betriebssystem systemd nicht verwendet:

sudo service telegraf start
sudo service telegraf stop

Deinstallation des Agenten

Um den Agenten unter Ubuntu/Debian zu deinstallieren, führen Sie in einem Bash-Terminal Folgendes aus:

  1. Beenden Sie den Telegraf-Dienst:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Entfernen Sie den Telegraf-Agenten:

     dpkg -r telegraf
. Entfernen Sie alle Konfigurations- oder Protokolldateien, die möglicherweise zurückgeblieben sind:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aktualisieren des Agenten

Um den Telegraf-Agenten zu aktualisieren, gehen Sie wie folgt vor:

  1. Stoppen Sie den Telegraf-Dienst:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Entfernen Sie den vorherigen Telegraf-Agenten:

     dpkg -r telegraf
. link:#ubuntu-and-debian["Installieren des neuen Agenten"] .

Überprüfen der Prüfsummen von Telegraf-Paketen

Das Installationsprogramm des Data Infrastructure Insights -Agenten führt Integritätsprüfungen durch, einige Benutzer möchten jedoch möglicherweise eigene Überprüfungen durchführen, bevor sie die heruntergeladene Telegraf-Binärdatei installieren. Dies kann durch Herunterladen des Installationsprogramms und Generieren einer Prüfsumme für das heruntergeladene Paket erfolgen. Anschließendes Vergleichen der Prüfsumme mit dem in den Installationsanweisungen angezeigten Wert.

Laden Sie das Installationspaket herunter, ohne es zu installieren

Um einen reinen Downloadvorgang durchzuführen (im Gegensatz zum standardmäßigen Herunterladen und Installieren), können Benutzer den von der Benutzeroberfläche erhaltenen Agenteninstallationsbefehl bearbeiten und die Option „Installieren“ entfernen.

Gehen Sie folgendermaßen vor:

  1. Kopieren Sie den Agent Installer-Ausschnitt wie angegeben.

  2. Fügen Sie den Codeausschnitt nicht in ein Befehlsfenster ein, sondern in einen Texteditor.

  3. Entfernen Sie das abschließende „--install“ (Linux) oder „-install“ (Windows) aus dem Befehl.

  4. Kopieren Sie den gesamten Befehl aus dem Texteditor.

  5. Fügen Sie es nun in Ihr Befehlsfenster (in einem Arbeitsverzeichnis) ein und führen Sie es aus.

Nicht-Windows (diese Beispiele gelten für Kubernetes; die tatsächlichen Skriptnamen können abweichen):

  • Herunterladen und installieren (Standard):

     installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify && sudo -E -H ./$installerName --install
* Nur zum Herunterladen:
    installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify

Windows:

  • Herunterladen und installieren (Standard):

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify -install } else { Write-Host "Install script checksum does not match"})"
* Nur zum Herunterladen:
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify } else { Write-Host "Install script checksum does not match"})"

Der Nur-Download-Befehl lädt alle erforderlichen Artefakte von Data Infrastructure Insights in das Arbeitsverzeichnis herunter. Zu den Artefakten zählen unter anderem:

  • ein Installationsskript

  • eine Umgebungsdatei

  • eine Telegraf-Binärdatei

  • eine Signatur für die Telegraf-Binärdatei

  • ein öffentliches Zertifikat zur Überprüfung der Binärsignatur

Das von DII heruntergeladene und kopierte Installations-Snippet führt automatisch eine Prüfsumme des Installationsskripts aus und die Signatur der Telegraf-Binärdatei wird durch das Installationsskript überprüft.

Prüfsummenwert überprüfen

Um den Prüfsummenwert zu generieren, führen Sie den folgenden Befehl für Ihre entsprechende Plattform aus:

  • RHEL/Ubuntu:

     sha256sum <package_name>
* Windows:
    Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List

Installieren Sie das heruntergeladene Paket

Sobald alle Artefakte zufriedenstellend überprüft wurden, kann die Agenteninstallation durch Ausführen des folgenden Befehls gestartet werden:

Nicht-Windows:

 sudo -E -H ./<installation_script_name> --install
Windows:
.\cloudinsights-windows.ps1 -install

Erstellen und Verwenden von API-Zugriffstoken

Um ein API-Zugriffstoken für die Telegraf-Datenaufnahme zu erstellen, führen Sie bitte einen der folgenden Schritte aus:

Erstellen über die Data Collector-Installationsseite

  1. Navigieren Sie zur Data Collector-Installationsseite für die Plattform, die Sie verwenden möchten (Windows, Linux).

  2. Erstellen Sie ein Token mit der Schaltfläche + API-Zugriffstoken.

  3. Geben Sie einen Namen ein und klicken Sie auf „Speichern“.

  4. Der Tokenname sollte jetzt im Dropdown-Menü ausgewählt werden und wird bei der Installation des Collectors verwendet.

Manuelles Erstellen eines API-Zugriffstokens

  1. Navigieren Sie zu Admin > API-Zugriff.

  2. Klicken Sie auf + API-Zugriffstoken.

  3. Geben Sie einen Namen und optional eine Beschreibung ein.

  4. Wählen Sie unter „Für Aufrufe welcher API-Typen wird dieses Token verwendet?“ nur „Datenaufnahme“ aus und deaktivieren Sie dann „Erfassungseinheit“.

  5. Wählen Sie unter „Berechtigungen“ Lesen/Schreiben aus.

  6. Deaktivieren Sie „Token für Kubernetes automatisch rotieren“.

Um Ihr neu erstelltes API-Zugriffstoken zu verwenden, wählen Sie es aus der Dropdown-Liste „Vorhandenes API-Zugriffstoken auswählen oder neues erstellen“ auf der Installationsseite aus. Bitte beachten Sie, dass nur Token mit den folgenden Eigenschaften verwendet werden können:

  • API-Typ: Nur „Datenaufnahme“

  • Berechtigungen: Lesen/Schreiben

  • Automatische Kubernetes-Rotation: Aus

Fehlerbehebung

Wenn beim Einrichten eines Agenten Probleme auftreten, können Sie Folgendes versuchen:

Problem: Versuchen Sie Folgendes:

Nach der Konfiguration eines neuen Plug-Ins und dem Neustart von Telegraf kann Telegraf nicht gestartet werden. Die Protokolle zeigen einen Fehler ähnlich dem folgenden an: „[telegraf] Fehler beim Ausführen des Agenten: Fehler beim Laden der Konfigurationsdatei /etc/telegraf/telegraf.d/cloudinsights-default.conf: Plugin-Ausgaben.http: Zeile <Zeilennummer>: In der Konfiguration wurden die Felder ["use_system_proxy"] angegeben, aber sie wurden nicht verwendet.“

Die installierte Telegraf-Version ist veraltet. Befolgen Sie die Schritte auf dieser Seite, um den Agenten für Ihre entsprechende Plattform zu aktualisieren.

Ich habe das Installationsskript auf einer alten Installation ausgeführt und jetzt sendet der Agent keine Daten

Deinstallieren Sie den Telegraf-Agenten und führen Sie das Installationsskript erneut aus. Befolgen Sie die Schritte zum Aktualisieren des Agenten auf dieser Seite für Ihre entsprechende Plattform.

Ich habe bereits einen Agenten mit Data Infrastructure Insights installiert

Wenn Sie bereits einen Agenten auf Ihrem Host/Ihrer VM installiert haben, müssen Sie den Agenten nicht erneut installieren. Wählen Sie in diesem Fall einfach die entsprechende Plattform und den entsprechenden Schlüssel im Bildschirm „Agent-Installation“ aus und klicken Sie auf „Weiter“ oder „Fertig stellen“.

Ich habe bereits einen Agenten installiert, aber nicht mithilfe des Data Infrastructure Insights -Installationsprogramms

Entfernen Sie den vorherigen Agenten und führen Sie die Installation des Data Infrastructure Insights Agenten aus, um die richtigen Standardeinstellungen der Konfigurationsdatei sicherzustellen. Wenn Sie fertig sind, klicken Sie auf Weiter oder Fertig.

Weitere Informationen finden Sie in der"Support" Seite oder in der"Datensammler-Supportmatrix" .