Amministrazione dell'agente dell' Instana su Docker
Dopo aver installato l'agente, configurarlo e gestirlo come necessario. Vedere le sezioni seguenti per tutte le opzioni di configurazione disponibili per l'agente su Docker.
Controllo dello stato dell'agente host
Dopo aver installato l'agente host, è possibile verificarne lo stato nell'interfaccia utente di Instana o direttamente sull'host. Per ulteriori informazioni, vedere Controllo dello stato dell'agente host.
Configurazione dell'agent
Oltre alle variabili di ambiente richieste, durante l'avvio è possibile configurare altre variabili di ambiente. Per ulteriori informazioni sulle variabili disponibili, consultare la sezione «Variabili d'ambiente per l'agente host ».
Montare i file di configurazione principali nella directory " /root ". I file vengono copiati in posizione quando il file di archivio dell'agente (.tar) viene decompresso.
Sovrascrivere la configurazione dell'agente con i supporti del volume
È possibile ignorare le impostazioni di scambio nei file di configurazione utilizzando la funzione di volume dell' Docker. Il file di configurazione dell'agente configuration.yaml fornito con l'immagine definisce i valori predefiniti e potrebbe non essere sovrascritto. È possibile estendere il file con frammenti di configurazione personalizzati denominati " configuration-<custom-extension>.yaml " come segue:
--volume <host-path>/configuration-<custom-extension>.yaml:/opt/instana/agent/etc/instana/configuration-<custom-extension>.yaml
Esempio : è possibile impostare un file di configurazione ( configuration-mysql.yaml ) per le credenziali dell' MySQL, e aggiungere questo file di configurazione all'avvio del container.
configuration-mysql.yaml
# Mysql
com.instana.plugin.mysql:
user: 'mysqlAdmin'
password: 'mysqlSecretPassword'
docker eseguire il montaggio del volume
--volume /opt/instana-agent/etc/instana/configuration-mysql.yaml:/opt/instana/agent/etc/instana/configuration-mysql.yaml
Configurazione di più backend
È possibile configurare l'agente Instana in modo che invii i rapporti a più backend. Per considerazioni generali e note sulla configurazione, consultare la sezione «Configurazione di più backend ».
Per aggiungere ulteriori backend all'agente host di Instana, montare i file dei backend, ad esempio com.instana.agent.main.sender.Backend-2.cfg.
Vedi l'argomento di esempio seguente per un agente containerizzato:
--mount type=bind,source=<path-to-additional-backend-config>,target=/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend-2.cfg
Configurazione mirror repository agente
INSTANA_SHARED_REPOSITORY_MIRROR_URLINSTANA_SHARED_REPOSITORY_MIRROR_USERNAMEINSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD
Per ulteriori informazioni sulla configurazione dei mirror del repository Maven tramite variabili d'ambiente, consultare la sezione Configurazione dei mirror del repository Maven.
Configurazione dell'agente per le impostazioni proxy
L'agente di Instana si collega a due diversi endpoint: il sistema di backend Instana per inviare tutti i dati raccolti e un repository per scaricare gli aggiornamenti dell'agente e dei sensori. È possibile configurare entrambi questi endpoint per utilizzare le impostazioni proxy. Sono disponibili i seguenti tre approcci:
Nessuna impostazione proxy per entrambi gli endpoint: nessuna configurazione richiesta per le impostazioni proxy.
Stesse impostazioni proxy sia per il backend che per il repository: configurare solo le impostazioni proxy dell'"Agente".
Impostazioni proxy diverse per backend e repository: configurare entrambi i proxy separatamente e assicurarsi di impostare
INSTANA_REPOSITORY_PROXY_ENABLED=true.Ad esempio, se è necessario configurare un proxy solo per il repository, utilizzare la seguente configurazione:
- Impostare tutte le variabili dell'
INSTANA_AGENT_PROXY_e su """" (stringa vuota). - Imposta
INSTANA_REPOSITORY_PROXY_ENABLED=true - Imposta tutte le variabili dell'
INSTANA_REPOSITORY_PROXY_e sulla configurazione proxy in base alle necessità.
- Impostare tutte le variabili dell'
Allo stesso modo, per le impostazioni proxy agente, abilitare INSTANA_AGENT_PROXY_ENABLED e impostare tutte le variabili INSTANA_AGENT_PROXY_ alla configurazione proxy secondo necessità.
Aggiornamenti e fissaggio della versione
È possibile controllare gli aggiornamenti degli agenti e le versioni dei pin necessarie utilizzando le variabili di ambiente. Per ulteriori informazioni, vedere Aggiornamenti dei controlli negli agenti containerizzati.
Personalizzazione della configurazione dell'agente
Dopo aver installato l'agente host, vengono creati i seguenti file di configurazione:
/opt/instana/agent/etc/mvn-settings.xml
/opt/instana/agent/etc/org.ops4j.pax.url.mvn.cfg
/opt/instana/agent/etc/instana/com.instana.agent.bootstrap.AgentBootstrap.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.Agent.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.UpdateManager.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend.cfg
/opt/instana/agent/etc/instana/configuration.yaml
È possibile personalizzare la configurazione dell'agente in base alle proprie esigenze. Ad esempio, è possibile modificare la porta e il nome host di TCP del backend Instana e dei servizi a cui si connette l'agente host, configurare l'agente in modo che invii i rapporti a più backend oppure configurare un proxy per la comunicazione indiretta dall'agente host al backend Instana.
Per ulteriori informazioni sulla personalizzazione della configurazione dell'agente, consultare i seguenti argomenti:
- Registrazione agente
- Configurazione del backend di Instana
- Configurazione della modalità agente host
- Configurazione degli agenti host tramite il file di configurazione dell'agente
- Conversione di un agente statico in un agente dinamico
- Limitare la CPU e la memoria dell'host agent
- Recupero della versione corrente degli agenti dinamici
- Impostazione di un proxy agente
- Configurazione della crittografi TLS e per l'endpoint dell'agente
- Intervallo di aggiornamento degli agenti dinamici
- Fissaggio della versione degli agenti dinamici
Avvio e arresto dell'agent
Avvio dell'agent
Quando si installa l'host agent, questo viene abilitato per l'avvio automatico all'avvio del sistema. È possibile disattivare questo comportamento impostando la variabile d'ambiente INSTANA_AGENT_AUTOSTART=false quando si installa l'agente.
Per avviare l'agente host, eseguire il seguente comando:
INSTANA_AGENT_FOLDER/bin/startSe il sistema operativo utilizza
systemdcome sistema di inizializzazione, eseguire il seguente comando:systemctl start instana-agent.serviceSe il sistema operativo utilizza
SysVinitcome sistema di inizializzazione, eseguire il seguente comando:service instana-agent start
Arresto dell'agent
Per fermare l'agente, eseguire il seguente comando:
INSTANA_AGENT_FOLDER/bin/stop
Gestione degli agenti tramite il pannello di controllo Gestione agenti
È possibile eseguire le seguenti operazioni utilizzando la dashboard Gestione agenti nell'interfaccia utente di Instana :
- Modifica delle modalità dell'agente
- Modifica del livello del registro
- Aggiornamento agenti
- Agenti di ripristino
- Agenti di riavvio
- Sensori di visualizzazione
- Gestione delle configurazioni
- Auto-monitoraggio
Per aprire il pannello di controllo Gestione agenti, procedere come segue:
- Nella barra laterale dell'interfaccia utente di Instana, seleziona "Infrastruttura".
- Fare clic su un host monitorato specifico.
- Sul dashboard host, fare clic su Apri Gestione agenti.
Abilitazione del monitoraggio GPU
Sono supportate le seguenti schede grafiche Nvidia.
| Marchio | Modello |
|---|---|
| Tesla | S1070, S2050, C1060, C2050/70, M2050/70/90, X2070/90, K10, K20, K20X, K40, K80, M40, P40, P100, V100 |
| Quadro | 4000, 5000, 6000, 7000, M2070-Q, serie K, serie M, serie P, serie RTX |
| GeForce | livelli di supporto variabili, con meno parametri disponibili rispetto ai prodotti Tesla e Quadro |
Prerequisiti
Il monitoraggio della GPU richiede un sistema operativo Linux.
Assicurati inoltre di installare i seguenti programmi:
- Docker versione 19.03 o successiva.
- Gli ultimi driver ufficiali Nvidia. I driver installati tramite i gestori di pacchetti non sono sufficienti.
- NVIDIA Kit di attrezzi per container.
Per abilitare il monitoraggio della GPU, avvia il container dell'agente Instana su una o più GPU. L'agente può essere avviato come contenitore privilegiato.
L'agente raccoglie le metriche per tutte le GPU disponibili a livello di sistema che sono supportate indipendentemente dal numero di GPU su cui l'agente è in esecuzione.
Per un elenco dettagliato delle metriche raccolte, consulta la nostra documentazione sulla GPU.
Esistono diversi modi per avviare il container dell'agente utilizzando le GPU:
- Per avviare tutte le GPU disponibili, fornire il flag
--gpus all. - Per avviare il numero esatto di GPU, fornire il flag
--gpus <number of gpus to use>. - Per avviare le GPU desiderate, fornire il flag
--gpus '"device=<gpu1-uuid>,<gpu2-uuid>"'.