Overview
Upon logging in, you are first taken to the activity screen, which lists all the changes and workflow runs that are available to you. The left pane, used for navigation, lists the operations you can perform. The top pane allows you to log out, as well as condense the navigation bar thereby gaining more screen real estate.
The table below lists the key areas available in this screen.
| Key | Element | Description |
|---|---|---|
| A | Burger icon | Condense/expand the navigation bar. |
| B | Search | Search pages, resources, steps and activity, or run a command. Press Ctrl+L (⌘+L on a Mac) to open it from anywhere. See search. |
| C | Run activity | Run a change or a workflow. |
| D | User preferences, secret tool and theme selection | Logged in user notification preferences, the secret tool and theme selection (light and dark themes are available). The secret tool has a Secret vault tab to store or retrieve secret values and files in the secret vault — a stored value can be entered, uploaded as a file, or auto-generated by the vault — and an AES encryption tab to encrypt values without touching the vault. |
| E | List filters | Allows you to filter the contents of the list by various criteria. When filters are applied, the URL is updated to reflect the filters selected, making it easy to share the current view with others. The filters are persisted locally in the browser, so they will be remembered between sessions. |
| F | List interface | Each row in the list represents a change or workflow run matching the current filters and available to the user. The columns displayed can be customised. |
| G | Administrative navigation bar | Provides access to OpsChain administrative functions and policy management. The administration menu is available only for users with administrative privileges. |
| H | Manage activity | Manage activity waiting for the current user's approval or continuation. The total count of activities waiting is displayed beside the text. |
The top pane also shows an active runs indicator, displaying the number of changes and workflow runs that are currently in flight across all projects, environments and assets you can access. Selecting it opens a list of those runs, each linking through to its activity details.
The dashboard
The dashboard charts the changes and workflow runs created in a time range you choose, as a grid of panels, alongside panels showing what is happening now, such as the steps waiting for your approval and the most recent activities.
The toolbar above the panels sets the time range - a quick range, or From and To dates - and can group the charts by hour, day, week or month, limit them to changes or workflows, and limit them to the projects you pick. The refresh button fetches the figures again, and its dropdown refreshes them automatically. On a narrow screen these controls fold into a Filters button.
Click a segment, bar or point on a chart to list the changes and workflow runs behind it. Type in Quick search to filter the list, and click a run to open its activity details.
Arranging the dashboard
Open Add panels to see every panel with its description, and drag a panel onto the dashboard. Drag a panel by its title bar to move it, and by its bottom-right corner to resize it; hover over it and click the cross to remove it. The button beside Add panels resets the dashboard to its default layout.
The layout and the toolbar settings are saved in your browser, so the dashboard looks the same next time you open it there. On a narrower screen the panels reflow into fewer columns, and a layout you arrange at that width is kept for it.
Downloading lists and logs
The activity, projects, environments, assets and agents lists each have a CSV button that downloads every row matching the current filters as a CSV file. The activity download lists its changes and workflow runs oldest first, whatever sort the list is using. Each file is named after the project, environment or asset the list belongs to — bank_dev_assets.csv for the assets of the dev environment in the bank project, for example.
Each log viewer, and the log dialog on the pods screen, has a Download button that saves the whole log as a .log file, oldest line first, with each line's timestamp and category. A change's log download includes its child steps' lines when the viewer is showing them.
Both downloads stream from the server straight to disk, so a large list or log does not have to load in the browser first. The buttons are disabled, with the tooltip Nothing to download, while the list or log is empty.