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 zur Datenerfassung (Windows/Linux)

Beitragende
PDFs

Data Infrastructure Insights verwendet "Telegraf" als Agent für die Erfassung von Integrationsdaten. Telegraf ist ein Plug-in-gestützter Server-Agent, mit dem Kennzahlen, Ereignisse und Protokolle erfasst und protokolliert werden können. Input-Plugins werden verwendet, um die gewünschten Informationen in den Agenten zu sammeln, indem Sie direkt auf das System/Betriebssystem zugreifen, indem Sie APIs von Drittanbietern aufrufen oder konfigurierte Streams (d. h. anhören Kafka, StatsD usw.). Output-Plug-ins werden verwendet, um die vom Agenten gesammelten Kennzahlen, Ereignisse und Protokolle an Data Infrastructure Insights zu senden.

Die aktuelle Telegraf Version für Data Infrastructure Insights ist 1.24.0.

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

Hinweis Für eine genaue Audit- und Datenberichterstattung wird dringend empfohlen, die Zeit auf dem Agent-Rechner mit Network Time Protocol (NTP) oder Simple Network Time Protocol (SNTP) zu synchronisieren.
Hinweis Wenn Sie die Installationsdateien vor dem Instaling des Agenten überprüfen möchten, lesen Sie den Abschnitt unten auf Prüfsummen Werden Überprüft.

Installieren eines Agenten

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

Um einen Agent zu installieren, müssen Sie, unabhängig von der verwendeten Plattform, zunächst die folgenden Schritte ausführen:

  1. Melden Sie sich beim Host an, den Sie für Ihren Agenten verwenden werden.

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

  3. Klicken Sie auf +Data Collector 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 Sobald Sie einen Agent auf einem Host installiert haben, müssen Sie auf diesem Host keinen Agenten mehr installieren.
Tipp Sobald Sie einen Agenten auf einem Server/einer VM installiert haben, erfasst Data Infrastructure Insights neben der Erfassung von Daten aus dem System auch Kennzahlen aus dem System. Diese Kennzahlen werden als gesammelt"Node-Metriken".
Hinweis Wenn Sie einen Proxy verwenden, lesen Sie die Proxy-Anweisungen für Ihre Plattform, bevor Sie den Telegraf-Agent installieren.

Speicherorte Protokollieren

Telegraf-Protokollmeldungen werden von stdout zu den folgenden Standardprotokolldateien 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.

Proxy-Unterstützung für Windows wird konfiguriert

Hinweis Wenn in Ihrer Umgebung ein Proxy verwendet wird, lesen Sie diesen Abschnitt vor der Installation.
Hinweis In den folgenden Schritten werden die Aktionen beschrieben, die zum Festlegen der Umgebungsvariablen http_Proxy/HTTPS_Proxy erforderlich sind. In einigen Proxyumgebungen müssen Benutzer möglicherweise auch die Variable no_Proxy-Umgebung einstellen.

Führen Sie für Systeme, die sich hinter einem Proxy befinden, folgende Schritte aus, um die Umgebungsvariable 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 zur Installation von Agent unter Windows:

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

  2. Kopieren Sie den Befehlsblock aus dem Agent-Installationsdialog. Sie können auf das Clipboard-Symbol 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. Nach Abschluss des Vorgangs wird der Agent-Service neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden lang gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nach der Installation des Agent können Sie den Dienst mit den folgenden Befehlen starten/stoppen:

Start-Service telegraf
Stop-Service telegraf

Deinstallieren des Agenten

Gehen Sie zum Deinstallieren des Agent unter Windows in einem PowerShell-Fenster wie folgt vor:

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

    Stop-Service telegraf
sc.exe delete telegraf

  2. Entfernen Sie das Zertifikat aus dem trustore:

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

  3. Löschen Sie den Ordner C:\Programme\telegraf, um die Binärdateien, Protokolle 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-Agent 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 C:\Programme\telegraf\telegraf.conf

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

  5. "Installieren Sie den neuen Agenten".

RHEL und CentOS

Voraussetzungen:

  • Folgende 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* befolgen.

Proxy-Unterstützung für RHEL/CentOS wird konfiguriert

