Skip to main content

Server Automation Tracking Report (Server自動化追跡レポート)

Server Automation Tracking Report (SATR)を使用して、Alteryx Server (バージョン24.2以前)で使用された合計の自動化クレジットを取得します。このユーティリティは、アカウントに新しいAlteryx Oneの価格体系とパッケージ体系が適用されていて、Serverが25.1より前のバージョンで実行されている場合にのみ必要になります。MongoDBまたはMSSQLサーバーに接続して、Serverの実行データを抽出します。パッケージ化されたワークフローには、毎日の実行から四半期ごとの実行まで、さまざまなシナリオに対応するセットアップオプションが複数含まれています。

SATRの展開と依存関係のインストール

ステップ1: SATRパッケージ化ワークフローを展開する

  1. Server Automation Tracking Report_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. [テクノロジー]ドロップダウンから、[Simbaドライバー経由MongoDB ODBCクイック接続]を選択します。

    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 Tracking Reportを実行する

  1. PullServerExecutionsマクロに、前のステップで作成した資格情報を入力し、該当するオプションを選択します。

    1. MongoDBまたはMSSQLのいずれかのバックエンドを選択します。

      1. Alteryx Gallery: AlteryxGalleryデータベースへのDCM接続。

      2. Alteryx Service: AlteryxServiceデータベースへのDCM接続。

    2. Filter Executions by Date: AS_Queue (ジョブ)およびAS_Results (結果メッセージ)テーブルのクエリを、指定した日付に遡って取得するよう制限します。

      • Filter by date range (ラジオボタン):

        • 開始日: データの取得を開始する日付(選択した日付を含む)を選択します。

        • 終了日: データの取得を終了する日付(選択した日付を含む)を選択します。

      • Filter by relative date (ラジオボタン):

        • Filter by last: 現在の実行日から遡って取得する日数/月数を選択します。

        • 単位: 日または月を選択します。

        • Exclude Current Period: 上記で選択した単位に応じて、現在の日または月を除外するオプションです。

  2. SummarizeAutomationUsageマクロで、使用可能なオプションから選択します。

    • Include Cost Center Rollup: コストセンター別に自動化カウントをロールアップするには、検索テーブルを、ユーザーのEメールと対応するコストセンターを含むオプションの入力アンカーに接続します。2つのドロップダウンを使用してフィールドをマッピングします。

    • Include Email Rollup: このチェックボックスをオンにすると、ユーザーあたりの自動化実行の合計数をEメール別でランク付けするサマリーテーブルが生成されます。

    • Choose output file path: レポートの出力先となる完全なファイルパスを選択します。既定は「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.

このセクションの内容: