Apache SkyWalking Horizon UI

Horizon UI is the next-generation web UI for Apache SkyWalking. It targets feature parity with the existing booster-ui against the same OAP GraphQL query-protocol and MQE, with a modernized dense dark-first design.

The sidebar on the left of this site is the canonical entry point — every section below has its own page there. This README is the orientation map.

How it’s organized

  • Setup — quick start, container deployment, and the horizon.yaml settings operators usually need.
  • Compatibility — OAP version, network ports, required modules, and cluster-status checks.
  • Operate — Cluster Status, Data Retention, OAP Configuration, and Metrics Inspect.
  • Access Control — local users, LDAP login, break-glass access, roles, audit log, and admin pages.
  • Customization — layer menus, dashboard templates, overview templates, and adding a layer.
  • Reference — design target and widget reference for template authors.

Quick orientation

Horizon runs as a browser UI plus a Horizon server process. The browser talks only to the Horizon server; the server talks to OAP for query, admin, and Zipkin traffic. That keeps OAP connectivity, credentials, and compatibility checks in one place.

Where to start, by role

If you are… Read first
Deploying Horizon for the first time Setup → Quick Start, then Compatibility → OAP Version.
Wiring up LDAP / configuring roles Access Control → LDAP Backend, then RBAC.
Customizing per-layer dashboards Customization → Layer Dashboard Templates.
Building a “war room” overview Customization → Overview Templates.
Diagnosing a “module disabled” warning Compatibility → Required OAP Modules, then Operate → Cluster Status.

Live demo

The Apache SkyWalking project runs a public OAP demo at demo.skywalking.apache.org/graphql (basic auth skywalking:skywalking). Horizon’s horizon.yaml can point at it for smoke-testing:

oap:
  queryUrl: https://demo.skywalking.apache.org
  auth:
    username: skywalking
    password: skywalking

The demo exposes the GraphQL query port only; the admin REST port — and therefore the Cluster, Inspect, DSL Management, and Live Debugger pages — is not reachable from outside.

References