Skip to main content

Server Automation 追踪报告

使用 Server Automation 追踪报告 (SATR) 获取 Alteryx Server（24.2 及以下版本）上消耗的自动化额度总数。仅当您的账户采用新的 Alteryx One 定价与打包模式，且 Server 版本低于 25.1 时，才需要此实用程序。连接到您的 MongoDB 或 MSSQL 服务器，以提取 Server 的执行数据。打包工作流包含多个配置选项，可适应从每日到每季度执行的不同场景。

解压 SATR 并安装依赖项

步骤 1：解压 SATR 打包工作流

  1. 下载 Server Automation 追踪报告_vX.X.X.yxzp。

  2. 双击 YXZP 文件以解包并在 Designer 中打开工作流。

  3. 打开后，工作流中有几个已禁用的容器。选择最符合您需求的容器并将其启用。如果不确定，可先使用已启用的容器作为默认项。

步骤 2：安装适用于 MongoDB 的 Simba 驱动程序

  1. 从 Alteryx 许可证门户下载 Simba 驱动程序。

  2. 向下滚动至产品下载部分的底部，然后选择驱动程序条目右侧的下载。

  3. 从版本列表中选择 MongoDB，然后选择下一步。

  4. 选择 Simba MongoDB 2.04.3.1003 64 位条目右侧的下载。门户中的版本可能会有所不同。这很正常，也在意料之中。

  5. 双击 MSI 文件即可在您的计算机上安装驱动程序。现在可以通过 ODBC 管理实用程序访问该驱动程序。

步骤 3a（后端使用 MongoDB）：创建 MongoDB 的 DCM 连接

由于访问的表格结构较为简单，MongoDB 快速连接选项将非常高效。无需创建 DSN 条目，因为该连接无需访问嵌套结构即可正常运行。

  1. 打开 DCM。在 Designer 中，转到文件 > 管理连接。

  2. 在数据源选项卡上，选择 + 新建，然后选择 MongoDB 磁贴。

  3. 从技术下拉菜单中，选择 MongoDB ODBC Quick Connect with Simba。

    1. 数据源名称：输入要使用的 Mongo AlteryxService 数据源名称。

    2. 服务器：输入 AlteryxService 的 MongoDB 服务器名称。如果在使用嵌入式 Mongo 的 Alteryx Server 上进行设置，可以使用 localhost。

    3. 端口：输入 MongoDB 的端口。嵌入式 Mongo 使用的默认端口为 27018。

    4. 数据库：输入 AlteryxService。

    5. 驱动程序：使用默认值 Simba MongoDB ODBC 驱动程序。

  4. 选择保存，然后选择连接凭证。

  5. 请填写以下字段：

    • 身份验证方法：MongoDB 用户名和密码

    • 凭证：创建新凭证

    • 凭证名称：可自定义名称（例如 MongoDB_AlteryxService_Local）。

    • 加密保管库：DCM

    • 用户名：您的用户名（嵌入式数据库的默认值为“user”）。

    • 密码：您的密码。

    • 身份验证机制：SCRAM-SHA-256

    • 身份验证源：AlteryxService

    • 允许 SDK 连接：请保持未选中

  6. 选择测试连接。如果成功，请选择创建并链接。

  7. 对 AlteryxGallery 数据库重复执行这些步骤。

步骤 3b（使用 MSSQL 作为后端）：创建 MSSQL 的 DCM 连接

  1. 打开 DCM。在 Designer 中，转到文件 > 管理连接。

  2. 在数据源选项卡上，选择 + 新建，然后选择 Microsoft SQL Server 磁贴。

  3. 从技术下拉列表中，选择 Microsoft SQL Server ODBC 非 DSN 连接。

    1. 数据源名称：输入要使用的 MSSQL AlteryxService 数据源名称。

    2. 驱动程序：使用默认值 ODBC Driver 17 for SQL Server。

    3. 服务器：输入 AlteryxService 的 MSSQL 服务器名称。

    4. 数据库：输入 AlteryxService。

  4. 选择保存，然后选择连接凭证。

  5. 请填写以下字段（并根据 Server 的凭证类型进行调整）：

    1. 方法：用户名和密码

    2. 凭证名称：可自定义名称（例如 MSSQL_AlteryxService_Local）。

    3. 加密保管库：DCM

    4. 用户名：您的用户名。

    5. 密码：您的密码。

  6. 选择测试连接。如果成功，请选择创建并链接。

  7. 对 AlteryxGallery 数据库重复执行这些步骤。

