Install the Server Usage Report

Last modified: June 08, 2021

Use the Alteryx Server Usage Report to report on Server user access, content, schedules, and job analysis. The report can be viewed as Tableau dashboards or PDF and Excel files.

Download the Installation File

  1. Sign in to the Alteryx Downloads and Licenses portal at
  2. Under Product Downloads, select Alteryx Server.
  3. On the Download Products page, select the version of the product you want to download. The latest version is available on the New Versions tab. Access previous versions on the Previous Versions tab.
  4. On the Downloads page, select the link in the File Name column to download the file.

Configure and Run the Report

  1. Unzip the
  2. Open the Alteryx_Server_Usage_Report.yxmd file.
  3. On the canvas, select the Alteryx Server Usage Report macro.
  4. In the Configuration window, select the type of output for viewing the results.
    • Tableau workbook: Creates a workbook and a set of dashboards with user access, content, schedules, and job analysis information.
      1. Select the Output macro.
      2. In the Configuration window, select the Save Tableau Workbook tab.
      3. Select the Save resulting Tableau workbook to a specific location checkbox.
      4. Select a location and enter a file name.
    • PDF: Creates Summary.pdf, AppExecutions.xlsx, and SessionActivity.xlsx files with data for the number of days specified.
  5. Enter the Database Host, Username, and Password found on the Controller > Persistence page of System Settings.
  6. Select Advanced Options to change the Alteryx Gallery and Alteryx Service database names from the defaults.
  7. Run the workflow.
  8. In the Results window, select the link to the output files.
    • For the Tableau workbook, select the link to the Workbook.twb file.
    • For the PDF, select the links to the SessionActivity.xlsx, Summary.pdf, and AppExecutions.xlsx files.

Schedule the Report

  1. Follow previous steps to configure and run the report. 
  2. Save the workflow.
  3. Select Options > Schedule Workflow.
  4. Select a schedule location. You can use the local machine, an existing controller, or add a new controller using the Add Controller option. 
  5. Select Run the workflow from its original location on disk.
  6. Select the frequency and complete the schedule options.
  7. Select OK.


The users count in the Server Usage Report might be different than the actual users count in these scenarios:

  • If the same email address is used to register licenses on multiple machines, the users count is lower than actual users. For example, an administrator might use the same email address to register multiple machines.
  • If any user does not have the valid XML tag for collecting usage data to the local Server in their RuntimeSettings.xml ,the users count is lower than actual users.
  • If any user does not have connectivity to the Gallery, the users count is lower than actual users.  If Designer is unable to connect to this URL (for example, a user is working from home without network connectivity to the Gallery) data is not collected.
Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.