Skip to main content
Data Infrastructure Insights
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Configurazione di un agente per la raccolta di dati (Windows/Linux)

Collaboratori netapp-alavoie dgracenetapp netapp-mjryan
PDF

Gli utilizzi di Data Infrastructure Insights"Telegrafo" come suo agente per la raccolta dei dati di integrazione. Telegraf è un agente server basato su plugin che può essere utilizzato per raccogliere e segnalare metriche, eventi e registri. I plugin di input vengono utilizzati per raccogliere le informazioni desiderate nell'agente accedendo direttamente al sistema/sistema operativo, chiamando API di terze parti o ascoltando flussi configurati (ad esempio Kafka, statsD, ecc.). I plugin di output vengono utilizzati per inviare le metriche, gli eventi e i log raccolti dall'agente a Data Infrastructure Insights.

Per informazioni sull'installazione su Kubernetes, vedere"Operatore di monitoraggio NetApp Kubernetes" pagina.

Nota Per un audit e una segnalazione dei dati accurati, si consiglia vivamente di sincronizzare l'ora sulla macchina dell'agente utilizzando Network Time Protocol (NTP) o Simple Network Time Protocol (SNTP).
Nota Se si desidera verificare i file di installazione prima di installare l'agente, vedere la sezione seguente suVerifica dei checksum del pacchetto Telegraf .

Installazione di un agente

Se si sta installando un Service Data Collector e non è ancora stato configurato un Agent, verrà richiesto di installare prima un Agent per il sistema operativo appropriato. In questo argomento vengono fornite istruzioni per l'installazione dell'agente Telegraf sui seguenti sistemi operativi:

Per installare un agente, indipendentemente dalla piattaforma utilizzata, è necessario innanzitutto effettuare le seguenti operazioni:

  1. Accedi all'host che utilizzerai per il tuo agente.

  2. Accedi al tuo ambiente Data Infrastructure Insights e vai su Osservabilità > Collettori.

  3. Fare clic su +Data Collector e scegliere un data collector da installare.

  4. Scegli la piattaforma appropriata per il tuo host (Windows, Linux)

  5. Seguire i passaggi rimanenti per ciascuna piattaforma.

Nota Una volta installato un agente su un host, non è necessario installarlo nuovamente sullo stesso host.
Suggerimento Dopo aver installato un agente su un server/VM, Data Infrastructure Insights raccoglie le metriche da quel sistema, oltre a raccoglierle da tutti i collettori dati configurati. Queste metriche vengono raccolte come"Metriche "Nodo"" .
Nota Se si utilizza un proxy, leggere le istruzioni del proxy per la propria piattaforma prima di installare l'agente Telegraf.

Posizioni dei registri

Per impostazione predefinita, i messaggi di registro di Telegraf vengono reindirizzati da stdout ai seguenti file di registro:

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

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

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

Finestre

Prerequisiti:

  • PowerShell deve essere installato

  • Se si utilizza un proxy, è necessario seguire le istruzioni nella sezione Configurazione del supporto proxy per Windows.

Configurazione del supporto proxy per Windows

Nota Se il tuo ambiente utilizza un proxy, leggi questa sezione prima di procedere all'installazione.
Nota I passaggi seguenti descrivono le azioni necessarie per impostare le variabili di ambiente http_proxy/https_proxy. Per alcuni ambienti proxy, gli utenti potrebbero dover impostare anche la variabile di ambiente no_proxy.

Per i sistemi che risiedono dietro un proxy, procedere come segue per impostare le variabili di ambiente https_proxy e/o http_proxy PRIMA di installare l'agente Telegraf:

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

Installazione dell'agente

Installazione dell'agente Windows

Passaggi per installare l'agente su Windows:

  1. Scegli una chiave di accesso agente.

  2. Copiare il blocco di comando dalla finestra di dialogo di installazione dell'agente. È possibile fare clic sull'icona degli appunti per copiare rapidamente il comando negli appunti.

  3. Aprire una finestra di PowerShell

  4. Incollare il comando nella finestra di PowerShell e premere Invio.

  5. Il comando scaricherà il programma di installazione dell'agente appropriato, lo installerà e imposterà una configurazione predefinita. Al termine, il servizio agente verrà riavviato. Il comando ha una chiave univoca ed è valido per 24 ore.

  6. Fare clic su Fine o Continua

Dopo aver installato l'agente, è possibile utilizzare i seguenti comandi per avviare/arrestare il servizio:

Start-Service telegraf
Stop-Service telegraf

Disinstallazione dell'agente

Per disinstallare l'agente su Windows, procedere come segue in una finestra di PowerShell:

  1. Arrestare ed eliminare il servizio Telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Rimuovere il certificato dal trustore:

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

  3. Eliminare la cartella C:\Programmi\telegraf per rimuovere i file binari, di registro e di configurazione

  4. Rimuovere la chiave SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf dal registro

Aggiornamento dell'agente

Per aggiornare l'agente Telegraf, procedere come segue:

  1. Arrestare ed eliminare il servizio Telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Eliminare la chiave SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf dal registro

  3. Elimina C:\Programmi\telegraf\telegraf.conf

  4. Elimina C:\Programmi\telegraf\telegraf.exe

  5. "Installa il nuovo agente" .

RHEL e CentOS

Prerequisiti:

  • Devono essere disponibili i seguenti comandi: curl, sudo, ping, sha256sum, openssl e dmidecode

  • Se si utilizza un proxy, è necessario seguire le istruzioni nella sezione Configurazione del supporto proxy per RHEL/CentOS.

Configurazione del supporto proxy per RHEL/CentOS

Nota Se il tuo ambiente utilizza un proxy, leggi questa sezione prima di procedere all'installazione.
Nota I passaggi seguenti descrivono le azioni necessarie per impostare le variabili di ambiente http_proxy/https_proxy. Per alcuni ambienti proxy, gli utenti potrebbero dover impostare anche la variabile di ambiente no_proxy.

Per i sistemi che risiedono dietro un proxy, eseguire i seguenti passaggi PRIMA di installare l'agente Telegraf:

  1. Imposta le variabili di ambiente https_proxy e/o http_proxy per l'utente corrente:

     export https_proxy=<proxy_server>:<proxy_port>
. Crea _/etc/default/telegraf_ e inserisci le definizioni per le variabili _https_proxy_ e/o _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Installazione dell'agente

Installazione dell'agente Rhel/CentOS

Passaggi per installare l'agente su RHEL/CentOS:

  1. Scegli una chiave di accesso agente.

  2. Copiare il blocco di comando dalla finestra di dialogo di installazione dell'agente. È possibile fare clic sull'icona degli appunti per copiare rapidamente il comando negli appunti.

  3. Aprire una finestra Bash

  4. Incolla il comando nella finestra Bash e premi Invio.

  5. Il comando scaricherà il programma di installazione dell'agente appropriato, lo installerà e imposterà una configurazione predefinita. Al termine, il servizio agente verrà riavviato. Il comando ha una chiave univoca ed è valido per 24 ore.

  6. Fare clic su Fine o Continua

Dopo aver installato l'agente, è possibile utilizzare i seguenti comandi per avviare/arrestare il servizio:

Se il tuo sistema operativo utilizza systemd (CentOS 7+ e RHEL 7+):

sudo systemctl start telegraf
sudo systemctl stop telegraf

Se il tuo sistema operativo non utilizza systemd (CentOS 7+ e RHEL 7+):

sudo service telegraf start
sudo service telegraf stop

Disinstallazione dell'agente

Per disinstallare l'agente su RHEL/CentOS, in un terminale Bash, procedere come segue:

  1. Interrompere il servizio Telegraf:

    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. Rimuovere l'agente Telegraf:

     yum remove telegraf
. Rimuovere eventuali file di configurazione o di registro rimasti:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aggiornamento dell'agente

Per aggiornare l'agente Telegraf, procedere come segue:

  1. Interrompere il servizio telegrafico:

    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. Rimuovere il precedente agente telegrafico:

     yum remove telegraf
. link:#rhel-and-centos["Installa il nuovo agente"] .

Ubuntu e Debian

