インジェスト エージェントの概要

インジェスト エージェントは、Azure Operator Insights データ製品にデータをアップロードします。 Azure Operator Insights インジェスト エージェントと呼ばれるインジェスト エージェントが用意されています。このエージェントは、Linux 仮想マシンにインストールしてネットワークからデータをアップロードできます。 このインジェスト エージェントでは、次のものをアップロードできます:

• 確認済みの Mobile Content Cloud (MCC) イベント データ レコード (EDR) データ ストリーム。
• SFTP サーバーに保存されているファイル。

1 つのエージェント インスタンスで異なる種類のソースを組み合わせることは運用環境では推奨されませんが、ラボの試用版とテストではサポートされています。

MCC EDR ソースの概要

MCC EDR ソースで構成されたインジェスト エージェントは、確認済みネットワーク モバイル コンテンツ クラウド (MCC) で使用するように設計されています。 MCC ネットワーク要素からイベント データ レコード (EDR) を取り込み、Azure Operator Insights にアップロードします。 詳細については、「Quality of Experience - 確認済みの MCC データ製品」を参照してください。

SFTP プル ソースの概要

SFTP プル ソースで構成されたインジェスト エージェントは、1 つ以上の SFTP サーバーからファイルを収集し、Azure Operator Insights にアップロードします。

ファイル ソース

インジェスト エージェントは、そこに構成した "インジェスト パイプライン" からファイルを収集します。 パイプラインには、SFTP サーバーの詳細、そこから収集するファイル、およびそれらのファイルを管理する方法が含まれます。

たとえば、1 つの SFTP サーバーにログ、CSV ファイル、テキスト ファイルが含まれる場合があります。 ファイルの種類ごとに個別のインジェスト パイプラインとして構成できます。 インジェスト パイプラインごとに、ファイルを収集するディレクトリ (必要に応じて、ファイル パスに基づいて特定のファイルを含めるか除外する)、ファイルを収集する頻度、およびその他のオプションを指定できます。 全ての構成オプションついては、「Azure Operator Insights インジェスト エージェントの構成リファレンス」を参照してください。

インジェスト パイプラインには、次の制限があります:

• これらは重複しないようにする必要があります。つまり、同じサーバーから同じファイルを収集することはできません。
• 各パイプラインは、1 つのエージェントに対して構成する必要があります。 複数のエージェントでパイプラインを構成した場合、Azure Operator Insights は重複データを受信します。

ファイルの処理

インジェスト エージェントは、スケジュールされたアップロードの実行中に、ファイルを Azure Operator Insights にアップロードします。 これらの実行の頻度は、パイプラインの構成で定義されます。 各アップロード実行では、パイプラインの構成に従ってファイルがアップロードされます:

• ファイルをインクルードおよび除外するためのファイル パスと正規表現は、アップロードするファイルを指定します。
• セトリング時間 は、この期間内に最後に変更されたファイルをアップロードから除外します。 たとえば、アップロードの実行が 05:30 に開始され、セトリング時間が 60 秒 (1 分) の場合、アップロード実行では 05:29 より前に変更されたファイルのみがアップロードされます。
• 時間前を除外 (設定されている場合) は、指定した日時より前に最後に変更されたファイルを除外します。

インジェスト エージェントは、ファイル ソースのアップロード実行が最後に完了したときに記録します。 次のプロセスを使用して、このレコードを使用して、次のアップロード実行時にアップロードするファイルを決定します:

1. エージェントは、最後に記録された時刻を確認します。
2. エージェントは、その時点以降に変更されたすべてのファイルをアップロードします。 以前のアップロードの実行中に古いファイルが処理されたことを前提としています。
3. アップロードの最後に、次のコマンドを実行します:
   • エージェントがすべてのファイルをアップロードした場合、または唯一のエラーが解決不可能なエラーであった場合、エージェントはレコードを更新します。 新しい時刻は、アップロードの実行が開始された時刻からセトリング時間を差し引いた時間に基づいています。
   • アップロードの実行で再試行可能なエラーが発生した場合 (たとえば、Azure への接続が失われた場合)、エージェントはレコードを更新しません。 レコードを更新しないと、エージェントは正常にアップロードされなかったファイルのアップロードを再試行できます。 再試行では、以前にアップロードされたデータは複製されません。

インジェスト エージェントは、低レベルのネットワーク中断に対する高い信頼性と回復性を備えています。 予期しないエラーが発生した場合、エージェントは再起動し、実行されるとすぐにサービスを提供します。 再起動後、エージェントは、構成されているすべてのファイル ソースに対して即時のキャッチアップ アップロード実行を実行します。 その後、構成されたスケジュールに戻ります。

認証

インジェスト エージェントは、個別の資格情報を使用して、2 つの個別のシステムに対して認証を行います。

• Azure Operator Insights データ製品のインジェスト エンドポイントに対して認証を行うために、エージェントは Azure Key Vault から SAS トークンを取得します。 エージェントは、エージェントの作成時にセットアップした Microsoft Entra ID のマネージド ID か、サービス プリンシパルおよび証明書のどちらかにより、この Key Vault に対して認証を行います。
• SFTP サーバーに対して認証を行うために、エージェントはパスワード認証または SSH キー認証を使用できます。

構成手順については、「Azureへの認証の設定」、「VM の準備」、および「エージェント ソフトウェアの構成」を参照してください。

次のステップ