Delen via

Azure Operator Insights-opnameagents upgraden

  • Artikel

De opnameagent is een softwarepakket dat is geïnstalleerd op een virtuele Linux-machine (VM) die eigendom is van en wordt beheerd door u. Mogelijk moet u de agent upgraden.

In dit artikel wordt beschreven hoe u uw opnameagent kunt upgraden en hoe u een upgrade kunt terugdraaien.

Vereisten

Bepaal naar welke versie van de opnameagent u wilt upgraden. Als u geen versie opgeeft wanneer u een upgrade uitvoert, voert u een upgrade uit naar de meest recente versie.

Bekijk wat er nieuw is met de Opnameagent van Azure Operator Insights voor een lijst met recente releases en om te zien wat er in elke versie is gewijzigd. Als u op zoek bent naar een agentversie die meer dan zes maanden oud is, bekijkt u het archief met releaseopmerkingen.

Als u de echtheid van het opnameagentpakket wilt controleren voordat u een upgrade uitvoert, raadpleegt u Hoe u de ondertekeningssleutel van de GPG-opslagplaats gebruikt.

De agentsoftware upgraden

Als u een upgrade wilt uitvoeren naar een nieuwe versie van de agent, herhaalt u de volgende stappen op elke VIRTUELE machine met de oude agent.

  1. Verbinding maken via SSH naar de virtuele machine.
  2. Sla een kopie op van het bestaande /etc/az-aoi-ingestion/config.yaml-configuratiebestand .
  3. Werk de agent bij met behulp van pakketbeheer van uw VM. Bijvoorbeeld voor Linux-distributies op basis van Red Hat: 
    sudo dnf upgrade az-aoi-ingestion
    Antwoord y wanneer hierom wordt gevraagd.
    1. Als u een upgrade wilt uitvoeren naar een specifieke versie van de agent, geeft u het versienummer op in de opdracht. Gebruik bijvoorbeeld de volgende opdracht voor versie 2.0.0 op een RHEL8-systeem:
    sudo dnf install az-aoi-ingestion-2.0.0
  4. Breng wijzigingen aan in het configuratiebestand dat wordt beschreven door uw ondersteuningsmedewerker of de documentatie voor de nieuwe versie. Voor de meeste upgrades zijn geen configuratiewijzigingen vereist.
  5. Start de agent opnieuw. 
    sudo systemctl restart az-aoi-ingestion.service
  6. Zodra de agent wordt uitgevoerd, configureert u de az-aoi-opnameservice om automatisch te starten bij opnieuw opstarten. 
    sudo systemctl enable az-aoi-ingestion.service
  7. Controleer of de agent wordt uitgevoerd en of deze bestanden kopieert zoals beschreven in Monitor en problemen met opnameagents voor Azure Operator Insights oplossen.

Een upgrade terugdraaien

Als een upgrade of configuratiewijziging mislukt:

  1. Downgrade terug naar de vorige versie door de vorige versie van de agent opnieuw te installeren. Als u bijvoorbeeld wilt downgraden naar versie 1.0.0 op een RHEL8-systeem, gebruikt u de volgende opdracht: 
    sudo dnf downgrade az-aoi-ingestion-1.0.0
  2. Kopieer het configuratiebestand met back-ups van vóór de wijziging in het bestand /etc/az-aoi-ingestion/config.yaml .
  3. Start de agent opnieuw. 
    sudo systemctl restart az-aoi-ingestion.service
  4. Wanneer de agent wordt uitgevoerd, configureert u de az-aoi-opnameservice om automatisch te starten bij opnieuw opstarten. 
    sudo systemctl enable az-aoi-ingestion.service

Gerelateerde inhoud

Leer hoe u het volgende doet: