KNIME Documentation

User usage monitoring ​

The User Usage Monitoring data app gives you insight into how users interact with your Knime instance:

  • Monitor active users and detect unused license seats.
  • Analyze peak login times to identify usage patterns.

Configure a Keycloak service client ​

This data app requires a Keycloak service client that can retrieve session events.

  1. Log in to the Keycloak Admin Console at https://auth.<base-url> (see Access Keycloak for users management).

  2. Select the knime realm (or your custom realm).

  3. Under Realm Settings > Events > User events settings, activate Save events and define how many days to keep session events.

    Activate Save events in Realm Settings > Events > User events settings

    Select Add saved types and include the refresh token event.

    Add saved types in Realm Settings > Events > User events settings

  4. Create a new client under Clients.

    Create a client in Keycloak

    Provide a Client ID (for example, monitor-user-usage) and optionally a name and description.

    Set the client ID

  5. Under Capability config, enable Client authentication and select Service account roles. Save the client.

    Enable Client authentication and Service account roles

  6. Open the new client and configure its service account roles.

    Assign roles to the service account

    Filter by clients, search for view-events, and assign the role.

    Assign the view-events role

    Assign the manage-users role as well.

    Assign the manage-users role

  7. Retrieve the Client ID and Client secret from the Credentials tab.

    Retrieve the Client ID and Client secret

Deploy the data app ​

Follow the general data app deployment steps. When you reach the run configuration, also provide the Keycloak service client ID and secret you gathered above.

Configure the Keycloak service client ID and secret