Enable Datastudio in a Tenant

Check the following list to assure a correct use of DataStudio in a OneContact tenant:

1. OneContactCC System must have feature Data Studio Enabled

2. OneContactCC System has the "CORE API'S" in the "API" tab filled for Datastudio:

    Data Studio API URL: (can be empty)

    Data Studio API Version: 1.0

    Data Studio Internal API URL: http:// + GrafanaAPI Service IP

"Data Studio Internal API URL" is used to create the tenant in DataStudio(Grafana) as well as the default dashboards and OneContact DataSource.

PortalAPI will call this URL to create the tenant, when enabling DataStudio in a tenant, the logs for PortalAPI should be checked to see if the tenant was created in DataStudio without problems.

PortalAPI logs should show no errors when inside method ">>Entered Method: OneContactDataStudioService.CreateOrganization".

3. Component Parameter SendEventsUsingRabbitMQ has to be set as True in the tenant

DataStudio uses Rabbit to receive messages and extract metrics from them.

Turning DataStudio On first, and the this flag is not a problem. DataStudio requires both of these actions to start saving metrics for the tenant.

4. Ensure instance/tenant's package has the following feature enabled: "data_studio"

Adding the feature will activate DataStudio, this causes:

-The tenant to be created in DataStudio(Grafana) with all default values.

-Adding new Role Permissions to the tenant to be able to login to DataStudio

-Start collecting metrics.

We recomend that all agents are logout when a tenant activates DataStudio, but if this is not possible, the metrics for those agents will be inconsistent until they logout.

5. Ensure Current Roles have additional DataStudio Designer/Viewer permissions.

The feature data_studio adds 2 new Role Permissions: "DataStudio Designer" and "DataStudio Viewer". They exist under "Supervision" > "DataStudio".

Without these roles, only admins can login into DataStudio.

These new Roles might need a Role Reset.

6. Add the new Role Permissions to the desired Admins or Supervisors.

You can also grant them to Users, but they will not be able to see any data in DataStudio.

(they will be able to login, but wont see any data.)

7. You can now login to DataStudio(Grafana) via Oauth/OneContactLogin