Azure Operator Insights インジェストエージェントをアップグレードする

インジェストエージェントは、お客様が所有および管理する Linux 仮想マシン (VM) にインストールされるソフトウェアパッケージです。場合によっては、エージェントをアップグレードする必要があります。

この記事では、インジェストエージェントをアップグレードする方法と、アップグレードをロールバックする方法について説明します。

前提条件

アップグレードするインジェストエージェントのバージョンを決定します。アップグレード時にバージョンを指定しない場合は、最新バージョンにアップグレードされます。

最新のリリースの一覧と各バージョンでの変更点については、「Azure Operator Insights インジェストエージェントの新機能」を参照してください。 6 か月以上前のエージェントバージョンをお探しの場合は、リリースノートのアーカイブを確認してください。

アップグレードする前にインジェストエージェントパッケージの信頼性を確認する場合は、「GPG リポジトリ署名キーの使用方法」を参照してください。

エージェントの新しいリリースにアップグレードするには、古いエージェントがある各 VM で次の手順を繰り返します。

SSH 経由で VM に接続します。
既存の /etc/az-aoi-ingestion/config.yaml 構成ファイルのコピーを保存します。
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
```
サポートの連絡先または新しいバージョンのドキュメントに記載されている構成ファイルに変更を加えてください。ほとんどのアップグレードでは、構成の変更は必要ありません。

エージェントを再起動します。

sudo systemctl restart az-aoi-ingestion.service

エージェントが実行されたら、再起動時に自動的に開始されるように az-aoi-ingestion サービスを構成します。
```
sudo systemctl enable az-aoi-ingestion.service
```
「Azure Operator Insights のインジェストエージェントの監視とトラブルシューティング」の説明に従って、エージェントが実行されていること、およびエージェントでファイルがコピーされていることを確認します。

アップグレードまたは構成の変更に失敗した場合:

以前のバージョンのエージェントを再インストールして、以前のバージョンにダウングレードします。たとえば、RHEL8 システムでバージョン 1.0.0 にダウングレードするには、次のコマンドを使用します。
```
sudo dnf downgrade az-aoi-ingestion-1.0.0
```
変更前のバックアップ構成ファイルを /etc/az-aoi-ingestion/config.yaml ファイルにコピーします。

エージェントを再起動します。

sudo systemctl restart az-aoi-ingestion.service

エージェントが実行されたら、再起動時に自動的に開始されるように az-aoi-ingestion サービスを構成します。
```
sudo systemctl enable az-aoi-ingestion.service
```

具体的には、次の方法を学習します。