引入代理概述

引入代理会将数据上传到 Azure 运营商见解数据产品。 我们提供了一个名为 Azure 运营商见解引入代理的引入代理，你可在 Linux 虚拟机上安装该代理以从网络上传数据。 此引入代理支持上传以下内容：

• Affirmed Mobile Content Cloud (MCC) 事件数据记录 (EDR) 数据流。
• 存储在 SFTP 服务器上的文件。

在生产环境中，建议不要在一个代理实例中组合不同类型的源，但实验室试验和测试时支持这样做。

MCC EDR 源概述

配置了 MCC EDR 源的引入代理旨在与 Affirmed Networks Mobile Content Cloud (MCC) 一起使用。 它从 MCC 网络元素引入事件数据记录 (EDR)，并将它们上传到 Azure 运营商见解。 若要了解详细信息，请参阅体验质量 - Affirmed MCC 数据产品。

SFTP 拉取源概述

配置了 SFTP 拉取源的引入代理会从一个或多个 SFTP 服务器收集文件，并将它们上传到 Azure 运营商见解。

文件源

引入代理会从你在其上配置该代理的引入管道收集文件。 管道包括 SFTP 服务器的详细信息、待收集的文件以及管理文件的方式。

例如，单个 SFTP 服务器可能具有日志、CSV 文件和文本文件。 可以将每种类型的文件配置为单独的引入管道。 对于每个引入管道，可指定要从中收集文件的目录（选择性地包括或排除基于文件路径的特定文件）、收集文件的频率和其他选项。 有关可用选项的完整详细信息，请查看 Azure 运营商见解引入代理的配置参考。

引入管道存在以下限制：

• 引入管道不得重叠，也就是说它们不得从相同的服务器收集相同的文件。
• 你必须只在一个代理上配置每个管道。 如果在多个代理上配置管道，Azure 运营商见解会接收重复的数据。

处理文件

引入代理会在计划的上传运行期间将文件上传到 Azure 运营商见解。 这些运行的频率是在管道的配置中定义的。 每个上传运行都会根据管道的配置上传文件：

• 用于包括和排除文件的文件路径和正则表达式指定了要上传的文件。
• 处置时间会从任何上传中排除此时间段内上次修改的文件。 例如，如果上传运行从 05:30 开始，并且处置时间为 60 秒（一分钟），则上传运行仅上传在 05:29 之前修改的文件。
• “排除截止日期”（若设置）会排除上次修改时间在指定日期和时间之前的文件。

引入代理会记录它上次完成文件源上传运行的时间。 它使用此记录来确定要在上次上传运行期间按照以下过程上传哪些文件：

1. 该代理会检查上次记录的时间。
2. 该代理会上传自此时间以来修改的任何文件。 它假定它在上一次上传运行期间处理了较旧的文件。
3. 在上传运行结束时：
   • 如果代理上传了所有文件，或者只出现了不可重试的错误，代理将更新记录。 新时间基于上传运行开始的时间，再减去处置时间。
   • 如果上传运行出现可重试错误（例如，与 Azure 的连接断开），代理不会更新记录。 如果不更新记录，那么代理可以针对未成功上传的任何文件重试上传。 重试不会复制以前上传的任何数据。

引入代理设计为高度可靠性且具有弹性，可应对低级别的网络中断。 如果发生意外错误，代理会在运行后立即重新启动并再次提供服务。 重启后，代理对所有已配置的文件源执行即时弥补上传运行。 然后，它将返回到其配置的计划。

身份验证

引入代理使用单独的凭据对两个单独的系统进行身份验证。

• 若要向 Azure 运营商见解数据产品的引入终结点进行身份验证，代理会从 Azure 密钥保管库获取 SAS 令牌。 代理使用创建代理时设置的 Microsoft Entra ID 托管标识或服务主体和证书向此密钥保管库进行身份验证。
• 若要向 SFTP 服务器进行身份验证，代理可以使用密码身份验证或 SSH 密钥身份验证。

有关配置说明，请参阅设置对 Azure 的身份验证、准备 VM 和配置代理软件。

下一步