Prerequisiti:

  • Devono essere disponibili i seguenti comandi: curl, sudo, ping, sha256sum, openssl e dmidecode

  • Se si utilizza un proxy, è necessario seguire le istruzioni nella sezione Configurazione del supporto proxy per Ubuntu/Debian.

Configurazione del supporto proxy per Ubuntu/Debian

Nota Se il tuo ambiente utilizza un proxy, leggi questa sezione prima di procedere all'installazione.
Nota I passaggi seguenti descrivono le azioni necessarie per impostare le variabili di ambiente http_proxy/https_proxy. Per alcuni ambienti proxy, gli utenti potrebbero dover impostare anche la variabile di ambiente no_proxy.

Per i sistemi che risiedono dietro un proxy, eseguire i seguenti passaggi PRIMA di installare l'agente Telegraf:

  1. Imposta le variabili di ambiente https_proxy e/o http_proxy per l'utente corrente:

     export https_proxy=<proxy_server>:<proxy_port>
. Crea /etc/default/telegraf e inserisci le definizioni per le variabili _https_proxy_ e/o _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Installazione dell'agente

Installazione dell'agente Ubuntu/Debian

Passaggi per installare l'agente su Debian o Ubuntu:

  1. Scegli una chiave di accesso agente.

  2. Copiare il blocco di comando dalla finestra di dialogo di installazione dell'agente. È possibile fare clic sull'icona degli appunti per copiare rapidamente il comando negli appunti.

  3. Aprire una finestra Bash

  4. Incolla il comando nella finestra Bash e premi Invio.

  5. Il comando scaricherà il programma di installazione dell'agente appropriato, lo installerà e imposterà una configurazione predefinita. Al termine, il servizio agente verrà riavviato. Il comando ha una chiave univoca ed è valido per 24 ore.

  6. Fare clic su Fine o Continua

Dopo aver installato l'agente, è possibile utilizzare i seguenti comandi per avviare/arrestare il servizio:

Se il tuo sistema operativo utilizza systemd:

sudo systemctl start telegraf
sudo systemctl stop telegraf

Se il tuo sistema operativo non utilizza systemd:

sudo service telegraf start
sudo service telegraf stop

Disinstallazione dell'agente

Per disinstallare l'agente su Ubuntu/Debian, in un terminale Bash, eseguire quanto segue:

  1. Interrompere il servizio Telegraf:

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

  2. Rimuovere l'agente Telegraf:

     dpkg -r telegraf
. Rimuovere eventuali file di configurazione o di registro rimasti:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Aggiornamento dell'agente

Per aggiornare l'agente Telegraf, procedere come segue:

  1. Interrompere il servizio telegrafico:

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

  2. Rimuovere il precedente agente telegrafico:

     dpkg -r telegraf
. link:#ubuntu-and-debian["Installa il nuovo agente"] .

Verifica dei checksum del pacchetto Telegraf

Il programma di installazione dell'agente Data Infrastructure Insights esegue controlli di integrità, ma alcuni utenti potrebbero voler eseguire le proprie verifiche prima di installare il binario Telegraf scaricato. Ciò può essere fatto scaricando il programma di installazione e generando un checksum per il pacchetto scaricato, quindi confrontando il checksum con il valore mostrato nelle istruzioni di installazione.

Scarica il pacchetto di installazione senza installare

Per eseguire un'operazione di solo download (in contrapposizione al download e installazione predefinito), gli utenti possono modificare il comando di installazione dell'agente ottenuto dall'interfaccia utente e rimuovere l'opzione "installa".

Segui questi passaggi:

  1. Copiare lo snippet di Agent Installer come indicato.

  2. Invece di incollare il frammento in una finestra di comando, incollalo in un editor di testo.

  3. Rimuovere la parte finale “--install” (Linux) o “-install” (Windows) dal comando.

  4. Copia l'intero comando dall'editor di testo.

  5. Ora incollalo nella finestra dei comandi (in una directory di lavoro) ed eseguilo.

Non Windows (questi esempi sono per Kubernetes; i nomi effettivi degli script possono variare):

  • Scarica e installa (predefinito):

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