运行 Server Automation 追踪报告

  1. 在 PullServerExecutions 宏中，输入前面步骤中创建的凭证，并选择适用的选项。

    1. 选择 MongoDB 或 MSSQL 后端。

      1. Alteryx Gallery：DCM 与 AlteryxGallery 数据库的连接。

      2. Alteryx Service：DCM 与 AlteryxService 数据库的连接。

    2. 按日期筛选执行：将 AS_Queue（作业）和 AS_Results（结果消息）表格查询限制为仅回溯到指定日期。

      • 按日期范围筛选（单选按钮）：

        • 开始日期：选择开始提取数据的日期（包含所选日期）。

        • 结束日期：选择结束提取数据的日期（包含所选日期）。

      • 按相对日期筛选（单选按钮）：

        • 按最近期间筛选：选择从当前运行日期起回溯的天数或月数。

        • 单位：选择天或月。

        • 排除当前周期：根据上方选择的单位，可选择排除当前天或当前月份。

  2. 在 SummarizeAutomationUsage 宏中，从可用选项中进行选择。

    • 包含成本中心汇总：若要按成本中心汇总自动化运行次数，请将查找表连接到可选输入锚点，其中包含用户电子邮件及其对应的成本中心。使用两个下拉菜单映射字段。

    • 包含电子邮件汇总：选中此框可生成一个汇总表，按电子邮件对用户的自动化运行总数进行排序。

    • 选择输出文件路径：选择要输出报告的完整文件路径。默认情况下，将生成名为 “AutomationSummary.pdf” 的文件，并保存到 %temp% 文件夹中。

  3. 运行工作流。

  4. 在结果窗口中检查是否有指向 SummarizeAutomationUsage 宏生成的临时 PDF 文件的链接。

FAQ

1.

What is the Server Automation Tracking Report (SATR)?

SATR is a lightweight workflow utility for Alteryx Server versions 24.1 and 24.2. It provides visibility into your automation usage, allowing you to share usage statistics with Account Executives (AEs) for billing and compliance purposes. It's intended as a temporary solution for customers who have not yet upgraded to version 25.1 or newer.

2.

Why is the SATR needed?

Many customers are unable to upgrade immediately due to IT policies or the timing of their upgrade cycle. SATR provides the necessary visibility for contract renewals and compliance. It serves as a stopgap until customers can move to 25.1 or newer, which has native reporting.

3.

Who needs to use SATR?

SATR is required for customers who run supported versions of Alteryx Server lower than 25.1 (24.1 and 24.2) while under an Alteryx One contract.

SATR is not required for...

  • Customers on Alteryx Server 25.1 and newer versions: Telemetry is already reported to the cloud platform.

  • Customers who are not under an Alteryx One contract.

4.

What does SATR do?

SATR...

  • Connects to the Alteryx Server MongoDB database.

  • Counts daily automated runs and total runs within a user-specified date range.

  • Aggregates results into monthly summaries.

  • Outputs:

    • PDF Report: Monthly automated run totals and customer account details.

    • YXDB File: Daily automated and total run counts, with server info and timestamps.

5.

What data is collected while running the macros?

Execution records are retrieved from the AS_Queue and AS_Results tables to determine relevant attributes, such as the type of run and whether any errors were encountered. This helps identify if the run counts toward an automation credit. The Users table is pulled to append emails to the execution records. This allows the user to later break down automation credits by cost center or by user.

No data leaves the environment while the workflow is running. The summary files need to be manually transferred to the relevant Account Executive for reporting credit usage.

6.

How do I use the SATR if I have multiple server controllers?

Each macro can pull data from a single controller’s back-end database. You can use multiple macros in a single workflow to pull data from 2 or more controllers, provided those databases are accessible from the machine that runs the workflow. To generate reports, run the macro for each Server controller and submit separate reports. If you want a combined view, manual consolidation is required.

7.

Will the SATR integrate with Alteryx One Usage Service?

No. The SATR is a standalone, customer-managed reporting tool. Automated ingestion into Alteryx One Usage Service is not planned. If automated ingestion is required, please update to Alteryx Server 25.1 or newer.

8.

Does the SATR track cloud executions (for example, Cloud Execution for Desktop, Plans)?

No. The SATR only reports on local Server automated executions. For a complete view of automation credits used, combine SATR results with any execution data found in the Alteryx One portal.

9.

What if my organization purges its database for data hygiene?

If the back-end database is regularly purged of results and queue logs, you should run the workflow more frequently to capture daily logs and store them in a separate database. These logs can then be summarized for total usage reporting later with the report macro.

10.

How do I download and install the SATR?

  • Distributed as an Enterprise Utility (YXZP) via the Alteryx Marketplace.

  • SATR is set up and scheduled by the Server Admin.

  • Documentation and installation guides are available on this help page.

11.

I’ve run the report. What do I do now?

Contact your Account Executive to determine the best way to transfer the report that best satisfies your agreement.

12.

Will the SATR Automation Credits be reflected in the Account Admin console after submitting the report to my AE?

No. The SATR output submitted is only noted in the account and is not integrated into the Alteryx One platform. Total Automation Credits in the Admin console will be under-reported until Servers are updated to 25.1 or newer.

本节内容如下: