Azure Operator Insights 수집 에이전트 업그레이드

수집 에이전트는 사용자가 소유하고 관리하는 Linux VM(가상 머신)에 설치되는 소프트웨어 패키지입니다. 에이전트를 업그레이드해야 할 수도 있습니다.

이 문서에서는 수집 에이전트를 업그레이드하는 방법과 업그레이드를 롤백하는 방법을 설명합니다.

필수 조건

업그레이드할 수집 에이전트의 버전을 결정합니다. 업그레이드할 때 버전을 지정하지 않으면 최신 버전으로 업그레이드됩니다.

최신 릴리스 목록과 각 버전에서 변경된 내용을 확인하려면 Azure Operator Insights 수집 에이전트의 새로운 기능을 참조하세요. 6개월이 넘은 에이전트 버전을 찾고 있는 경우 릴리스 정보 보관을 확인하세요.

업그레이드하기 전에 수집 에이전트 패키지의 신뢰성을 확인하려면 GPG 리포지토리 서명 키를 사용하는 방법을 참조하세요.

에이전트 소프트웨어 업그레이드

에이전트의 새 릴리스로 업그레이드하려면 이전 에이전트가 있는 각 VM에서 다음 단계를 반복합니다.

1. SSH를 통해 VM에 연결합니다.
2. 기존 /etc/az-aoi-ingestion/config.yaml 구성 파일의 복사본을 저장합니다.
3. VM의 패키지 관리자를 사용하여 에이전트를 업그레이드합니다. 예를 들어 Red Hat 기반 Linux 배포판의 경우:

   sudo dnf upgrade az-aoi-ingestion
   

   프롬프트가 표시되면 y로 답변합니다.
   1. 또는 특정 버전의 에이전트로 업그레이드하려면 명령에서 버전 번호를 지정합니다. 예를 들어 RHEL8 시스템의 버전 2.0.0의 경우 다음 명령을 사용합니다.

   sudo dnf install az-aoi-ingestion-2.0.0
   

4. 지원 담당자가 설명한 구성 파일 또는 새 버전에 대한 설명서를 변경합니다. 대부분의 업그레이드에는 구성 변경이 필요하지 않습니다.
5. 에이전트를 다시 시작합니다.

   sudo systemctl restart az-aoi-ingestion.service
   

6. 에이전트가 실행되면 다시 부팅 시 자동으로 시작되도록 az-aoi-ingestion 서비스를 구성합니다.

   sudo systemctl enable az-aoi-ingestion.service
   

7. Azure Operator Insights용 수집 에이전트 모니터링 및 문제 해결에 설명된 대로 에이전트가 실행 중이고 파일을 복사하고 있는지 확인합니다.

업그레이드 롤백

업그레이드 또는 구성 변경이 실패하는 경우:

1. 이전 버전의 에이전트를 다시 설치하여 이전 버전으로 다시 다운그레이드합니다. 예를 들어 RHEL8 시스템에서 버전 1.0.0으로 다운그레이드하려면 다음 명령을 사용합니다.

   sudo dnf downgrade az-aoi-ingestion-1.0.0
   

2. 변경 전 백업된 구성 파일을 /etc/az-aoi-ingestion/config.yaml 파일에 복사합니다.
3. 에이전트를 다시 시작합니다.

   sudo systemctl restart az-aoi-ingestion.service
   

4. 에이전트가 실행 중일 때 다시 부팅할 때 자동으로 시작되도록 az-aoi-ingestion 서비스를 구성합니다.

   sudo systemctl enable az-aoi-ingestion.service
   

관련 콘텐츠

다음의 방법을 알아보세요.

• 수집 에이전트를 모니터링하고 문제 해결.
• 수집 에이전트 구성 변경.
• 수집 에이전트의 비밀 회전.