Web User Interface¶
The Application Manager user interface (UI) is available alongside its REST API.
By default, you can reach it by navigating to
[container] is the address of the container running Application Manager.
More information on accessing Application Manager.
Where the REST API is meant for integrating Application Manager with infrastructure components, the UI is meant for interaction by humans to control and track deployments. Its overarching goals are to simplify some of the domain concepts, allow quick changes to be made to resources, and to give actionable insight into the current state of Application Manager.
Deployments are one of the main concepts of Application Manager. When opening the UI, the first page shows an overview list of all available deployments, including their current and desired status. Creating new deployments through the UI is straightforward. Click on “Create Deployment” in the top right, and go through the creation form.
Clicking on a deployment on the overview page opens the deployment detail page.
The deployment detail page and all its sub-pages share an action bar. It contains the essential actions you can take on a deployment: modification, lifecycle control (start, suspend, cancel), savepointing, and forking, as well as links to external services (i.e., Apache Flink, logging, and metrics).
Some buttons and links are automatically disabled if their actions are not available. For example, you can only delete a deployment if it is not running.
Pressing the “Savepoint” button triggers a savepoint in Flink.
The “Fork” button creates a copy of the current deployment.
- Below the action bar, there are four different tabs:
- “Overview” lists the currently active configuration, including resource limits and the Flink configuration.
- “Events” shows the Event Log of the current deployment
- “Jobs” lists all Flink jobs (past and potentially running ones) created from the deployment.
- “Savepoints” lists all savepoints created for this deployment.
On both the deployment overview page and the deployment detail page, Application Manager is always showing the current status of a deployment. Due to the declarative nature of the system, we are always showing the “desired” and “current” state of a deployment.
On the deployment detail page, the status box shows additional information when the current state is in “transitioning”.
The event tab shows the Event Log of the current deployment. At the top, there is an input field for filtering events from the table.
In the table below we show the time of the event, a human-readable message, and an action drop-down for events associated with a job. The event log is useful for following state transitions or checking what happened with an earlier deployment.
A different background color indicates new events in the overview table, and a small indicator on the “Events” tab shows the number of unread events.
The jobs tab lists all (past and currently running) Flink jobs created from the deployment. Each row in the jobs table is clickable and doing so opens a window listing the configuration that was effective for the job, and all savepoints created for that job. Also, there are links to integrated metrics and logging. The link to the logging system only shows the logs from that job.
The savepoints tab lists all savepoints created for this deployment. The table on that page links to the specific job that was running when the savepoint was created.
The action button can be used to perform the following tasks:
- Copy URI to Clipboard: This copies the location of the savepoint files into the clipboard. The location, based on the configured
state.savepoints.dirof the Flink configuration of the deployment, can be used to access the savepoint location outside of Application Manager.
- Reset to Savepoint: Invoking this action performs the following steps:
- The selected savepoint is copied so that it becomes the “latest” savepoint. This step does not physically copy the savepoint files; it just creates an additional representation of a savepoint in Application Manager.
- If the “Start from Savepoint” field is set to “LATEST”, Application Manager resets the state of the currently running job to the state of the savepoint.
- Fork Deployment from Savepoint: This action creates a copy of the current deployment using the selected savepoint. Doing so permits using the Flink state of one deployment in a second environment, without affecting the originating job.
The settings tab allows you to configure namespaces, access controls, API tokens, secret values, and deployment targets.