Skip to main content

客户管理的遥测

此功能允许您在升级到 Designer 2021.4(或更高版本)后输出工作流遥测日志文件。它增强了组织收集和记录 Designer 使用数据的能力,精确到每个用户的每次工作流运行。您可以使用这些数据执行内部产品使用情况分析。

注意

遥测 XML 文件不包含“结果”窗口中的信息。工作流运行时间、读取和写入文件的记录,以及错误、警告或其他消息等信息,仅包含在引擎日志中。如要设置日志目录以生成包含此信息的引擎日志,请转至选项 > 用户设置 > 编辑用户设置 > 常规

管理企业实用程序入门套件

现已推出一款采用客户管理遥测功能的新企业实用程序。此实用程序可让您将通过 Designer 中的这一新功能收集的遥测数据处理为可用数据。该实用程序还包含 2 个示例仪表板,可自动填充您的数据,简化您获取洞察的过程。

要下载该实用程序,请前往 Alteryx Marketplace

Alteryx 保护数据隐私

由客户管理的遥测所导出的结果日志文件不会发送到 Alteryx 或被 Alteryx 以任何方式使用。您可以通过在安装 Alteryx 的过程中编辑管理员文件来部署客户管理的遥测。使用此功能时,管理员需要履行当地隐私法规定的义务。例如,披露个人数据收集的责任。Alteryx 并不要求开启此功能或控制此功能的使用。

遥测设置

  1. 打开 RuntimeSettings 文件,该文件通常位于以下目录中。请注意,以下文件路径为 Alteryx 安装的默认路径。您的 Alteryx 版本可能安装在其他位置。

    • 管理员版本*:%ProgramFiles%\Alteryx\bin\RuntimeData\RuntimeSettings.xml

      * 重新安装管理员版本的 Designer 可能会覆盖这些设置。

    • 非管理员版本*:%LocalAppData%\Alteryx\bin\RuntimeData\RuntimeSettings.xml

      * 重新安装非管理员版本的 Designer 可能会覆盖这些设置。

    重要

    管理员和非管理员版本的 Designer 还会引用 %ProgramData%\Alteryx\RuntimeSettings.xml 中的运行时设置文件。

    ProgramData 位置中的值将会覆盖安装默认位置中的值。

    如要在 Designer 升级中保留自定义遥测设置,建议修改 %ProgramData%\Alteryx\RuntimeSettings.xml,这是因为默认安装的 RuntimeSettings.xml 在安装新版本 Designer 时可被替换。

  2. 请确保您拥有 RuntimeSettings 文件的编辑权限。

  3. 在文件中搜索现有的 <Telemetry /> 标签。如果找到,请将其替换为下一步中提到的标签。如果该标签不存在,请按照下一步中的说明将其添加。

  4. 将以下代码添加到 RuntimeSettings XML 文件中。确保"Telemetry"标记嵌套在"SystemSettings"下,而不是在"SystemSettings"中的任何其它标记下。

    请注意,此图像中的 <Telemetry> 标签是一个独立条目,嵌套在 <SystemSettings> 中,但未嵌套在 <Engine> 标签中。该示例显示正确位置。

    Image showing an example Telemetry entry inside of the SystemSettings tag.
    • 可以将文件路径设置为您希望存储 XML 的任何现有路径。下面的示例文件将文件保存到 C:\ProgramData\Alteryx\Engine 下的日志文件夹中。

    • 此外,请注意 EnableCustomerManagedTelemetry 标记和关联的文件路径应在同一行中。请勿将标记放置在其他部分中。

    <Telemetry>
    <EnableCustomerManagedTelemetry>C:\ProgramData\Alteryx\Engine\Logs</EnableCustomerManagedTelemetry> 
    </Telemetry>
  5. 保存对运行时设置文件所做的编辑,然后重新启动计算机。

一旦用户运行工作流,就会捕获完整的 XML 记录并将其存储在您设置的文件路径中。

捕获的信息

客户管理的遥测灵活方便,支持多种使用案例。为了提供使用情况信息,您可以对 Alteryx 进行设置,以将工作流的基础 XML 文件记录到本地或网络文件路径中。

请注意,遥测 XML 文件不包括结果窗口中的信息。工作流运行时间、读取和写入文件的记录,以及错误、警告或其他消息等信息,仅包含在引擎日志中。您需要通过以下路径设置日志目录,以生成包含此信息的引擎日志:选项 > 用户设置 > 编辑用户设置 > 常规

这些 XML 标头标记显示在日志文件的顶部:

XML 标记

描述

TimeStamp

标识工作流执行时间的时间戳。时间戳采用 UTC 格式,格式如下:yyyy-MM-dd'T'HH:mm:ss'Z'。

UserEmail

用户在产品激活时提交的电子邮件地址。

MachineName

机器主机名

AlteryxGlobalUID

唯一运行 ID

WorkflowFilePath

所运行文件的完全限定路径。

LicenseKey

用于激活产品的许可证密钥。

补充说明

  • WorkflowFilePath 在工作流保存前不会记录任何值。

  • 请确保您对运行时设置中指定的文件路径具有写入权限,以便成功启用此功能。