Navigating to the UI

After you provision an instance of the IBM Cloud Activity Tracker service in the IBM Cloud, you can view, monitor, and manage events through the IBM Cloud Activity Tracker web UI. You can launch the UI from the IBM Cloud UI or directly from a browser.

As of 28 March 2024 the IBM Log Analysis and IBM Cloud Activity Tracker services are deprecated and will no longer be supported as of 30 March 2025. Customers will need to migrate to IBM Cloud Logs, which replaces these two services, prior to 30 March 2025.

Granting IAM policies to a user to launch the web UI

Note: You must be an administrator of the IBM Cloud Activity Tracker service, an administrator of an IBM Cloud Activity Tracker instance, or have account IAM permissions to grant other users policies.

The following table lists the minimum policy that a user must have to be able to launch the web UI, and view data through the IBM Cloud Activity Tracker web UI:

Table 1. IAM policies
Role	Permission granted
Platform role: `Viewer`	Allows the user to view the list of service instances in the Observability dashboard.
Service role: `Reader`	Allows the user to view events through the web UI.

For more information, see Granting user permissions to a user or service ID.

Launching the UI through the IBM Cloud UI

You can launch the UI within the context of an IBM Cloud Activity Tracker instance, from the IBM Cloud UI.

Complete the following steps to launch the web UI:

Log in to your IBM Cloud account.

After you log in with your user ID and password, the IBM Cloud dashboard opens.
Click the Menu icon > Observability.
Select Activity Tracker.

The list of IBM Cloud Activity Tracker instances is displayed.

There is 1 instance per region.
Select the instance in the region where you want to view events. Then, click Open Dashboard.

The IBM Cloud Activity Tracker web UI opens and shows the Everything view. Through this view, you can see the events in your account for the region that you have selected.

Launching the UI from a browser

You can launch the UI directly from a browser.

Complete the following steps:

Get the UI URL.

For example, a UI looks like https://app.eu-gb.logging.cloud.ibm.com/ext/ibm-sso/xxxxxxxxxx.

You can also copy the UI URL that you get when you launch the UI through the IBM Cloud UI. For example, a UI looks like https://app.eu-gb.logging.cloud.ibm.com/xxxxxxxxxx/logs/view.
Enter the dashboard URL in a browser and log in to IBM Cloud.

Notice that when you enter the following URL https://app.eu-de.logging.cloud.ibm.com/xxxxxxxx, you get a 404 page not found error.

Valid formats are https://<ENDPOINT>/ext/ibm-sso/xxxxxxxxxx or https://<ENDPOINT>/xxxxxxxxxx/logs/view
[Optional] You can also pass query parameters to refine the view that is displayed.
```
https://<ENDPOINT>/ext/ibm-sso/WEB_UI_ID?q=<QUERY>&hosts=<HOSTS>&apps=<APPS>&levels=<LEVELS>&t=<TIMEFRAME>
```
Where
- <ENDPOINT> represents the dashboard URL in the region where the instance is available. See UI endpoints.
- <QUERY> represents the search query that is applied for the view, for example, q=table%3Amangle%20reason%3A%27refresh%20timer%27.
  
  Use %3A to represent a colon (:).
  
  Use %20 to represent a space.
  
  Use %27 to represent a quote (').
- <HOSTS> represents the list of services for which data is included in the view. Notice that these are values that you select in the Sources section of the UI. Multiple hosts are separated by commas, for example, hosts=logging-agent-trkq9,logging-agent-trkq7.
- <APPS> represents the list of apps for which data is included in the view. Multiple apps are separated by commas.
- <LEVELS> represents the list of levels for which data is included in the view. Multiple levels are separated by commas, for example, levels=normal,critical.
- <TIMEFRAME> represents the timeframe that you apply to the data that is displayed through the view. For example, look at the following samples:
  
  When you specify a timeframe of July 12, the value is t=July%2012.
  
  When you specify a timeframe of July 12, 2020, the value is t=July%2012%2C%202020.
  
  When you specify a timeframe of July 12, 2020 to July 15,2020, the value is t=July%2012%2C%202020%20to%20July%2015%2C2020.