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.

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

Per utilizzare un proprio mirror del repository dell'agente dinamico Maven (ad esempio, in ambienti isolati), configurare l'agente dinamico containerizzato utilizzando le seguenti variabili d'ambiente:
  • INSTANA_SHARED_REPOSITORY_MIRROR_URL
  • INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME
  • INSTANA_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:

  1. Nessuna impostazione proxy per entrambi gli endpoint: nessuna configurazione richiesta per le impostazioni proxy.

  2. Stesse impostazioni proxy sia per il backend che per il repository: configurare solo le impostazioni proxy dell'"Agente".

  3. 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à.

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à.

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:

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/start
    
  • Se il sistema operativo utilizza systemd come sistema di inizializzazione, eseguire il seguente comando:

    systemctl start instana-agent.service
    
  • Se il sistema operativo utilizza SysVinit come 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 :

Per aprire il pannello di controllo Gestione agenti, procedere come segue:

  1. Nella barra laterale dell'interfaccia utente di Instana, seleziona "Infrastruttura".
  2. Fare clic su un host monitorato specifico.
  3. 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>"' .