Skip to main content

Nachverfolgungsbericht zur Server-Automatisierung

Verwenden Sie den Nachverfolgungsbericht zur Server-Automatisierung (Server Automation Tracking Report, SATR), um die Gesamtzahl der auf Alteryx Server (Versionen 24.2 und früher) verwendeten Automatisierungsgutschriften abzurufen. Dieses Hilfsprogramm ist nur erforderlich, wenn für Ihr Konto die Preise und Verpackungen des neuen Alteryx One gelten, während Server mit einer Version vor 25.1 ausgeführt wird. Stellen Sie eine Verbindung zu Ihrem MongoDB- oder MSSQL-Server her, um die Ausführungsdaten für Ihren Server zu extrahieren. Das Workflow-Paket umfasst mehrere Einrichtungsoptionen für verschiedene Szenarien, von der täglichen bis zur vierteljährlichen Ausführung.

SATR entpacken und Abhängigkeiten installieren

Schritt 1: SATR-Paket-Workflow entpacken

  1. Laden Sie Server Automation Tracking Report_vX.X.X.yxzp herunter.

  2. Doppelklicken Sie auf die YXZP-Datei, um den Workflow zu entpacken und in Designer zu öffnen.

  3. Nach dem Öffnen des Workflows sind mehrere deaktivierte Container vorhanden. Wählen Sie den Container, der Ihren Anforderungen am besten entspricht, und aktivieren Sie ihn. Wenn Sie sich nicht sicher sind, beginnen Sie einfach mit dem aktivierten Container als Standard.

Schritt 2: Simba-Treiber für MongoDB installieren

  1. Laden Sie den Simba-Treiber aus dem Alteryx Lizenzierungsportal herunter.

  2. Scrollen Sie zum Ende des Abschnitts Produkt-Downloads und wählen Sie Herunterladen rechts neben dem Eintrag Drivers (Treiber) aus.

  3. Wählen Sie MongoDB in der Versionsliste aus, und wählen Sie Weiter.

  4. Wählen Sie Herunterladen rechts neben Simba MongoDB 2.04.3.1003 64-bit aus. Die Version im Portal kann abweichen. Das ist in Ordnung und zu erwarten.

  5. Doppelklicken Sie auf die MSI-Datei, um den Treiber auf Ihrem Rechner zu installieren. Der Treiber ist nun im ODBC-Administrator-Hilfsprogramm verfügbar.

Schritt 3a (verwendet MongoDB als Backend): DCM-Verbindungen für MongoDB erstellen

Da die aufgerufenen Tabellen eine einfache Struktur haben, ist die MongoDB-Option „Schnellverbindung“ wirksam. Es ist nicht erforderlich, einen DSN-Eintrag einzurichten, da für eine korrekte Ausführung nicht auf verschachtelte Strukturen zugegriffen werden muss.

  1. Öffnen Sie DCM. Navigieren Sie in Designer zu Datei > Verbindungen verwalten.

  2. Wählen Sie auf der Registerkarte Datenquellen die Option + Neu und dann die Kachel MongoDB aus.

  3. Wählen Sie im Dropdown-Menü Technologie die Option MongoDB ODBC Quick Connect mit Simba aus.

    1. Datenquellenname: Geben Sie den Mongo-AlteryxService-Datenquellennamen ein, den Sie verwenden möchten.

    2. Server: Geben Sie den MongoDB-Servernamen für AlteryxService ein. Wenn Sie dies auf einem Alteryx Server mit eingebettetem Mongo einrichten, können Sie localhost verwenden.

    3. Port: Geben Sie den Port für die MongoDB ein. Der Standardwert für die eingebettete Mongo ist 27018.

    4. Database (Datenbank): Geben Sie AlteryxService ein.

    5. Driver (Treiber): Verwenden Sie den Standardwert Simba MongoDB ODBC-Treiber.

  4. Wählen Sie Speichern und dann Anmeldedaten verknüpfen aus.

  5. Füllen Sie die folgenden Felder aus:

    • Authentifizierungsmethode: MongoDB-Benutzername und -Kennwort

    • Anmeldedaten: Neue Anmeldedaten erstellen

    • Anmeldename: beliebiger Name (zum Beispiel MongoDB_AlteryxService_Local).

    • Tresor: DCM

    • Benutzername: Ihr Benutzername (die Standardeinstellung für die eingebettete Datenbank ist „Benutzer“).

    • Kennwort: Ihr Kennwort.

    • Authentifizierungsmethode: SCRAM-SHA-256

    • Authentifizierungsquelle: AlteryxService

    • Verbindung für SDK zulassen: Deaktiviert

  6. Wählen Sie Verbindung testen aus. Bei Erfolg wählen Sie Erstellen und verknüpfen aus.

  7. Wiederholen Sie diese Schritte für die AlteryxGallery-Datenbank.

