Monitoring Current Jobstream Runs with the Timeline View (Web UI)

{"URL":["/aai/web/v2/jobstreams/runs/timeline"],"heroDescriptionIdentifier":"JobstreamRuns_Timeline_view_Intro","customCards":[{"id":"ice_jobstreams_timeline_view_desc","title":"The Timeline View Page","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"ice_jobstreams_timeline_FilteringByDateRange","title":"Filtering Data By Date Range","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"ice_jobstreams_timeline_FilteringBy","title":"Filtering Data by Business Area","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"ice_jobstreams_timeline_BAsAndAggregatedStatus","title":"Business Area and Aggregated Status Pane","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"ice_jobstreams_timeline_understanding_timeline","title":"Understanding the Timeline Pane","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"ice_jobstreams_timeline_drilling_down","title":"Drilling Down into the Jobstream and Jobstream Run Details","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreams_JSRuns_Viewing_Timeline.htm"},{"id":"About_Monitoring_Jobstreams","title":"About the Views to Monitor Jobstreams","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/TERMA_DOCU/*.*/AAI%20Guides/Content/Jobstreams/Jobstreasm_Wkg_JS_Runs_Landing_Page.htm"}]}

The Jobstream Runs - Timeline is an intuitive top level visualization of the current status of your jobstreams and jobstream runs. It provides data per business area and filtered by a date range that goes from 7 days prior to 4 days after the current timestamp. The timeline view shows the performance of your jobstreams relative to their SLAs. It also provides aggregated data on the status (done, running and future) of both the individual jobstream runs and of all the jobstream runs within each business area. This view is a good starting point to investigate jobstreams that are not behaving as expected.

This page describes the Jobstream Runs - Timeline and its associated functions:

Overview

jobstream timeline view

The Jobstream Runs - Timeline page is divided in four areas.

Upper area containing the following:
- Breadcrumbs, a navigation aid that tells you where you are in the business area structure in the form of a text path. It shows the business areas that you have navigated to show what the timeline view currently displays.
- Title of the page, which indicates the business area for which the jobstream runs are displayed. The pattern of the title is as follows:
  
  Jobstream Runs: <business area name>
  
  For example, Jobstream Runs - Finance displays all the jobstreams and their jobstream runs for a business area called Finance.
- Auto-refresh toggle.
  
  If enabled, AAI automatically refreshes this view in the interval defined by your AAI administrator in the Config Tool.
- Filter to restrict the data displayed on the view by state or by date range. For more information, see Filtering Data by Date Range.
- Buttons to switch between the timeline/grid view and to add a new jobstream. For more information, see Monitoring Current Jobstream Runs with the Grid View (Web UI).
Timeline toolbar containing the following:
- Refresh Timeline button to manually update the view. The last time at which data was fetched, whether automatically or because you clicked this button, appears to the left of the button.
- Zoom slider
  - Click + to show shorter intervals in the timeline view and zoom in to have a more detailed view of the jobstream runs. This is useful with runs that are short and that would display as very small boxes or even lines when zoomed out. The minimum interval is 5 minutes.
  - Click - to zoom out and show longer intervals. This provides you with a clear overview of the performance of the jobstream runs relative to their SLAs over a longer period of time. The maximum interval is one day.
- View Legend button that opens a dialog that explains the meaning of the colors, lines and icons used on this page.
Left pane (Business Area and Aggregated Status Pane) with four columns displaying the following:
- Business areas (represented as folders) and jobstreams
- Aggregated states (Done, Running, Future) of the jobstreams and of the jobstreams within a particular business area.
For more information, see Understanding the Business Area and Aggregated Status Pane.
Right pane (Timeline) providing a visualization of the jobstream runs.

Navigate to the business area that you are interested in to display the jobstreams assigned to that business area and their jobstream runs. For more information, see Understanding the Timeline Pane.

Filtering Data by Date Range

filter data in the timeline view,filter runs in the timeline view,filter jobstream runs in the timeline view

The filter beneath the page title lets you restrict the runs that will be displayed by date range. Depending on your role in your company, you may want to restrict the view in different ways:

Operations/Monitoring

If you are working in an operations or monitoring team, you will probably want to set the date range filter to what is happening now because you are interested in the jobstreams whose SLA is in jeopardy. You may also be interested in the aftermath of problems that have recently occurred. Set the filter to what happened last night, earlier today or any other combination that captures recent events.

For these use cases, more remote history matters less than what has recently happened.

Analysis/Process Improvement

If your goal is to investigate trends and recognize patterns that indicate potential improvement possibilities, use large data samples. Set the filter to display longer periods of time. In addition to this view, AAI provides extensive functionality and multiple views that help you analyze historical data

For more information, see:

Filtering Data by Business Area

filter data by business area in the timeline view,filter runs by business area in the timeline view,filter jobstream runs by business area in the timeline view

The names of the business areas in the breadcrumbs are links that let you quickly navigate back and forth in the business area path. The names of the business areas in the left pane are also links. Click a link to filter the timeline view by that particular business area.

Switching Views

You can switch to the table view by clicking the Table View button at the far left end on the page. For more information, see Monitoring Current Jobstream Runs with the Grid View (Web UI).

Understanding the Business Area and Aggregated Status Pane

aggregated status of business areas and jobstreams,jobstream status,business area status

The left pane displays the list of jobstreams or business areas and their aggregated statuses. Each row is either a business area (recognizable by the folder icon) or a jobstream. Both are links that open either the content of the business area (child business areas or jobstreams) or the jobstream details page.

The Done, Running and Future columns provide the aggregated status of a jobstream / business area. In addition to the status codes and numbers (number of jobstream runs in a particular status), AAI uses colors and solid/dotted lines to help you visualize the overall status.

Screenshot of the left pane of the Jobstream Runs timeline view.

Aggregated Statuses

Business areas and jobstreams can have one of the following three overall statuses: Done, Running or Future. Each of these overall statuses has more specific statuses that are indicated by their color and the solid/dotted line. The numbers in this pane indicate how many jobstream runs have complete with any of the available statuses per business area or jobstream.

Note:

To be able to provide jobstream forecasts, AAI predicts each of its jobs. Based on these individual calculations, AAI knows whether a jobstream will meet the SLA, whether it will finish or not, with what status, and so on.

Done

jobstream status done

Jobstream runs that have already completed. The solid line around the number indicates that they have finished.

Green

The jobstream run has completed on time (they have met the SLA).
Red

The jobstream run has completed late (they have not met the SLA).

Running

jobstream status running

Jobstream runs that are still executing. A dotted line around the number indicates that they have not finished yet.

Green

The jobstream run is Predicted on time, that is, AAI predicts that it will meet the SLA.
Red

The jobstream run is Predicted late, that is, AAI predicts that it will fail the SLA.
Orange

The jobstream run is NPTF (Not Predicted to Finish). Some job execution has failed along the way and the jobstream will not finish. When this happens, AAI lets the jobstream go through the root cause analysis engine and surfaces the resulting information (job that caused the NPTF status, reason for the failure and so on).
Yellow

The jobstream run is in an Unknown status. When a job that is NPTF goes through the root cause analysis engine but AAI finds no reason why the jobstream fails, AAI sets the jobstream status to Unknown. Unknown statuses are rare.

Tip:

To determine what is causing a jobstream to be NPTF or Unknown, go to the jobstream Gantt chart and check its critical path. From there you can drill down into the job run details.

Future

jobstream status future

Jobstream runs that have not started yet and that are forecasted. A dotted line around the number indicates that they have not started yet.

Green means that the jobstream runs are predicted to finish on time and meet their SLAs.
Red means that the jobstream runs are predicted to complete late and miss their SLAs.
Orange means that AAI predicts that these jobstream runs will end as NPTF (Not Predicted to Finish). This can happen in future runs because the structure of the jobstream is such that something (some external dependency) must happen for the jobstream to run. AAI cannot be aware that there is an external event that will kick the execution of the first job. When that event happens and the jobstream run starts, its status changes to one of the Running states.
Yellow means that the jobstream runs are predicted to finish with an Unknown state.

Notes:

Running statuses give you a very clear picture of what is currently going on in your system. From here, you can drill into the details of the jobstreams that are jeopardizing your SLAs.

Running or Future orange statuses with dotted line (NPTF) and red (no matter whether done, running or future) indicate that something is wrong in the jobstream and that further investigation is necessary. If orange, the issue that blocks the jobstream must be identified and solved.

Done would be interesting in a different context, for example when doing a post mortem analysis

Adding and Editing Jobstreams

To Add a Jobstream

Click the + Add new Jobstream button in the toolbar. For more information, see Adding and Editing Jobstreams.

To Edit a Jobstream

Do one of the following
- The names of the jobstreams are links that open their details. Open the details of the jobstream that you want to edit and click the Edit Jobstream button in the toolbar.
  
  The Edit Jobstream dialog is displayed, where you can modify the jobstream attributes.
- Click the three-dot, vertical ellipsis next to the jobstream name to open the actions menu, and select one of the Edit options. The Edit Jobstream dialog opens to the corresponding tab. Although the options open the jobstream dialog to different tabs, once the dialog is open, you edit the values on any of the tabs.
  
  For more information, see:

Understanding the Timeline Pane

The right pane is the timeline view.

Screenshot of the right pane of the Jobstream Runs timeline view, that is, of the timeline pane.

The timeline pane shows all the runs of the jobstreams that are on display within the time range that you have selected in the filter. A row in the timeline view is either a business area or a jobstream. For business areas, the rows in the timeline are empty; the rows contain data for jobstreams only.

The columns in the timeline pane are time intervals. Use the Zoom slider in the toolbar to increase and decrease the intervals.

Each row can have one or more boxes. A box represents a jobstream run. This pane shows the jobstream runs arranged in the timeline in the order in which they have been executed, are executing, or will execute. The jobstream runs use the same color and solid/dotted line coding as the left pane.

The vertical line that is next to each jobstream run indicates its SLA. If a jobstream run ends before it, it means that the run finished before the SLA. If it ends afterward, the run has not met the SLA.

The current date and time is also clearly indicated by the purple Now line.

You can open the Gantt chart view for a specific jobstream run by clicking the bar on the timeline for that run. For more information, see The Gantt View for a Jobstream Run (Web Interface).

Mouseover any data point for a jobstream run or its SLA indicator to display a tooltip with details about the run. A frame pops up with the jobstream name, its run state, run status, start and end times, and the SLA deadline time.

Drilling Down into the Jobstream and Jobstream Run Details

The name of the jobstreams in the left pane are links. Click a link to open a view with four tabs that provide comprehensive information about the jobstream configuration and about its runs. This information helps you investigate the reason why a jobstream or a jobstream run is not behaving as expected.

For more information, see