Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana Access/Login issues. Before contacting IBM® support for assistance, please review the information below to familiarize yourself with the troubleshooting process.
Resolving The Problem
To explore potential solutions, search for issues, access documentation, or visit support forums, head to the IBM® Support page. If you are aware of the affected component, refer to the relevant MustGather details below:
Monitored environment details
- Type of instana deployment (Self-hosted or SaaS)
- Self -hosted:
- single-domain install or multi-subdomain installation (ideally a debug archive and version)
- SaaS:
- tenant-unit (URL)
- Self -hosted:
- OS (Linux/Windows, etc.) and version
- Browser and version
Data to collect based on issue type
Follow the steps below for your specific issue. See detailed instructions further below for how to collect each kind of data.
Login related issues:
- What authentication mechanism is being used (username+password / LDAP / OIDC / SAML / MCSP)?
- If using username+password, is MFA configured?
- If using an IdP (LDAP / OIDC / SAML /MCSP), is the system operational and currently reachable by the Instana installation (incl. potential SSL issues)?
- If IP-Filtering is IP-Filtering configured), we do need to know the complete configuration and the end-users’ IP address.
- The complete url on which you are trying to login (including Query parameters).
- Collect the HAR file
Access related issues:
- Specific to the access (after a successful login) we do need to know more details:
- The id and email address of the user, who is facing the issue.
- The selected scope
- Assigned teams, roles/groups and their configuration at the time that the issue occurred.
- Collect UI information
Detailed data collection instructions
Google Chrome:
- Open Chrome and go to the page where you're experiencing the issue.
- Press F12 on your keyboard (or right-click anywhere on the page and select Inspect).
- Click on the Console tab at the top of the panel that opens.
- In the input field, type ‘instana’ and press enter.
- On the result, press right click and select ‘Copy’ object.
- Save the content to a file to your computer and send it to us.
Mozilla Firefox:
- Open Firefox and go to the page where you're experiencing the issue.
- Press F12 on your keyboard (or right-click anywhere on the page and select Inspect).
- Click on the Console tab at the top of the panel that opens.
- In the input field, type ‘instana’ and press enter.
- On the result, press right click and select ‘Copy’ object.
- Save the content to a file to your computer and send it to us.
Microsoft Edge:
- Open Edge and navigate to the page with the issue.
- Press F12 on your keyboard (or right-click anywhere on the page and select Inspect).
- Click on the Console tab at the top of the panel that opens.
- In the input field, type ‘instana’ and press enter.
- On the result, press right click and select ‘Copy’ object.
- Save the content to a file to your computer and send it to us.
Safari:
- First, enable the Developer Tools:
go to Safari → Settings → Advanced and check "Show features for web developers". - Navigate to the page with the issue.
- From the menu bar, click Develop → Show Web Inspector.
- Click on the Console tab.
- In the input field, type ‘instana’ and press enter.
- On the result, press right click and select ‘Copy’ object.
- Save the content to a file to your computer and send it to us.
In general, we try to avoid requesting a HAR file, it sometimes however is not avoidable. After generating the har file, explicitly logging out from Instana prevents others from using your session.
How to export a HAR file from your browser
A HAR file is a recording of everything your browser does while loading a webpage. It helps our support team diagnose issues you might be experiencing. Follow the steps below for your browser.
Google Chrome:
- Open Chrome and go to the page where you're experiencing the issue.
- Press F12 on your keyboard (or right-click anywhere on the page and select Inspect).
- Click on the Network tab at the top of the panel that opens.
- Reload the page by pressing F5 - you'll see a list of entries appear.
- Reproduce the issue.
- Right-click anywhere in the list of entries and select Save all as HAR with content.
- Save the file to your computer and send it to us.
Mozilla Firefox:
- Open Firefox and go to the page where you're experiencing the issue.
- Press F12 on your keyboard (or right-click and select Inspect).
- Click on the Network tab.
- Reload the page by pressing F5.
- Reproduce the issue.
- Click the gear icon (⚙) in the top-right corner of the Network panel and select Save All as HAR.
- Save the file and send it to us.
Microsoft Edge:
- Open Edge and navigate to the page with the issue.
- Press F12 (or right-click and select Inspect).
- Click on the Network tab.
- Reload the page by pressing F5.
- Reproduce the issue.
- Right-click anywhere in the list of entries and select Save as HAR with content.
- Save the file and send it to us.
Safari:
- First, enable the Developer Tools:
go to Safari → Settings → Advanced and check "Show features for web developers". - Navigate to the page with the issue.
- From the menu bar, click Develop → Show Web Inspector.
- Click on the Network tab.
- Reload the page.
- Reproduce the issue.
- Click the Export button (↓) in the top-right corner of the Network tab.
- Save the file and send it to us.
NOTE: The HAR file may contain sensitive information such as cookies or form data. Please share this information with our support team only via the support case.
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
14 June 2026
UID
ibm17275308