Edge UI Plugin and REST API¶

The Edge provider uses a Plugin to

Extend the REST API endpoints for connecting workers to the Airflow cluster
Provide a web UI for managing the workers and monitoring their status and tasks (Note: The UI is currently only available in Airflow 2.10+, implementation for Airflow 3.0 depends on completion of AIP-68)

REST API endpoints¶

The Edge provider adds the following REST API endpoints to the Airflow API:

/api/v1/edge/health: Check that the API endpoint is deployed and active
/api/v1/edge/jobs: Endpoints to fetch jobs for workers and report state
/api/v1/edge/logs: Endpoint to push log chunks from workers to the Airflow cluster
/api/v1/edge/workers: Endpoints to register and manage workers, report heartbeat

To see full documentation of the API endpoints open the Airflow web UI and navigate to the sub-path /edge_worker/v1/docs (Airflow 3.0) or /edge_worker/v1/ui (Airflow 2.10).

Web UI Plugin (Airflow 2.10 only)¶

Note

As of time of writing the web UI to see edge jobs and manage workers is not ported to Airflow 3.0. Until this is available you can use the CLI commands as described in Worker Maintenance Management CLI.

The Edge provider adds a web UI plugin to the Airflow web UI. The plugin is made to be able to see job queue and Edge Worker status.

Pending and processes tasks can be checked in “Admin” - “Edge Worker Jobs” page.

Worker status can be checked via the web UI in the “Admin” - “Edge Worker Hosts” page.

Via the UI you can also set the status of the worker to “Maintenance” or “Active”.

The status and maintenance comments will also be shown in the web UI in the “Admin” - “Edge Worker Hosts” page.

Note that maintenance mode can also be adjusted via CLI. See Worker Maintenance Mode for more details.