Web User Interface¶
The Application Manager user interface (UI) is available alongside its REST API.
By default, you can reach it by navigating to http://[container]:8080/, where [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.
Namespaces¶
By default, the web UI will redirect you to the default namespace. You can work with resources in other namespaces by manually setting the respective namespace in the URL, e.g. by replacing default in https://appmgr/#/namespaces/default/deployments with your desired namespace.
The UI will pick this up and do all requests against the respective namespace.
Deployment Overview¶
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.
The homepage lists all your deployments, and allows you to create a new one. Click on a deployment to learn more about it.
Deployment Details¶
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 primary 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 will trigger 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.
Status Box¶
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.
Deployment status box. In this example, the desired state of the deployment is set to “suspended”, but the deployment is not yet suspended, and thus in a “transitioning” state.
On the deployment detail page, the status box shows additional information when the current state is in “transitioning”.
Application Manager shows the steps of a transition and their completion.
Overview Tab¶
The “Overview” tab will give you a summary of the deployment configuration:
Deployment detail page with the action bar and a summary of all the currently active configuration parameters.
Events Tab¶
The event tab shows the Event Log of the current deployment. At the top there is a 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 very useful for following state transitions or checking what happened with a earlier deployment.
New events are indicated by a different background color in the overview table, and a small indicator on the “Events” tab shows the number of unread events.
Deployment detail page with the event log.
Jobs Tab¶
The jobs tab lists all (past and currently running) Flink jobs created from the deployment. Each row in the jobs table is clickable. This opens a window listing the configuration that was effective for the job, and all savepoints created for that job. Also, there are links to the metrics and logging integration. The link to the logging system will only show the logs from that job.
Savepoints Tab¶
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 is based on the configured
state.savepoints.dirof the Flink configuration of the deployment. This URI 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 will reset the state of the currently running job to the state of the savepoint.
- Fork Deployment from Savepoint: This action will create a copy of the current deployment using the selected savepoint. This permits using the Flink state of one deployment in a second environment, without affecting the originating job.
Deployment Targets and Settings¶
These two pages list the configured deployment targets and version information about the Application Manager build.