Hinweis Wenn in Ihrer Umgebung ein Proxy verwendet wird, lesen Sie diesen Abschnitt vor der Installation.
Hinweis In den folgenden Schritten werden die Aktionen beschrieben, die zum Festlegen der Umgebungsvariablen http_Proxy/HTTPS_Proxy erforderlich sind. In einigen Proxyumgebungen müssen Benutzer möglicherweise auch die Variable no_Proxy-Umgebung einstellen.

Führen Sie für Systeme, die sich hinter einem Proxy befinden, die folgenden Schritte vor der Installation des Telegraf-Agenten durch:

  1. Legen Sie die Umgebungsvariable https_Proxy und/oder http_Proxy für den aktuellen Benutzer fest:

     export https_proxy=<proxy_server>:<proxy_port>
. _/etc/default/telegraf_ erstellen und Definitionen für die Variable(en) _https_Proxy_ und/oder _http_Proxy_ einfügen:
    https_proxy=<proxy_server>:<proxy_port>

Installieren des Agenten

RHEL/CentOS Agent Installation

Schritte zum Installieren von Agent auf RHEL/CentOS:

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

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

  3. Öffnen Sie ein Fenster „Bash“

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

  5. Der Befehl lädt das entsprechende Agent-Installationsprogramm herunter, installiert es und legt eine Standardkonfiguration fest. Nach Abschluss des Vorgangs wird der Agent-Service neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden lang gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nach der Installation des Agent können Sie den Dienst mit den folgenden Befehlen starten/stoppen:

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

sudo systemctl start telegraf
sudo systemctl stop telegraf

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

sudo service telegraf start
sudo service telegraf stop

Deinstallieren des Agenten

Gehen Sie zum Deinstallieren des Agent auf RHEL/CentOS in einem Bash Terminal wie folgt vor:

  1. Stoppen Sie den Telegraf-Service:

    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-Agent:

     yum remove telegraf
. Entfernen Sie alle Konfigurations- oder Protokolldateien, die zurückgelassen werden können:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aktualisieren des Agenten

Um den telegraf-Agent zu aktualisieren, gehen Sie wie folgt vor:

  1. Stoppen sie den telegraf-Service:

    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-Agent:

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

Ubuntu und Debian

Voraussetzungen:

  • Folgende 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* befolgen.

Proxy-Unterstützung für Ubuntu/Debian konfigurieren

Hinweis Wenn in Ihrer Umgebung ein Proxy verwendet wird, lesen Sie diesen Abschnitt vor der Installation.
Hinweis In den folgenden Schritten werden die Aktionen beschrieben, die zum Festlegen der Umgebungsvariablen http_Proxy/HTTPS_Proxy erforderlich sind. In einigen Proxyumgebungen müssen Benutzer möglicherweise auch die Variable no_Proxy-Umgebung einstellen.

Führen Sie für Systeme, die sich hinter einem Proxy befinden, die folgenden Schritte vor der Installation des Telegraf-Agenten durch:

  1. Legen Sie die Umgebungsvariable 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(en) _https_Proxy_ und/oder _http_Proxy_ ein:
    https_proxy=<proxy_server>:<proxy_port>

Installieren des Agenten

Ubuntu/Debian Agent Install

Schritte zur Installation von Agent auf Debian oder Ubuntu:

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

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

  3. Öffnen Sie ein Fenster „Bash“

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

  5. Der Befehl lädt das entsprechende Agent-Installationsprogramm herunter, installiert es und legt eine Standardkonfiguration fest. Nach Abschluss des Vorgangs wird der Agent-Service neu gestartet. Der Befehl hat einen eindeutigen Schlüssel und ist 24 Stunden lang gültig.

  6. Klicken Sie auf Fertig oder Weiter

Nach der Installation des Agent 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 keine systemd verwendet:

sudo service telegraf start
sudo service telegraf stop

Deinstallieren des Agenten

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

  1. Stoppen Sie den Telegraf-Service:

    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-Agent:

     dpkg -r telegraf
. Entfernen Sie alle Konfigurations- oder Protokolldateien, die zurückgelassen werden können:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aktualisieren des Agenten

Um den telegraf-Agent zu aktualisieren, gehen Sie wie folgt vor:

  1. Stoppen sie den telegraf-Service:

    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-Agent:

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

Prüfsummen Werden Überprüft

