Uppgradera Azure Operator Insights-inmatningsagenter

  • Artikel

Inmatningsagenten är ett programvarupaket som installeras på en virtuell Linux-dator (VM) som ägs och hanteras av dig. Du kan behöva uppgradera agenten.

Den här artikeln beskriver hur du uppgraderar inmatningsagenten och hur du återställer en uppgradering.

Förutsättningar

Bestäm vilken version av inmatningsagenten du vill uppgradera till. Om du inte anger någon version när du uppgraderar uppgraderar du till den senaste versionen.

Se Nyheter med Azure Operator Insights-inmatningsagenten för en lista över de senaste versionerna och se vad som har ändrats i varje version. Om du letar efter en agentversion som är mer än sex månader gammal kan du läsa arkivet med viktig information.

Om du vill verifiera autenticiteten för inmatningsagentpaketet innan du uppgraderar kan du läsa Så här använder du gpg-lagringsplatsens signeringsnyckel.

Uppgradera agentprogramvaran

Om du vill uppgradera till en ny version av agenten upprepar du följande steg på varje virtuell dator som har den gamla agenten.

  1. Anslut till den virtuella datorn via SSH.
  2. Spara en kopia av den befintliga konfigurationsfilen /etc/az-aoi-ingestion/config.yaml .
  3. Uppgradera agenten med hjälp av den virtuella datorns pakethanterare. Till exempel för Red Hat-baserade Linux-distributioner: 
    sudo dnf upgrade az-aoi-ingestion
    Svara y när du uppmanas att göra det.
    1. Om du vill uppgradera till en specifik version av agenten anger du versionsnumret i kommandot . För version 2.0.0 på ett RHEL8-system använder du till exempel följande kommando:
    sudo dnf install az-aoi-ingestion-2.0.0
  4. Gör ändringar i konfigurationsfilen som beskrivs av supportkontakten eller dokumentationen för den nya versionen. De flesta uppgraderingar kräver inga konfigurationsändringar.
  5. Starta om agenten. 
    sudo systemctl restart az-aoi-ingestion.service
  6. När agenten körs konfigurerar du tjänsten az-aoi-ingestion så att den startar automatiskt vid en omstart. 
    sudo systemctl enable az-aoi-ingestion.service
  7. Kontrollera att agenten körs och att den kopierar filer enligt beskrivningen i Övervaka och felsöka inmatningsagenter för Azure Operator Insights.

Återställa en uppgradering

Om en uppgradering eller konfigurationsändring misslyckas:

  1. Nedgradera tillbaka till den tidigare versionen genom att installera om den tidigare versionen av agenten. Om du till exempel vill nedgradera till version 1.0.0 på ett RHEL8-system använder du följande kommando: 
    sudo dnf downgrade az-aoi-ingestion-1.0.0
  2. Kopiera den säkerhetskopierade konfigurationsfilen från före ändringen till filen /etc/az-aoi-ingestion/config.yaml .
  3. Starta om agenten. 
    sudo systemctl restart az-aoi-ingestion.service
  4. När agenten körs konfigurerar du tjänsten az-aoi-ingestion så att den startar automatiskt vid en omstart. 
    sudo systemctl enable az-aoi-ingestion.service

Relaterat innehåll

Lär dig att: