Troubleshooting

If you cannot find a solution to your problem in the product documentation, contact IBM Support.

If you are a SaaS user, gather the following information:

  • A direct link in the Instana UI where you observe an issue or want to make some changes.
  • A screenshot of the exact area of the issue in the Instana UI, if applicable.
  • Agent logs if the agent is turned off due to a huge impact on your system. For more information about how to collect agent logs, see Collecting agent logs.

If you are a self-hosted user, gather the following information:

  • Relevant agent or backend logs. For more information about how to collect agent or backend logs, see Collecting agent logs or Collecting backend logs.
  • A screenshot of the issue in the Instana UI.
  • Versions of software and technologies that are in use, which are relevant for the reported issue.
  • Any recent changes that impacted the system performances.

Collecting agent logs

If you have an issue on the agent side, you must follow some steps to collect the agent logs. For more information about how to collect agent logs for the following platforms, see:

To adjust log level and obtain agent debug logs, see:

Collecting backend logs

If you have an issue on the Instana backend side, you can check the backend logs. For more information about how to collect backend logs, see How to collect Instana doc for Self-hosted Instana backend environments on Kubernetes/OpenShift

Check the Instana version support policy

For more information about the Instana version support policy, see Version support policy.

Check the release notes

Review the release notes to check whether your issue is already reported and a workaround or solution exists in the docs.

Further references