Schritt 3b (verwendet MSSQL als Backend): DCM-Verbindungen für MSSQL erstellen

  1. Öffnen Sie DCM. Navigieren Sie in Designer zu Datei > Verbindungen verwalten.

  2. Öffnen Sie die Registerkarte Datenquellen und wählen Sie + Neu und dann die Kachel Microsoft SQL Server aus.

  3. Wählen Sie im Dropdown-Menü Technologie die Option Microsoft SQL Server ODBC DSN-less aus.

    1. Datenquellenname: Geben Sie den MSSQL AlteryxService-Datenquellennamen an, den Sie verwenden möchten.

    2. Driver (Treiber): Verwenden Sie den Standardwert ODBC Driver 17 for SQL Server (ODBC-Treiber 17 für SQL Server).

    3. Server: Geben Sie den MSSQL-Servernamen für AlteryxService ein.

    4. Database (Datenbank): Geben Sie AlteryxService ein.

  4. Wählen Sie Speichern und dann Anmeldedaten verknüpfen aus.

  5. Füllen Sie die folgenden Felder aus (für die Anmeldedatentypen Ihres Servers anpassen):

    1. Method (Methode): Benutzername und Kennwort

    2. Anmeldename: Name Ihrer Wahl (z. B. MSSQL_AlteryxService_Local).

    3. Tresor: DCM

    4. Benutzername: Ihr Benutzername.

    5. Kennwort: Ihr Kennwort.

  6. Wählen Sie Verbindung testen aus. Bei Erfolg wählen Sie Erstellen und verknüpfen aus.

  7. Wiederholen Sie diese Schritte für die AlteryxGallery-Datenbank.

Nachverfolgungsbericht zur Server-Automatisierung ausführen

  1. Geben Sie im PullServerExecutions-Makro die in den vorherigen Schritten erstellten Anmeldedaten ein und wählen Sie die entsprechenden Optionen aus.

    1. Wählen Sie entweder MongoDB oder MSSQL-Backend.

      1. Alteryx Gallery: DCM-Verbindung zur AlteryxGallery-Datenbank.

      2. Alteryx Dienst: DCM-Verbindung zur AlteryxService-Datenbank.

    2. Filter Executions by Date (Ausführungen nach Datum filtern): Beschränkt die Abfragen der Tabellen „AS_Queue“ (Aufträge) und „AS_Results“ (Ergebnismeldungen) so, dass nur Daten bis zu einem bestimmten Datum abgerufen werden.

      • Filter by date range (Filtern nach Datumsbereich) (Optionsfeld):

        • Startdatum: Wählen Sie das Datum aus, an dem mit dem Abrufen der Daten begonnen werden soll (einschließlich des ausgewählten Datums).

        • Enddatum: Wählen Sie das Datum aus, bis zu dem Daten abgerufen werden sollen (einschließlich des ausgewählten Datums).

      • Filter by relative Date (Nach relativem Datum filtern) (Optionsfeld):

        • Filter by last (Nach letzten filtern): Wählen Sie die Anzahl der Tage/Monate aus, um die Sie vom aktuellen Ausführungsdatum zurückgehen möchten.

        • Einheiten: Wählen Sie Tage oder Monate.

        • Exclude Current Period (Aktuelle Periode ausschließen): Option zum Ausschließen des aktuellen Tages oder Monats, je nach oben ausgewählter Einheit.

  2. Wählen Sie im Makro SummarizeAutomationUsage eine der verfügbaren Optionen aus.

    • Include Cost Center Rollup (Kostenstellen-Rollup einbeziehen): Um die Automatisierungszahlen nach Kostenstellen zusammenzufassen, verbinden Sie eine Suchtabelle mit dem optionalen Eingabeanker, der die E-Mail-Adresse des/der Benutzer:in und die entsprechende Kostenstelle enthält. Ordnen Sie die Felder mithilfe der beiden Dropdown-Menüs zu.

    • Include Email Rollup (E-Mail-Rollup einbeziehen): Aktivieren Sie dieses Kontrollkästchen, um eine Übersichtstabelle zu erstellen, in der die Gesamtzahl der Automatisierungsausführungen pro Benutzer:in per E-Mail aufgeführt wird.

    • Choose output file path (Ausgabedateipfad wählen): Wählen Sie einen vollständigen Dateipfad für die Ausgabe des Berichts aus. Standardmäßig wird eine Datei namens „AutomationSummary.pdf“ in den Ordner %temp% geschrieben.

  3. Führen Sie den Workflow aus.

  4. Prüfen Sie das Fenster mit den Ergebnissen auf Links zur temporären PDF-Datei, die im Makro SummarizeAutomationUsage erstellt wurde.

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.

In diesem Abschnitt: