From 2ad776553a7b0281ee1000f4fe51131be3af0381 Mon Sep 17 00:00:00 2001 From: Alexander Schwartz Date: Tue, 8 Apr 2025 12:23:28 +0200 Subject: [PATCH] Adding a guide on how to enable and use exemplars Closes #38688 Signed-off-by: Alexander Schwartz --- docs/guides/images/observability/exemplar.png | Bin 0 -> 126028 bytes docs/guides/observability/exemplars.adoc | 101 ++++++++++++++++++ .../observability/grafana-dashboards.adoc | 6 ++ .../metrics-for-troubleshooting-http.adoc | 3 + docs/guides/observability/pinned-guides | 1 + docs/guides/observability/tracing.adoc | 1 + .../keycloak/it/cli/dist/MetricsDistTest.java | 16 +++ 7 files changed, 128 insertions(+) create mode 100644 docs/guides/images/observability/exemplar.png create mode 100644 docs/guides/observability/exemplars.adoc diff --git a/docs/guides/images/observability/exemplar.png b/docs/guides/images/observability/exemplar.png new file mode 100644 index 0000000000000000000000000000000000000000..14f35f65f4c27f84b9b9502249e14782813e326e GIT binary patch literal 126028 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 z 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

&9vTEAjr7gQW(6vPoU-fo?>pOx5CGUT?eS=A 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 literal 0 HcmV?d00001 diff --git a/docs/guides/observability/exemplars.adoc b/docs/guides/observability/exemplars.adoc new file mode 100644 index 00000000000..6e700988e0c --- /dev/null +++ b/docs/guides/observability/exemplars.adoc @@ -0,0 +1,101 @@ +<#import "/templates/guide.adoc" as tmpl> +<#import "/templates/links.adoc" as links> + +<@tmpl.guide +title="Analyzing outliers and errors with exemplars" +summary="Use exemplars to connect a metric to a recorded trace to analyze the root cause of errors or latencies."> + +Metrics are aggregations over several events, and show you if your system is operating within defined bounds. +They are great to monitor error rates or tail latencies and to set up alerting or drive performance optimizations. +Still, the aggregation makes it difficult to find root causes for latencies or errors reported in metrics. + +Root causes for errors and latencies can be found by enabling tracing. +To connect a metric to a recorded trace, there is the concept of https://grafana.com/docs/grafana/latest/fundamentals/exemplars/[exemplars]. + +Once exemplars are set up, {project_name} reports metrics with their last recorded trace as an exemplar. +A dashboard tool like Grafana can link the exemplar from a metrics dashboard to a trace view. + +Metrics that support exemplars are: + +* `http_server_requests_seconds_count` (including histograms) + +See the {section} <@links.observability id="metrics-for-troubleshooting-http"/> for details on this metric. + +* `keycloak_credentials_password_hashing_validations_total` + +See the {section} <@links.observability id="metrics-for-troubleshooting-keycloak"/> for details on this metric. + +* `keycloak_user_events_total` + +See the {section} <@links.observability id="metrics-for-troubleshooting-keycloak"/> for details on this metric. + +See below for a screenshot of a heatmap visualization for latencies that is showing an exemplar when hovering over one of the pink indicators. + +.Heatmap diagram with exemplar +image::observability/exemplar.png[] + +== Setting up exemplars + +To benefit from exemplars, perform the following steps: + +. Enable metrics for {project_name} as described in {section} <@links.observability id="configuration-metrics" />. + +. Enable tracing for {project_name} as described in {section} <@links.observability id="tracing" />. + +. Enable exemplar storage in your monitoring system. ++ +For Prometheus, this is a https://prometheus.io/docs/prometheus/latest/feature_flags/#exemplars-storage[preview feature that you need to enable]. + +. Scrape the metrics using the `OpenMetricsText1.0.0` protocol, which is not enabled by default in Prometheus. ++ +If you are using `PodMonitors` or similar in a Kubernetes environment, this can be achieved by adding it to the spec of the custom resource: ++ +[source] +---- +apiVersion: monitoring.coreos.com/v1 +kind: PodMonitor +metadata: + ... +spec: + scrapeProtocols: + - OpenMetricsText1.0.0 +---- + +. Configure your metrics datasource where to link to for traces. ++ +When using Grafana and Prometheus, this would be setting up a `exemplarTraceIdDestinations` for the Prometheus datasource, which then points to your tracing datasource that is provided by tools like Jaeger or Tempo. + +. Enable exemplars in your dashboards. ++ +Enable the *Exemplars* toggle in each query on each dashboard where you want to show exemplars. +When set up correctly, you will notice little dots or stars in your dashboards that you can click on to view the traces. + +[NOTE] +==== +* If you do not specify the scrape protocol, Prometheus will by default not send it in the content negotiation, and Keycloak will then fall back to the PrometheusText protocol which will not contain the exemplars. +* If you enabled tracing and metrics, but the request sampling did not record a trace, the exposed metric will not contain any exemplars. +* If you access the metrics endpoint with your browser, the content negotiation will lead to the format PrometheusText being returned, and you will not see any exemplars. +==== + +== Verifying that exemplars work as expected + +Perform the following steps to verify that {project_name} is set up correctly for exemplars: + +. Follow the instructions to set up metrics and tracing for {project_name}. +. For test purposes, record all traces by setting the tracing ration to `1.0`. +See <@links.observability id="tracing" anchor="sampling" /> for recommended sampling settings in production systems. +. Log in to the Keycloak instance to create some traces. +. Scrape the metrics with a command similar to the following and search for those metrics that have an exemplar set: ++ +[source] +---- +$ curl -s http://localhost:9000/metrics \ +-H 'Accept: application/openmetrics-text; version=1.0.0; charset=utf-8' \ +| grep "#.*trace_id" +---- ++ +This should result in an output similar to the following. Note the additional `#` after which the span and trace IDs are added: ++ +[source] +---- +http_server_requests_seconds_count {...} ... # {span_id="...",trace_id="..."} ... +---- + + diff --git a/docs/guides/observability/grafana-dashboards.adoc b/docs/guides/observability/grafana-dashboards.adoc index 03a90ed6460..059ed5c6e0e 100644 --- a/docs/guides/observability/grafana-dashboards.adoc +++ b/docs/guides/observability/grafana-dashboards.adoc @@ -14,6 +14,7 @@ This guide provides instructions on how to visualize collected {project_name} me * {project_name} metrics are enabled. Follow <@links.observability id="configuration-metrics"/> {section} for more details. * Grafana instance is running and {project_name} metrics are collected into a Prometheus instance. +* For the HTTP request latency heatmaps to work, enable histograms for HTTP metrics by setting `http-metrics-histograms-enabled` to `true`. == {project_name} Grafana dashboards @@ -93,4 +94,9 @@ Exporting a dashboard to JSON format may be useful. For example, you may want to ++++ ++++ + +== Further reading + +Continue reading on how to connect traces to dashboard in the <@links.observability id="exemplars" /> {section}. + diff --git a/docs/guides/observability/metrics-for-troubleshooting-http.adoc b/docs/guides/observability/metrics-for-troubleshooting-http.adoc index 4c85260184c..6d80554e06b 100644 --- a/docs/guides/observability/metrics-for-troubleshooting-http.adoc +++ b/docs/guides/observability/metrics-for-troubleshooting-http.adoc @@ -5,6 +5,7 @@ title="HTTP metrics" summary="Learn about metrics for monitoring the {project_name} HTTP requests processing" tileVisible="false" +includedOptions="http-metrics-histograms-enabled http-metrics-slos" > <#include "partials/prerequisites-metrics-troubleshooting.adoc" /> @@ -37,6 +38,8 @@ m| http_server_requests_seconds_sum | The total duration for all the requests processed. |=== +You can enable histograms for this metric by setting `http-metrics-histograms-enabled` to `true`, and add additional buckets for service level objectives using the option `http-metrics-slos`. + include::partials/histogram_note_http.adoc[] === Active requests diff --git a/docs/guides/observability/pinned-guides b/docs/guides/observability/pinned-guides index 9a48de8820e..ad86dfbc991 100644 --- a/docs/guides/observability/pinned-guides +++ b/docs/guides/observability/pinned-guides @@ -13,3 +13,4 @@ metrics-for-troubleshooting-embedded-caches-multi-site metrics-for-troubleshooting-external-infinispan-multi-site tracing grafana-dashboards +exemplars diff --git a/docs/guides/observability/tracing.adoc b/docs/guides/observability/tracing.adoc index d93fea863f5..210fe2befd9 100644 --- a/docs/guides/observability/tracing.adoc +++ b/docs/guides/observability/tracing.adoc @@ -135,6 +135,7 @@ WARNING: For a production-ready environment, sampling should be properly set to The used sampler can be changed via the `tracing-sampler-type` property. +[[sampling]] === Default sampler The default sampler for {project_name} is `traceidratio`, which controls the rate of trace sampling based on a specified ratio configurable via the `tracing-sampler-ratio` property. diff --git a/quarkus/tests/integration/src/test/java/org/keycloak/it/cli/dist/MetricsDistTest.java b/quarkus/tests/integration/src/test/java/org/keycloak/it/cli/dist/MetricsDistTest.java index e2f147c0879..68ff32f68b7 100644 --- a/quarkus/tests/integration/src/test/java/org/keycloak/it/cli/dist/MetricsDistTest.java +++ b/quarkus/tests/integration/src/test/java/org/keycloak/it/cli/dist/MetricsDistTest.java @@ -20,6 +20,7 @@ package org.keycloak.it.cli.dist; import static io.restassured.RestAssured.given; import static io.restassured.RestAssured.when; import static org.hamcrest.Matchers.containsString; +import static org.hamcrest.Matchers.matchesPattern; import static org.hamcrest.Matchers.not; import static org.junit.jupiter.api.Assertions.assertThrows; @@ -130,6 +131,21 @@ public class MetricsDistTest { } + @Test + @Launch({ "start-dev", "--metrics-enabled=true", "--tracing-enabled=true" }) + void testMetricsEndpointWithCacheMetricsHistogramsAndExemplars(KeycloakDistribution distribution) { + runClientCredentialGrantWithUnknownClientId(distribution); + + distribution.setRequestPort(9000); + // Exemplars are only present when metrics and traces are enabled + given().accept("application/openmetrics-text; version=1.0.0; charset=utf-8"); + when().get("/metrics").then() + .statusCode(200) + // http_server_requests_seconds_count{method="GET",outcome="CLIENT_ERROR",status="404",uri="NOT_FOUND"} 7.0 # {span_id="59fb88a687095d04",trace_id="a4d15d4deaa6f6ee7ac2da092f292925"} 1.0 1743780073.651 + .body(matchesPattern("(?s).*http_server_requests_seconds_count.*,trace_id=.*")); + + } + @Test @Launch({ "start-dev", "--metrics-enabled=true", "--features=user-event-metrics", "--event-metrics-user-enabled=true" }) void testMetricsEndpointWithUserEventMetrics(KeycloakDistribution distribution) {