Skip to main content
RLaaS Users Service ships with Spring Boot Actuator, Micrometer Prometheus integration, and OTLP push support. You can scrape metrics from a Prometheus endpoint or push them directly to Grafana Cloud — or do both simultaneously. No additional instrumentation code is required; everything is configured through environment variables and application.yaml.

Available Actuator endpoints

EndpointDescription
GET /actuator/healthService health status
GET /actuator/infoApplication info
GET /actuator/prometheusPrometheus-format metrics
GET /actuator/metricsJSON metrics
All four endpoints are enabled by default. You do not need to change any configuration to access them in a standard deployment.

Prometheus scraping

To scrape metrics locally, call the Prometheus endpoint directly:
curl http://localhost:8080/actuator/prometheus
Every metric exposed by this endpoint automatically includes the tag application=rlaas-users-service. This tag is injected by the following config in application.yaml:
management:
  metrics:
    tags:
      application: ${spring.application.name}
Use this tag in your Prometheus queries and Grafana dashboards to filter metrics to this service. For example:
http_server_requests_seconds_count{application="rlaas-users-service"}

OTLP push to Grafana Cloud

RLaaS can push metrics to Grafana Cloud over OTLP every 30 seconds. Set the following environment variables before starting the service:
VariableDescription
OTEL_EXPORTER_OTLP_METRICSFull OTLP endpoint URL for your Grafana Cloud stack
OTEL_AUTHORIZATIONAuthorization header value (e.g., Basic <base64-encoded credentials>)
Once set, metrics are pushed automatically. The push interval is fixed at 30 seconds and is configured in application.yaml:
management:
  otlp:
    metrics:
      export:
        url: ${OTEL_EXPORTER_OTLP_METRICS}
        headers:
          Authorization: ${OTEL_AUTHORIZATION}
        step: 30s

Grafana Cloud setup

1

Find your Grafana Cloud stack details

Log in to Grafana Cloud and navigate to your stack. Note your zone, instance ID, and generate an API key with MetricsPublisher role.
2

Set the required environment variables

export GRAFANA_CLOUD_ZONE=<your-zone>              # e.g., prod-us-central-0
export GRAFANA_CLOUD_INSTANCE_ID=<your-instance>  # numeric Prometheus instance ID
export GRAFANA_CLOUD_API_KEY=<your-api-key>
Then derive the OTLP variables from these:
export OTEL_EXPORTER_OTLP_METRICS="https://otlp-gateway-${GRAFANA_CLOUD_ZONE}.grafana.net/otlp/v1/metrics"
export OTEL_AUTHORIZATION="Basic $(echo -n "${GRAFANA_CLOUD_INSTANCE_ID}:${GRAFANA_CLOUD_API_KEY}" | base64)"
3

Start the service

Start RLaaS with the environment variables in scope. The OTLP exporter will connect automatically and begin pushing metrics within the first 30-second interval.
The application label is automatically added to all metrics using the value of spring.application.name (rlaas-users-service). Use this label in Grafana to filter dashboards to this service.

Build docs developers (and LLMs) love