Skip to main content

Server Automation Tracking Report

Lo strumento Server Automation Tracking Report (SATR) fornisce il totale dei crediti di automazione utilizzati in Alteryx Server (versioni 24.2 e precedenti). Questa utility è necessaria solo per gli account che utilizzano i nuovi piani tariffari e pacchetti Alteryx One con versioni di Server anteriori alla 25.1. Stabilisci la connessione al server MongoDB o MSSQL, in modo da estrarre i dati di esecuzione per la tua istanza di Server. Il flusso di lavoro per i pacchetti offre varie opzioni di configurazione che consentono di gestire scenari diversi, dall'esecuzione quotidiana a quella trimestrale.

Decompressione di SATR e installazione delle dipendenze

Passaggio 1. Decompressione del pacchetto SATR e avvio del flusso di lavoro

  1. Scarica il file Server Automation Tracking Report_vX.X.X.yxzp.

  2. Fai doppio clic sul file YXZP per decomprimerlo e avviare il flusso di lavoro in Designer.

  3. Il flusso di lavoro aperto presenta vari contenitori disabilitati. Scegli e abilita quello più adatto alle tue esigenze. Se sei in dubbio, comincia con quello abilitato per impostazione predefinita.

Passaggio 2. Installazione del driver Simba per MongoDB

  1. Scarica il driver Simba dal portale Licenze Alteryx.

  2. Scorri fino in fondo alla sezione Download prodotti e seleziona Download a destra della voce Driver.

  3. Seleziona MongoDB dall'elenco delle versioni, quindi seleziona Avanti.

  4. Seleziona Download a destra della voce Simba MongoDB 2.04.3.1003 a 64 bit. La versione disponibile nel portale potrebbe essere diversa, ma la cosa non costituisce un problema.

  5. Fai doppio clic sul file MSI per installare il driver nel sistema in uso. Ora il driver è accessibile nell'utilità Amministratore ODBC.

Passaggio 3a (uso di MongoDB come back-end). Creazione di connessioni DCM per MongoDB

Poiché le tabelle consultate hanno una struttura semplice, l'opzione Connessione rapida MongoDB garantisce ottimi risultati. Non è necessario configurare una voce DSN, perché la corretta esecuzione non richiede l'accesso a strutture annidate.

  1. Apri DCM. In Designer, vai a File > Gestisci connessioni.

  2. Nella scheda Origini dati seleziona + Nuova, quindi scegli il riquadro MongoDB.

  3. Dall'elenco a discesa Tecnologia, seleziona Connessione rapida MongoDB ODBC con Simba.

    1. Nome origine dati: inserisci il nome dell'origine dati Mongo AlteryxService che desideri utilizzare.

    2. Server: inserisci il nome del server MongoDB per AlteryxService. Se per la configurazione in un server Alteryx utilizzi Mongo incorporato, puoi usare localhost.

    3. Porta: specifica la porta per MongoDB. Per impostazione predefinita, la versione incorporata di Mongo usa la porta 27018.

    4. Database: inserisci AlteryxService.

    5. Driver: usa il valore predefinito, ovvero Driver MongoDB ODBC per Simba.

  4. Seleziona Salva, quindi Credenziale Connect.

  5. Compila i campi seguenti:

    • Metodo di autenticazione: nome utente e password per MongoDB

    • Credenziale: crea una nuova credenziale.

    • Nome credenziale: specifica un nome a scelta, ad esempio MongoDB_AlteryxService_Local.

    • Vault: DCM

    • Nome utente: specifica il tuo nome utente (l'impostazione predefinita per il database incorporato è "utente”).

    • Password: specifica la tua password.

    • Meccanismo di autenticazione: SCRAM-SHA-256.

    • Origine dell'autenticazione: AlteryxService.

    • Consenti connessione per SDK: opzione deselezionata.

  6. Seleziona Verifica connessione. Se la verifica ha esito positivo, seleziona Crea e collega.

  7. Ripeti la procedura per il database AlteryxGallery.

Passaggio 3b (uso di MSSQL come back-end). Creazione di connessioni DCM per MSSQL

  1. Apri DCM. In Designer, vai a File > Gestisci connessioni.

  2. Nella scheda Origini dati seleziona + Nuova, quindi scegli il riquadro Microsoft SQL Server.

  3. Seleziona ODBC di Microsoft SQL Server senza DSN, dal menu a discesa Tecnologia.

    1. Nome origine dati: inserisci il nome dell'origine dati MSSQL AlteryxService che desideri utilizzare.

    2. Driver: usa il valore predefinito Driver ODBC 17 per SQL Server.

    3. Server: inserisci il nome del server MSSQL per AlteryxService.

    4. Database: inserisci AlteryxService.

  4. Seleziona Salva, quindi Credenziale Connect.

  5. Compila i campi seguenti (adattando i valori in base ai tipi di credenziali per l'istanza di Server in uso):

    1. Metodo: nome utente e password.

    2. Nome credenziale: specifica un nome a scelta, ad esempio MSSQL_AlteryxService_Local.

    3. Vault: DCM

    4. Nome utente: specifica il tuo nome utente.

    5. Password: specifica la tua password.

  6. Seleziona Verifica connessione. Se la verifica ha esito positivo, seleziona Crea e collega.

  7. Ripeti la procedura per il database AlteryxGallery.

Esecuzione di Server Automation Tracking Report

  1. Nella macro PullServerExecutions, inserisci le credenziali create nella procedura precedente e seleziona le opzioni applicabili.

    1. Seleziona il back-end MongoDB o MSSQL.

      1. Alteryx Gallery: connessione DCM al database AlteryxGallery.

      2. Servizio Alteryx: connessione DCM al database AlteryxService.

    2. Filtra esecuzioni in base alla data: limita le query sulle tabelle AS_Queue (processi) e AS_Results (messaggi dei risultati) in modo da restituire solo i risultati relativi a una data specifica.

      • Filtra per intervallo di date (pulsante di opzione):

        • Data di inizio: seleziona la data da cui desideri iniziare l'estrazione dei dati (la data selezionata è inclusa).

        • Data di fine: seleziona la data in cui desideri interrompere l'estrazione dei dati (la data selezionata è inclusa).

      • Filtra per data relativa (pulsante di opzione):

        • Filtra a ritroso: seleziona il numero di giorni o mesi per cui desideri estrarre i dati, a partire dalla data di esecuzione corrente.

        • Unità: seleziona Giorni o Mesi.

        • Escludi periodo corrente: questa opzione consente di escludere il giorno o il mese corrente, a seconda dell'unità selezionata in precedenza.

  2. Nella macro SummarizeAutomationUsage, seleziona le opzioni desiderate.

    • Includi rollup in base al centro di costo: per eseguire il conteggio progressivo dell'automazione in base al centro di costo, connetti una tabella di ricerca all'ancoraggio di input opzionale che contiene l'indirizzo e-mail dell'utente e il centro di costo corrispondente. Usa i due menu a discesa per mappare i campi.

    • Includi rollup in base all'indirizzo e-mail: seleziona questa casella di spunta per generare una tabella riepilogativa che fornisce una classifica del numero totale di esecuzioni dell'automazione in base all'indirizzo e-mail dell'utente.

    • Scegli percorso file di output: seleziona il percorso completo del file per la generazione del report. Per impostazione predefinita, il file si chiama "AutomationSummary.pdf" e viene scritto nella tabella %temp%.

  3. Avvia il flusso di lavoro.

  4. Cerca nella finestra dei risultati i collegamenti al file PDF temporaneo creato dalla macro SummarizeAutomationUsage.

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 questa sezione: