Working with the user interface

You can access Instana through the user interface.

For the list of web browsers supported for accessing the Instana UI, see Supported web browsers.

Logging in

Before you log in to Instana, make sure that authentication is configured. For more information, see Configuring authentication.

To log in to Instana, complete the following steps:

  1. Enter the Instana URL in a supported browser. The Instana log in page is displayed.
  2. Complete one of the following steps:
    • Log in with the email address that is registered with Instana:
      1. In the Email field, enter the email address that is registered with Instana.
      2. Enter the password.
    • Log in with Google Single Sign-On (SSO):
      1. Click Log in with Google.
      2. Select the Google account that is enabled for SSO.

To Log out of Instana, click Profile menu > Log out.

Home page

The home page is the initial page that you see when you log in to Instana.

Figure 1. The Instana UI home page
The Instana home page

The Instana home page consists of the following elements:

  1. Navigation menu: Access all the sections on the Instana UI from the side navigation menu.
  2. Share: Share URLs from Instana and invite users to access Instana.
  3. Date and time picker: Select the time range for the data that is displayed in Instana.
  4. Live: Display real-time data in Instana.
  5. Show what's new : View the latest changes to Instana.
  6. Install agents or collectors : Install agents and OpenTelemetry collectors on Instana.
  7. Add user : Add users to Instana.
  8. IBM Documentation : Access the Instana documentation.
  9. Release notes : View the latest version of the Instana SaaS release notes.
  10. Community blogs : Read the latest blogs from IBM Instanauts, the Instana blog community.

The home page also includes summary tables for the following landing pages in the UI, displaying the top five entries per area:

  • Events
  • Service level objectives
  • My custom dashboards
  • Infrastructure
  • Websites
  • Applications
  • Synthetic monitoring
  • Platforms
  • Incidents
  • Mobile apps
  • Business processes

Items in each table are listed based on what is shown on the landing pages. For most tables, you can favorite items on the home page to anchor those to the top, and you can reorder the tables based on your preference.

Sharing an Instana URL

You can share URLs from Instana and invite users to access the URLs. Instana can turn the URL into a shorter link that is easy to share. When the shared link is opened, the Instana URL with the same time range is opened even in a different time zone.

You can send an email with the URL or copy the URL from the Page link field and share it without sending the email.

To share an Instana URL over email, complete the following steps:

  1. Click the Share button on the Instana UI. The Share pageName dialog is displayed.
  2. In the Email address field, enter an email address. Click Add user to add multiple email addresses.
  3. Optional: In the Email message field, enter a message. This message is included in the email.
  4. Click Send.

An email is sent with the subject fullName wants to share a page in Instana.

  • If the email is mapped to a user in Instana, they can log in and view the page.
  • If the email is not mapped to a user in Instana, the user needs to sign up for Instana to access the URL.

Interacting with graphs

The prebuilt dashboards in Instana provide information about your environment in charts and tables. The dashboard is automatically displayed when you select an item in the menu.

You can set a time range to view data in charts. To change the time range for the dashboard, click the clock icon next to the short link icon. The range that you select in the date picker or time picker applies to all the charts and tables in the dashboard.

  • To view charts in real-time, click Live.
  • To view the most recent data in the charts, click Last minute in the time range.
  • To view second-by-second data, hover over a graph point.

Show and hide data in a chart

You can show or hide data in a chart. To hide an item, click the name of the item in the legend. In the following chart, the values for "Users" are hidden:

Figure 2. Hide chart
Hide chart

In the following chart, the values for "Users" are visible:

Figure 3. Show chart
Show charts

Zoom in on a time range

To zoom in on a time range in a graph, complete the following steps:

  1. Select a time range:
    Figure 4. Select time range
    Hide chart
  2. Click Zoom to time range:
Figure 5. Zoom to time range
Hide chart

Highlight a time range in all charts

You can highlight a time range in all the charts in a dashboard. To highlight a range in all graphs, complete the following steps:

  1. Select a time range in a chart:
  2. Select Highlight on all charts:
Figure 6. Highlight on all charts
Highlight all

To stop highlighting, click Clear highlight.

Download data from charts

You can download the data in a chart in JSON or CSV format.

To download the chart data, complete the following steps:

  1. Click a chart.
  2. Click Download JSON or Download CSV. A dialog box is displayed.
  3. Click Allow.

The JSON file or CSV file is downloaded depending on the option that you selected.

Dynamic Graph

The dynamic graph contains configuration data, dependencies, performance information, and health indicators. It drives other components of Instana, from mapping and visualization to tracing and automated root cause analysis. The dynamic graph is created and updated automatically. The definition of some components, such as services, can be further specified through service configuration.

For more information, see Leveraging the Dynamic Graph

Unbounded analytics

Unbounded analytics automatically associate data in the context you need. Either path directs you to the specific graph, bar chart, or text description that help you find the root cause. You can apply filters to the trace data set in effectively unlimited combinations to find the exact request or trace that requires attention. Information is organized and displayed in Dynamic Graph to reveal the dependencies between your application components automatically. The conditions that lead to and result from an issue are associated with that issue, so you can look forward or backward for cause and effect

Unbounded analytics uses the browser and backend trace details that are collected with the Dynamic Graph to easily understand performance issues and optimize performance. For more information, see Unbounded analytics.