IBM Support

MustGather: Instana Keycloak Sensor

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana Keycloak Sensor. 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:

MustGather Data Collection Requirements for Instana Keycloak Sensor

Monitored environment details:
 
  • Kind of deployment (Single host , Kubernetes, docker, podman, AWS Fargate)
  • OS (Linux/ Windows) and version
  • SaaS url of the agent monitoring the Keycloak instance
  • Keycloak version
 
Agent logs:
 
  • Collect the Instana agent debug log:
    • See the MustGather page for Instana Agent for more details
 
Agent configuration:
 
  • Collect <instana-agent-dir>/etc/instana/configuration.yaml 
 
Additional output & files to collect:
 
  • Provide output of CLI flags OR environment variables (per docs). For example:
    • kubectl exec -n <keycloak-namespace> <keycloak-pod> -- env | grep KC_
  • Provide output that checks if the metrics endpoint is available. For example:
    • kubectl exec -n --<keycloak-namespace> <keycloak-pod> -- curl -s http://localhost:9000/metrics
  • Provide output that checks if the health endpoint is available. For example:
    • kubectl exec -n <keycloak-namespace> <keycloak-pod> http://localhost:9000/health
  • Provide output to verify if Keycloak metrics are present. For example:
    • kubectl exec -n <keycloak-namespace> <keycloak-pod> -- curl -s http://localhost:9000/metrics | grep keycloak-- curl -s http://localhost:9000/metrics-- env | grep KC_

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSE1JP5","label":"IBM Instana Observability"},"ARM Category":[{"code":"a8m3p000000UoUBAA0","label":"Sensors - Setup \u0026 Discovery"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.0.281;1.0.282;1.0.283;1.0.284;1.0.285;1.0.286;1.0.287;1.0.288;1.0.289;1.0.290;1.0.291;1.0.292;1.0.293;1.0.294;1.0.295;1.0.296;1.0.297;1.0.298;1.0.299;1.0.300;1.0.301;1.0.302;1.0.303;1.0.304;1.0.305;1.0.306;1.0.307;1.0.308;1.0.309;1.0.310;1.0.311;1.0.312;1.0.313;1.0.314;1.0.315;1.0.316;1.0.317;1.0.318"}]

Document Information

Modified date:
25 April 2026

UID

ibm17270056

Page Feedback