Finestre:

  • Scarica e installa (predefinito):

     !$($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"})"
* Solo download:
    !$($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"})"

Il comando di solo download scaricherà tutti gli artefatti richiesti da Data Infrastructure Insights nella directory di lavoro. Gli artefatti includono, ma non sono limitati a:

  • uno script di installazione

  • un file di ambiente

  • un binario Telegraf

  • una firma per il binario Telegraf

  • un certificato pubblico per verificare la firma binaria

Il frammento di installazione scaricato e copiato da DII esegue automaticamente il checksum dello script di installazione e la firma del binario Telegraf viene verificata dallo script di installazione.

Verifica il valore del checksum

Per generare il valore di checksum, eseguire il seguente comando per la piattaforma appropriata:

  • RHEL/Ubuntu:

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

Installa il pacchetto scaricato

Una volta verificati in modo soddisfacente tutti gli artefatti, è possibile avviare l'installazione dell'agente eseguendo:

Non Windows:

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

Creazione e utilizzo di token di accesso API

Per creare un token di accesso API per l'acquisizione dati Telegraf, procedere in uno dei seguenti modi:

Crea tramite la pagina di installazione di Data Collector

  1. Vai alla pagina di installazione di Data Collector per la piattaforma che desideri utilizzare (Windows, Linux).

  2. Crea un token con il pulsante + Token di accesso API.

  3. Inserisci un nome e clicca su Salva.

  4. Ora il nome del token dovrebbe essere selezionato nel menu a discesa e verrà utilizzato durante l'installazione del raccoglitore.

Crea manualmente un token di accesso API

  1. Vai su Amministrazione>Accesso API.

  2. Fai clic su + Token di accesso API.

  3. Inserisci un nome e, facoltativamente, una descrizione.

  4. In "Quali tipi di API verranno chiamate con questo token?" seleziona solo "Ingestione dati" e poi deseleziona "Unità di acquisizione".

  5. In “Autorizzazioni” seleziona Lettura/Scrittura.

  6. Deseleziona "Ruota automaticamente i token per Kubernetes".

Per utilizzare il token di accesso API appena creato, selezionalo dal menu a discesa "Seleziona un token di accesso API esistente o creane uno nuovo" nella pagina di installazione. Si prega di notare che possono essere utilizzati solo token con le seguenti proprietà:

  • Tipo API: solo "Ingestione dati"

  • Permessi: lettura/scrittura

  • Rotazione automatica di Kubernetes: disattivata

Risoluzione dei problemi

Ecco alcune cose da provare se riscontri problemi durante la configurazione di un agente:

Problema: Prova questo:

Dopo aver configurato un nuovo plugin e riavviato Telegraf, quest'ultimo non si avvia. I log indicano un errore simile al seguente: "[telegraf] Errore durante l'esecuzione dell'agente: Errore nel caricamento del file di configurazione /etc/telegraf/telegraf.d/cloudinsights-default.conf: output del plugin.http: riga <numero di riga>: la configurazione ha specificato i campi ["use_system_proxy"], ma non sono stati utilizzati"

La versione di Telegraf installata è obsoleta. Segui i passaggi indicati in questa pagina per aggiornare l'agente per la piattaforma appropriata.

Ho eseguito lo script di installazione su una vecchia installazione e ora l'agente non invia dati

Disinstallare l'agente Telegraf e quindi eseguire nuovamente lo script di installazione. Segui i passaggi Aggiorna l'agente indicati in questa pagina per la piattaforma appropriata.

Ho già installato un agente utilizzando Data Infrastructure Insights

Se hai già installato un agente sul tuo host/VM, non è necessario installarlo di nuovo. In questo caso, è sufficiente selezionare la piattaforma e la chiave appropriate nella schermata di installazione dell'agente e fare clic su Continua o Fine.

Ho già installato un agente, ma non tramite il programma di installazione Data Infrastructure Insights

Rimuovere l'agente precedente ed eseguire l'installazione di Data Infrastructure Insights Agent per garantire le corrette impostazioni predefinite del file di configurazione. Al termine, fare clic su Continua o Fine.

Ulteriori informazioni possono essere trovate presso"Supporto" pagina o nella"Matrice di supporto del raccoglitore dati" .