このページでは、Analytics エージェントのスタンドアロンバイナリを更新する方法について説明します。これには、ログ分析データを収集する場合にのみ関連するいくつかの手順が含まれています。

マシンエージェントを介して Analytics エージェントを実行している場合は、「マシンエージェントのアップグレード」の手順を参照してください。

analytics-agent.properties、ジョブフォルダ、およびウォーターマークフォルダに加えて、controller.xml ファイルのコピーも保持する必要があります。 

分析用のログデータを収集する場合にのみ、ウォーターマークファイルとジョブファイルを保持する必要があります。ウォーターマークファイルには、Analytics エージェントがログソースから読み取ったバイト数に関する情報が保存されます。このファイルは、ログ分析が有効な場合にのみ関連します。

ファイルの場所

Analytics エージェントのスタンドアロンバイナリを解凍した後、ファイルの場所は次のようになります。

  • プロパティファイル:<analytics-agent-home>/conf/analytics-agent.properties
  • ジョブファイル:<analytics-agent-home>/conf/job
  • ウォーターマークファイル:<analytics-agent-home>/conf/watermark

マシンエージェントを介した Analytics エージェントの実行では、ファイルの場所は次のようになります。

  • プロパティファイル:<machine-agent-home>/monitors/analytics-agent/conf/analytics-agent.properties
  • ジョブファイル:<machine-agent-home>/monitors/analytics-agent/conf/job
  • ウォーターマークファイル:<machine-agent-home>/monitors/analytics-agent/conf/watermark

Analytics エージェント(スタンドアロンバイナリ)のアップグレード手順

Analytics エージェント(スタンドアロンバイナリ)を 20.x にアップグレードするには、次の手順を使用します。 

  1. Analytics エージェントを停止します。
  2. ダウンロードサイトから 20.x Analytics エージェントバイナリをダウンロードします。
  3. 新しい zip を解凍します。新しい空のディレクトリに解凍するか、または新しいバージョンを解凍する前に古いディレクトリが空であることを確認します。このようにしないと、Analytics エージェントの起動中にエラーが発生することがあります。
  4. (Windows のみ)Analytics エージェントが Windows サービスとしてインストールされている場合は、20.x バージョンをインストールする前に、古いサービスを手動でアンインストールする必要があります。
  5. 古い analytics-agent.properties のコピーを保存します。これにより、新しい analytics-agent.properties ファイルに値をコピーできます。 
  6. 必要に応じて前のプロパティを参照して、「エージェント側のコンポーネントのインストール」の手順に従い新しい analytics-agent.properties ファイルを変更します。
  7. ログ分析データを収集している場合は、次のようにします。
    1. 古いウォーターマークファイルを、新しい <analytics-agent-home> ディレクトリ構造内の対応する場所にコピーします。
    2. 既存のジョブファイルを、新しい <analytics-agent-home> ディレクトリ構造内の対応する場所にコピーします。
  8. 新しい Analytics エージェントを起動します。
    エージェントが有効なジョブファイルを開始し、ウォーターマークファイルの最後の読み取り位置からログの tail 処理を開始することを確認できます。通常は、最後の読み取り位置から tail 処理を開始したことを示すログメッセージが表示されます。これは、ウォーターマークファイルと一致します。出力時にログメッセージが同期していない場合は、すべてのログが tail 処理され、重複するログが tail 処理されなかったことを、UI を通じて手動で確認できます。

ジョブファイルから新しい統合ログ管理ソースルールに移行するには、「ソースルールへのログ分析ジョブファイルの移行」を参照してください。