Single Pane of Glass (SPOG) View

The Single Pane of Glass (SPOG) view is a real time, interactive, visual representation of all pipelines across your organization.

Each job in this view will update colors in real time based on the status of the job:

  • Green if the last run was successful
  • Red if the last run failed
  • Blue if the job is in progress
  • Dark Grey if the job is queued and waiting for available capacity
  • Light Grey if the job has never been run
  • Yellow for unstable CI jobs
  • Pink for inconsistent jobs

SPOG: Single pane of glass

To view the SPOG, do the following:

  • Navigate to your subscription dashboard.
  • Click on the eye icon with the tooltip Views.
  • Click on Show SPOG View.

SPOG: Single pane of glass

You can interact with the SPOG view in the following ways:

Zoom

The SPOG view is meant to give you one dashboard where you can have a macro view across all pipelines in your organization. However, you might want to focus on specific sections of your pipeline in some cases, like seeing a 'red' job in the pipeline for example.

You can zoom in or out of any part of the pipeline with your mouse scrollbar or with pinch-to-zoom on your mouse keypad. A zoomed representation of the pipeline is shown below:

SPOG: Single pane of glass

The search bar can opened by either clicking on the search icon on the top-right corner of the view or by using the keyboard shortcut ctrl + space

search-bar

The search bar will show the list of objects matching the search text and display them as a drop-down, an item can be selected either by clicking on it or using the keyboard shortcuts to navigate to an item (up and down arrows) and using enter to select the item after which the item will be brought to the centre and highlighted with a yellow border. In case there are multiple instances of that object in the SPOG view then you can cycle through them by using the arrow icons on the search bar or use the keyboard shortcuts enter (to iterate forward) and shift + enter (to iterate backward) and each instance will be centred and highlighted.

search-bar-item-centered

The search bar can be closed by clicking on the x icon on the search bar or by using the keyboard shortcut esc when the search input is focus.

Optionally only objects connected to the selection can be shown by clicking on the flag icon to the right edge in the list-item, this selection can be cancelled by closing the search bar.

Run/pause job

You can right click on any job to trigger a manual build or pause the job.

Run or pause a job

Please note that if you choose to trigger a manual build, the job will run with the latest input values available to it unless otherwise pinned.

Pausing a job turns off automatic triggers for the job. You can continue triggering manual builds while the job is paused.

Manual builds

You can trigger a manual build for your job by going to the jobs dashboard page and clicking on the Build button.

Manual build

On clicking the build button, you get few options which allow you to make small changes to the build that you want to run manually.

Build Config

For runSh and runCI jobs, you can provide custom environment variables.

Custom ENV

These variables will be set before the build starts.

View console output

You can click on any job in your pipeline to view console logs.

View console logs for a job

Please note that in most cases, the logs you are interested in will be under the Executing Managed Task -> /home/shippable/micro/nod/stepExec/managed//run.sh section. This section is shown as expanded in the screenshot above.

In addition to viewing logs for the latest run, you can also view logs for historical runs by choosing a past run in the UI.

Tracing upstream events and data

The first question people tend to ask when their application breaks is: what changed? Typically, the more complicated a pipeline gets, the more difficult this question becomes to answer. To make this easy on the user, Shippable has embedded trace functionality in every pipeline job. It allows you to pick any particular job in your pipeline, and view the entire tree of events that led up to that particular version of that particular job with just a few clicks. This allows you to go all the way back to the initial code commit that triggered the workflow to begin with.

The trace view shows the inputs to a given job. To get to the trace view:

  • Click on a job in the SPOG to open the console.
  • Click the Trace tab above the console. This opens a list of the job's inputs. You can drill down to see the versions of the inputs and all data for that version.

For example, let's assume your deploy job just ran and you want to see what was deployed. When you click Trace, the list shows the inputs to that deploy job:

majestic trace tab

In the image above, the deploy job has two inputs: a manifest job and a cluster resource. You can click on the image resource in the manifest to see which tag was deployed.

View in tabular format

The default view of your SPOG is graphical. However, you might want to see all jobs or resources in a table in order to quickly find a particular job or resource.

You can switch between table and graphical format by clicking on the Grid View button on your SPOG:

View SPOG in tabular format

You can take some actions on the jobs in grid view, like running or canceling builds, soft or hard deleting resources and jobs, or viewing console logs for jobs.

Filter SPOG

If you have a lot of pipelines configured, the SPOG view can get busy and it can be difficult to find a specific job or resource. You can use the flags keyword to filter SPOG for easier readability.

The flags keyword can be set in any job or resource:

jobs:
  - name: <string>
    type: <job type>
    #other job related inputs
    flags:
      - <filter name>

Once you commit this, the filters will be shown in the Filter dropdown in your SPOG view. You can choose one or more filters as shown below:

Filtering SPOG

Please note that you do not need to add flags to every job or resource in your pipeline. If we detect flags for a job or resource and you filter SPOG with that flag, the UI will display all upstream and downstream jobs and resources in the pipeline.

View orphaned and soft-deleted resources

Orphaned resources are resources that are defined in your shippable.yml but not used as inputs or outputs for any job. Soft-deleted resources and jobs are resources/jobs that are deleted from your yml files. We do not automatically delete these to avoid situations where something gets mistakenly deleted from the yml and you want to retrieve it at a later time.

To view either or both of these types of resources, click on the arrow dropdown in your SPOG pane header and choose the ones you want to view.

View orphaned or deleted resources