擷取代理程式概觀

文章
04/04/2024

擷取代理程式會將數據上傳至 Azure Operator Insights 數據產品。我們提供稱為 Azure Operator Insights 擷取代理程式的擷取代理程式，您可以在 Linux 虛擬機上安裝以從網路上傳數據。此擷取代理程式支援上傳：

確認的行動內容雲端（MCC）事件數據記錄（EDR）數據流。
儲存在 SFTP 伺服器上的檔案。

不建議在生產環境中結合不同類型的來源，但支援實驗室試驗和測試。

MCC EDR 來源概觀

使用 MCC EDR 來源設定的擷取代理程式是設計來與 Affirmed Networks Mobile Content Cloud （MCC）搭配使用。它會從 MCC 網路元素擷取事件數據記錄（EDR），並將其上傳至 Azure Operator Insights。若要深入瞭解，請參閱體驗品質 - 確認的 MCC 數據產品。

SFTP 提取來源概觀

使用 SFTP 提取來源設定的擷取代理程式會從一或多部 SFTP 伺服器收集檔案，並將其上傳至 Azure Operator Insights。

檔案來源

擷取代理程式會從 您在其中設定的擷取管線 收集檔案。管線包含 SFTP 伺服器的詳細數據、要從中收集的檔案，以及如何管理這些檔案。

例如，單一 SFTP 伺服器可能會有記錄、CSV 檔案和文本檔。您可以將每種文件類型設定為個別的擷取管線。針對每個擷取管線，您可以指定要收集檔案的目錄（選擇性地包含或排除以檔案路徑為基礎的特定檔案），收集檔案和其他選項的頻率。如需可用選項的完整詳細數據，請參閱 Azure Operator Insights 擷取代理程式的組態參考。

擷取管線有下列限制：

它們不得重疊，這表示它們不得從相同的伺服器收集相同的檔案。
您必須在一個代理程式上設定每個管線。如果您在多個代理程式上設定管線，Azure Operator Insights 會收到重複的數據。

處理檔案

擷取代理程式會在排定的 上傳執行期間，將檔案上傳至 Azure Operator Insights。這些執行的頻率定義於管線的組態中。每個上傳都會根據管線的組態上傳檔案：

包含和排除檔案的檔案路徑和正則表達式會指定要上傳的檔案。
定 點時間 會排除此期間內上次修改的檔案，而不包含任何上傳。例如，如果上傳執行從 05：30 開始，而定居時間是 60 秒（一分鐘），上傳執行只會上傳在 05：29 之前修改的檔案。
在時間之前排除（如果 set）會排除指定日期和時間之前上次修改的檔案。

擷取代理程式會在上次完成檔案來源的上傳執行時記錄。它會使用此記錄來判斷下一次上傳執行期間要上傳的檔案，請使用下列程式：

代理程式會檢查上次記錄的時間。
代理程式會上傳自該時間以來修改的任何檔案。它假設它在先前的上傳執行期間處理了較舊的檔案。
在上傳結束時，執行：
- 如果代理程式上傳所有檔案或唯一的錯誤是無法重試的錯誤，代理程式就會更新記錄。新時間是根據上傳執行開始的時間，減去定時間。
- 如果上傳執行發生可重試的錯誤（例如，如果 Azure 的連線遺失），代理程式不會更新記錄。未更新記錄可讓代理程式針對未成功上傳的任何檔案重試上傳。重試不會複製先前上傳的任何數據。

擷取代理程序的設計目的是要高度可靠且能夠復原低層級的網路中斷。如果發生未預期的錯誤，代理程式會在執行時重新啟動並提供服務。重新啟動之後，代理程式會針對所有已設定的檔案來源執行立即趕上上傳。然後，它會返回其設定的排程。

驗證

擷取代理程式會以個別認證向兩個不同的系統進行驗證。

若要向 Azure Operator Insights Data Product 的擷取端點進行驗證，代理程式會從 Azure 金鑰保存庫取得 SAS 令牌。代理程式會使用 Microsoft Entra ID 受控識別或服務主體和服務主體，以及您在建立代理程式時設定的憑證，向此金鑰保存庫進行驗證。
若要向 SFTP 伺服器進行驗證，代理程式可以使用密碼驗證或 SSH 金鑰驗證。

如需設定指示，請參閱設定對 Azure 的驗證、準備 VM 和設定代理程式軟體。

後續步驟

安裝 Azure Operator Insights 擷取代理程式，並將其設定為上傳數據

分享方式：