Das Installationsprogramm von Data Infrastructure Insights Agent führt Integritätsprüfungen durch, einige Benutzer möchten jedoch möglicherweise ihre eigenen Überprüfungen durchführen, bevor heruntergeladene Artefakte installiert oder angewendet werden. Dazu können Sie das Installationsprogramm herunterladen und eine Prüfsumme für das heruntergeladene Paket erstellen. Anschließend wird die Prüfsumme mit dem in der Installationsanleitung angegebenen Wert verglichen.

Laden Sie das Installationspaket herunter, ohne es zu installieren

Um einen ausschließlich herunterladbaren Vorgang durchzuführen (im Gegensatz zum Standard-Download-and-install), können Benutzer den Agent-Installationbefehl von der UI erhalten bearbeiten und die nachgestellte Option „install“ entfernen.

Führen Sie hierzu folgende Schritte aus:

  1. Kopieren Sie das Agent Installer-Snippet wie angewiesen.

  2. Anstatt das Snippet in ein Befehlsfenster einzufügen, fügen Sie es in einen Texteditor ein.

  3. Entfernen Sie die nachstehende „--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 ein (in einem Arbeitsverzeichnis) und führen Sie es aus.

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

  • Download und Installation (Standard):

     installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download –-install
* Nur Download:
    installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download

Windows:

  • Download und Installation (Standard):

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download -install)
* Nur Download:
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download)

Mit dem Befehl „nur herunterladen“ werden alle erforderlichen Artefakte aus Data Infrastructure Insights in das Arbeitsverzeichnis heruntergeladen. Die Artefakte umfassen, dürfen aber nicht beschränkt sein auf:

  • Ein Installationsskript

  • Einer Umgebungsdatei

  • YAML-Dateien

  • Eine Prüfsummendatei (endet mit sha256.signed oder sha256.ps1)

Das Installationsskript, die Umgebungsdatei und die YAML-Dateien können mittels Sichtprüfung verifiziert werden.

Prüfsummenwert generieren

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

  • RHEL/Ubuntu:

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

Überprüfen Sie die Prüfsumme

Extrahieren Sie die erwartete Prüfsumme aus der Prüfsummendatei

  • Nicht Windows:

     openssl smime -verify -in telegraf*.sha256.signed -CAfile netapp_cert.pem -purpose any -nosigs -noverify
* Windows:
    (Get-Content telegraf.zip.sha256.ps1 -First 1).toUpper()

Installieren Sie das heruntergeladene Paket

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

Nicht Windows:

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

Fehlerbehebung

Einige Dinge, die Sie versuchen können, wenn Probleme beim Einrichten eines Agenten auftreten:

Problem: Versuchen Sie dies:

Nach der Konfiguration eines neuen Plugins und dem Neustart von Telegraf startet Telegraf Telegraf nicht. Die Protokolle zeigen an, dass ein Fehler wie folgt auftritt: "[telegraf] Fehler laufende Agent: Fehler beim Laden der Konfigurationsdatei /etc/telegraf/telegraf.d/cloudinsights-default.conf: Plugin Outputs.http: Line <linenumber>: Configuration specified the fields ["use_System_Proxy"], they were't used"

Die installierte Telegraf-Version ist veraltet. Befolgen Sie die Schritte auf dieser Seite, um Upgrade the Agent für Ihre entsprechende Plattform.

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

Deinstallieren Sie den telegraf-Agent und führen Sie dann das Installationsskript erneut aus. Folgen Sie den Schritten Upgrade the Agent auf dieser Seite für Ihre entsprechende Plattform.

Ich habe bereits einen Agenten installiert, der Data Infrastructure Insights verwendet

Wenn Sie bereits einen Agent auf Ihrem Host/VM installiert haben, müssen Sie den Agent nicht erneut installieren. Wählen Sie in diesem Fall im Bildschirm Agenteninstallation einfach die entsprechende Plattform und die entsprechende Taste aus und klicken Sie auf Weiter oder Fertig.

Ich habe bereits einen Agenten installiert, aber nicht mit dem Data Infrastructure Insights Installer

Entfernen Sie den vorherigen Agent, und führen Sie die Installation von Data Infrastructure Insights Agent aus, um sicherzustellen, dass die Standardeinstellungen für die Konfigurationsdatei korrekt sind. Klicken Sie nach Abschluss auf Weiter oder Fertig.

Weitere Informationen finden Sie auf der "Support" Seite oder im "Data Collector Supportmatrix".