Deploy the observability stack

Install and start the flightctl-observability RPM package so that Prometheus scrapes metrics from Red Hat Edge Manager components and Grafana visualizes them.

Before you begin

  • You are logged in to the host machine running Red Hat Enterprise Linux 9.7 or later, or a compatible RPM-based Linux distribution.
  • Red Hat Edge Manager services are installed by using the flightctl-services RPM package, as described in Installing the Red Hat Edge Manager RPM package.
Note

For disconnected environments, complete Installing the observability stack in disconnected environments before you follow the connected-install procedure below.

Procedure

  1. Install the flightctl-observability RPM package: 
    sudo dnf install -y flightctl-observability
  2. Start and enable the observability stack: 
    sudo systemctl enable --now flightctl-observability.target

Results

  1. Verify that all services are running: 
    sudo systemctl status flightctl-observability.target

    Verify that the following services are in active (running) state:

    • flightctl-prometheus.service
    • flightctl-grafana.service
    Note

    flightctl-userinfo-proxy.service runs only when userinfoProxy.upstreamUrl is configured for Red Hat Ansible Automation Platform OAuth integration. For the default local Grafana authentication flow, do not expect this service to be active (running); it is normal for it to be inactive or failed until you configure OAuth.
  2. Verify that Prometheus is scraping Red Hat Edge Manager metrics: 
    sudo podman exec flightctl-prometheus wget -qO- http://localhost:9090/api/v1/targets 2>/dev/null | \
  jq -r '.data.activeTargets[] | select(.labels.job | contains("flightctl")) | {job: .labels.job, health: .health}'

    The output shows healthy targets for both the API and the Telemetry Gateway.

  3. Access the Grafana UI at https://<your_host>:3000 with username admin and password admin. Older installations might use the default password defaultadmin.
  4. In the Grafana UI, open Dashboards in the left sidebar. Verify that dashboards are available for the Red Hat Edge Manager API (API server, database, and agent connectivity metrics) and for fleet health, rollout status, and application metrics. Dashboard titles match the definitions shipped with the observability package.