Omni Usage Setup

Euno can observe usage data for Omni workbooks and dashboards—how often they are viewed and by whom. This information helps you identify popular resources, find unused dashboards to archive, and understand adoption patterns.

Prerequisite: Omni Usage requires the Omni integration to also be set up. The Omni integration discovers workbooks and dashboards in Euno; the Omni Usage integration then associates usage data with those resources. Without the Omni integration, there are no resources to attach usage to.

For details on the usage properties observed (e.g. total_impressions_14d, used), see Omni Usage Data.

Overview

Omni Usage is a push integration: your Omni instance (or an external system) sends usage data to Euno via a webhook. Euno stores the events and a global processor aggregates them into usage observations on workbooks and dashboards.

Step 1: Add Omni Usage Integration in Euno

1. Go to the Sources page in Euno.

2. Click Add New Source and select Omni Usage.

3. Configure:

   Configuration	Description
   Name	A name for this integration (e.g. "Omni Usage - Analytics").
   Instance	Your Omni instance subdomain. Must match the instance used in your Omni integration (e.g. mycompany for mycompany.omniapp.co).

4. Click Save. Euno will create the integration and generate a trigger URL which contains a trigger secret.

5. Note the trigger URL from the integration details. You will need these to configure Omni to push data.

Step 2: Configure Omni to Push Usage Data

Configure your Omni instance or an external export process to send usage data to the Euno trigger URL. Only an Omni Account Admin can complete these steps.

1

Open Omni Analytics embedded interface

Login to your Omni instance and locate the Analytics interface.

2

Create a new workbook in Omni Analytics embedded interface

Navigate to the Omni Analytics embedded interface side menu

Pick "Hub". This is the Hub of the Omni Analytics embedded interface. It's distinct from the "Hub" of your Omni instance.

Click "New" to create a new Omni workbook.

3

Create the Usage query to be pushed to Euno

Pick the Model Usage Omni Topic. This will be the topic used by the Query.

Pick the following fields to be included in the Query, the order of the fields doesn't matter:

Omni View	Field
Document Views	Timstamp -> Date
Document Views	Dashboard or Workbook?
Document Views	Document View Count
Model Objects Used in Queries	Query Json -> Raw
Users	Email
Workbooks	Identifier

If you picked the right fields, you table should look like:

Sort the table by Timestamp Date, in descending order:

4

Save the workbook

Click File -> Save...

Pick any folder and name to save the wookbook in. Remember that the folder structure is not your organization standard folder structure. This is the Omni Analytics embedded interface. To keep things organized, we recommend selecting your organization under the "Hub", and naming the workbook "Omni usage data for Euno integration"

5

Create a Dashboard for this workbook

6

Publish the workbook

7

Configure Omni Analytics to send usage information to Euno on a schedule

Click File -> "Deliveries & Alerts"

This will open a side menu to configure a scheduled delivery of the query we configured to Euno.

Pick, from top to bottom:

Delivery: Schedule

Send: Query

Destination: Webhook

Delivery name: query

Configure The Schedule of delivery. We recommend keeping the defaults.

Under "Chart", pick Format: JSON

Under "Webhook", set:

URL: the url you copied from Step 1

File Name: "query"

To test, click "Test now". To save, click "Save"

Related

• Omni integration – Set up the Omni integration to discover workbooks and dashboards.

• Omni Usage Data – Properties and metrics observed for Omni resources.