Aggiornare gli agenti di inserimento di Azure Operator Insights

L'agente di inserimento è un pacchetto software installato in una macchina virtuale Linux di proprietà e gestita dall'utente. Potrebbe essere necessario aggiornare l'agente.

Questo articolo descrive come aggiornare l'agente di inserimento e come eseguire il rollback di un aggiornamento.

Prerequisiti

Decidere la versione dell'agente di inserimento a cui si vuole eseguire l'aggiornamento. Se non si specifica una versione quando si esegue l'aggiornamento, si eseguirà l'aggiornamento alla versione più recente.

Per un elenco delle versioni recenti, vedere Novità dell'agente di inserimento di Azure Operator Insights e informazioni sulle modifiche apportate in ogni versione. Se stai cercando una versione dell'agente che ha più di sei mesi, consulta l'archivio delle note sulla versione.

Per verificare l'autenticità del pacchetto dell'agente di inserimento prima dell'aggiornamento, vedere Come usare la chiave di firma del repository GpG.

Aggiornare il software dell'agente

Per eseguire l'aggiornamento a una nuova versione dell'agente, ripetere i passaggi seguenti in ogni macchina virtuale con l'agente precedente.

1. Connessione alla macchina virtuale tramite SSH.
2. Salvare una copia del file di configurazione /etc/az-aoi-ingestion/config.yaml esistente.
3. Aggiornare l'agente usando la gestione pacchetti della macchina virtuale. Ad esempio, per le distribuzioni Linux basate su Red Hat:

   sudo dnf upgrade az-aoi-ingestion
   

   Risposta y quando richiesto.
   1. In alternativa, per eseguire l'aggiornamento a una versione specifica dell'agente, specificare il numero di versione nel comando. Ad esempio, per la versione 2.0.0 in un sistema RHEL8, usare il comando seguente:

   sudo dnf install az-aoi-ingestion-2.0.0
   

4. Apportare modifiche al file di configurazione descritto dal contatto del supporto tecnico o dalla documentazione per la nuova versione. La maggior parte degli aggiornamenti non richiede modifiche alla configurazione.
5. Riavviare l'agente.

   sudo systemctl restart az-aoi-ingestion.service
   

6. Dopo aver eseguito l'agente, configurare il servizio az-aoi-ingestion per l'avvio automatico in un riavvio.

   sudo systemctl enable az-aoi-ingestion.service
   

7. Verificare che l'agente sia in esecuzione e che stia copiando i file come descritto in Monitorare e risolvere i problemi relativi agli agenti di inserimento per Informazioni dettagliate sugli operatori di Azure.

Eseguire il rollback di un aggiornamento

Se una modifica di aggiornamento o configurazione non riesce:

1. Eseguire il downgrade alla versione precedente reinstallando la versione precedente dell'agente. Ad esempio, per effettuare il downgrade alla versione 1.0.0 in un sistema RHEL8, usare il comando seguente:

   sudo dnf downgrade az-aoi-ingestion-1.0.0
   

2. Copiare il file di configurazione di cui è stato eseguito il backup prima della modifica nel file /etc/az-aoi-ingestion/config.yaml .
3. Riavviare l'agente.

   sudo systemctl restart az-aoi-ingestion.service
   

4. Quando l'agente è in esecuzione, configurare il servizio az-aoi-ingestion per l'avvio automatico in un riavvio.

   sudo systemctl enable az-aoi-ingestion.service
   

Contenuto correlato

Scopri come:

• Monitorare e risolvere i problemi degli agenti di inserimento.
• Modificare la configurazione per gli agenti di inserimento.
• Ruotare i segreti per gli agenti di inserimento.