Enabling SaaS reporting

Edit online

The steps to enable the optional SaaS reporting component depend on whether your Turbonomic instance is on-prem or hosted on the public cloud. In either case, your Turbonomic instance must meet certain requirements and you must request access from your Turbonomic representative.

Requirements

Turbonomic version 8.15.4 or newer

You can check your version of the product by selecting the Updates option from the Settings page of the Turbonomic user interface (UI) and scrolling to the About section.
Operator version 42.76 or newer
Access to allowlist URLs
Allow access to the following URLs to grant access to ThoughtSpot analytics software. If the URLs are not added to the allowlist, you might not see the Single Sign On option when you attempt to log in.
- For US and Asia-Pacific (APAC):
```
https://identity.thoughtspotlogin.cloud
```
- For EU:
```
https://identity-eu.thoughtspotlogin.cloud
```
- Global:
```
https://identity.dataplane-public.thoughtspot.cloud
```
For more information about allowlist URLs, see Allowlist URLs for ThoughtSpot.

Restriction: Turbonomic hosts all instance data in US or EU region-based data centers. If you are based in a region outside of the mentioned regions and have data residency restrictions, work with your employer to obtain the necessary approvals for SaaS reporting enablement. Alternatively, if you have data residency restrictions, Turbonomic can remove the SaaS reporting option from your instance. Customers from EMEA, APAC, and other regions are welcome to enable SaaS reporting if they have no such restrictions.

Reporting user roles

Contact your Turbonomic representative to request access to SaaS reporting. Specify an email that is registered with IBM Security Verify.

Two different user roles are available for the SaaS reporting environment:

Report Editors can view, modify, and create charts and Liveboards.
Report Admins have all the privileges of Report Editors, but they can also create and modify Report Editor users. For more information, see Managing users.

Turbonomic allows one user per role, per instance. Work with your representative to grant a stakeholder in your organization the Report Admin role.

Enabling SaaS reporting for Turbonomic instances hosted in the public cloud

If your Turbonomic instance is hosted in the public cloud (SaaS) and maintained by your Turbonomic representative, your representative must enable SaaS reporting for you. After SaaS reporting is enabled, you can access the ThoughtSpot UI by selecting the Reports option in the Turbonomic UI sidebar menu and entering your IBM Security Verify email and password. For more information, see Getting started with SaaS reporting.

Enabling SaaS reporting for on-prem Turbonomic instances

If you installed Turbonomic in an on-prem environment, complete the following steps to enable SaaS reporting.

To request a new reporting environment, go to the Turbonomic IBM support page and click the Open a case button.
Submit the case with a severity of 2 and provide the following details in the case description:
- The full name of your company
- The name and email address of your company's Turbonomic administrator
- Your Turbonomic instance ID. To obtain this value, SSH to your instance and run the following command:
```
kubectl exec consul[TAB] -n <namespace> -- consul kv get instanceID
```
  Where <namespace> is the project(namespace) where Turbonomic is installed.
- Select a region (see step 3 for details) and indicate the region of your preference to store your data.
- Verify that your company has an active IBM Passport Advantage agreement.
After your request is processed, your Turbonomic representative provides an encoded configuration string that you use in the following steps.

If your organization restricts outgoing network traffic, allow access to outgoing traffic on the following IP addresses and ports:

Region	IP addresses	Host
US	54.172.111.92 54.197.248.107 54.225.80.190	saas-reporting-us-loadbalancer-45593da10e253507.elb.us-east-1.amazonaws.com
EU	3.77.169.31 3.121.193.38 35.157.126.231	saas-reporting-eu-loadbalancer-d984984f4c49dec0.elb.eu-central-1.amazonaws.com

The port for all regions is in the range of 9000-9010 (all inclusive).

Log in to your Turbonomic instance.
Open the Turbonomic swagger at the following URL:
```
<Your/Turbo/URL.com>/swagger/#/
```
In the Reporting section, select the POST /reporting/configuration endpoint and click Try it out.
In the body field, enter the encoded configuration string that your Turbonomic representative provided in the following format:
```
{
    "configuration":
"<your-configuration-string>",
    "enabled": true
}
```
Click Execute.
In the response window, look for a 200 response code, which verifies that the encoded configuration string is valid and the POST operation was successful.
.
Go back to the home page for your Turbonomic instance and refresh the page. SaaS reporting is now enabled.
Select REPORTS (NEW) from the sidebar menu.
Log in to ThoughtSpot with your IBM Security Verify email and password.

The initial login must use the same email that you specified for your Turbonomic administrator in your enablement request to IBM support (see step 2).

For more information, see Getting started with SaaS reporting.