DumbMonit

IntegrationsSecurity and identity

Monitor Keycloak with DumbMonit

Beta

Readiness and database health, version, realms (disabled ones), active sessions and users per realm.

DocumentationOfficial website: Keycloak

Product descriptions are in English, as in the product. The page labels follow your language.

What DumbMonit watches

Whether Keycloak can really log people in: readiness with the database check, version, realms (a disabled one is a locked-out population), and, with a service account, active sessions and users per realm.

Typical use. Identity: readiness and database, realms, sessions, users

Examples

  • Keycloak 25 and later
  • Keycloak 24 and earlier

How it connects

What you need

  • Client ID / secretA service-account client with read-only roles. DumbMonit asks for a token at each probe.

No account needed.

Network ports to open

  • 8080/TCPAPI (HTTP, default)
  • 9000/TCPHealth checks on the management port (Keycloak 25 and later)
  • 443/TCPOnly with the https scheme behind a reverse proxy
Setup steps: Let DumbMonit read Keycloak's health and realms
  1. Run Keycloak with health checks on, with the option below. From Keycloak 25 they answer on the management port 9000.

    KC_HEALTH_ENABLED=true
  2. Optional, for realms, sessions and users: in the master realm, create a client named as follows, with Client authentication and Service accounts roles on, and Standard flow off.

    dumbmonit
  3. On that client's Service accounts roles tab, assign the client roles listed below, then copy the secret from its Credentials tab.

  4. In DumbMonit, enter Keycloak's address and the client ID and secret, or choose None (health checks only).

Heads-up. Keycloak 24 and earlier serve the health checks on the main port: set the health port option to same. Health checks must be enabled on the server, or DumbMonit reports a missing /health/ready.