Table of Contents

Driven User Guide

version 2.1.4-eap-9

Status Views

In Driven, when you focus the application execution data by restricting the displayed information on the page by search terms or filter parameters and then save the criteria, you create a view. A Status View has more general information than the other type of view, which is an Application View. The Status View also lends itself to discovery of system-wide issues instead of specific application incidents.

Figure 1 shows the search and filtering controls in the Status View. After you filter or search to focus on a subset of data, the status graphs display application information for the parameters that you set.

Apps View Driven2dot0
Figure 1. Status view graphs with filtering and searching controls highlighted

While Driven graphs provide a perspective of rolled-up data, tables underneath present a detailed breakdown of the graphical data. In tables you can view many additional dimensions of the selected application execution data. Depending on your immediate goals, the table is potentially more helpful than the graphs because information in tabular format is presented on a more granular level. See the Details Table section below for more information.

The Search feature supports several application-level query attributes. If you use the search field, you can filter the data that appears in all parts of the status view. Refer to Searches, Saved Views, and Accessing Relevant Data for detailed information.

Application and unit of work status throughout Driven, including the Status Change Events and Segment Frequency graphs, are represented by color-coded status categories of application and unit of work states:

Table 1. Application and Unit of Work Status Represented in Driven
State Color Icon

PENDING or STARTED

Dark Blue

(no icon)

RUNNING

Light Blue

Running_State

SUCCESSFUL

Green

Successful_State

STOPPED

Yellow

Stopped_State

FAILED

Red

Failed_State

SUBMITTED (applies to units of work only)

Yellow

Submitted_State

SKIPPED (applies to units of work only)

Green

Skipped_State

Timeline Selector

The timeline on top graphs the number of application executions. The gray shading represents the time range for which Driven displays data on the rest of the page. Nodes on the timeline plot the times beginning and ending each interval as set by the unit-of-time calibration for the graph. Figure 2 illustrates how you can control the timeline.

Tip
Reset the the timeline selector by clicking on a node for a time that you want to inspect. If you want to expand the timeline selector to an adjacent span but keep some of the current selection, click a node in the gray area and drag horizontally.

timeline-selector

Status Change Events

This graph represents a snapshot of application activity by displaying how many apps were in each execution status at various points of the time frame charted on the horizontal axis.

Tip
Hover over a node on a line graph to see a pop-up window that details the exact number of apps in each status at a specific point in time.

status-change-events

Segment Frequencies

By default, the Status Frequency graph displays each application by name, how many times each app executed, and how often each app execution was in a particular status. This allows for comparison of application performance on a broad scale.

segment-frequency-graph

Tip
Hover over a bar in the graph to open a pop-up window that details the exact number of app executions for each segmented status.

Use the drop-down menu to change the metric of the vertical axis to measure performance along dimensions other than unique applications:

status_frequency_nameMenu_Driven2dot0

Owner - Displays application data compiled by each application owner name.

Team - Displays application data compiled by each team.

Tags - Displays application data compiled by each tag term.

Tag Groups - If tags for any of the applications were grouped and prepended with a descriptor, click Tag Groups and select the group that you want to analyze. The resulting graph displays application data compiled by each tag term for the selected group.

Tip
If arrowheads to the right of the drop-down menu are enabled, then there are more data results than can fit in one page of the graph. Click the arrowheads to page through the graphed data set.

The status frequency counters shows the number of times that Driven recorded applications were in each status.

status frequency counters Driven2dot0
Figure 2. Status frequency

Auto-Updated Data

Driven can refresh the displayed information as updates stream in from the plugin. Ensure that the Auto Update toggle in the top right corner is enabled to allow the displayed Driven data to auto-update in real time. If the Auto Update toggle is disabled, you must manually refresh the browser window to see real-time updates. Generally, this feature is useful if you want to monitor applications as they run.

Click the circle in the Auto Update slider to toggle between off and on.

auto update slider
Figure 3. Auto Update slider

Details Table

The Details Table under the graphs provides a breakdown of application execution data by instance of each application run. Use the table to drill down and gain insights to application performance from your cluster. Some key monitoring assets of the tabular interface include the following capabilities:

  • Export application-level tabular data to a tab-separated values text file

  • Add or remove metrics that are displayed

  • Click on a hyperlinked application name to view app data on more granular levels, including visualization of units of work and steps as directed acyclic graphs (DAGs)

view table extract Driven2dot0
Figure 4. First three rows of a sample table

The Driven page displays a maximum of 25, 50, or 100 rows. Use the Page Size drop-down menu if you want to change the maximum number of rows.

If the number of rows spans more than one page after you have set the Page Size to your preference, use the pagination arrows to navigate to other pages of the table.

apps-table-pagination

Tip
You can reorder the columns by clicking column headings and dragging them to different locations. You can also sort the information in a column by ascending or descending order by clicking on the bidirectional arrow next to the column heading.

Track Applications by Various Metrics

Driven lets you customize most of the information that the table displays. Click the column chooser icon Counter_Chooser to reveal or conceal columnar metrics. The Status and Name columns cannot be hidden.

The columnar metrics are categorized in the column chooser. Each category can be collapsed or expanded. This helps with retrievability because the number of choosable columns can grow large.

A key feature of the table and column chooser is the ability to import and view counter attributes. See Counter Data and Other Metrics in Tables for more information.

Exporting Data to a .tsv File

As part of your analytical process, the application data that is presented in a Driven table can be downloaded as a tab-separated values (.tsv) file, which then can populate a spreadsheet for detecting patterns, metrics, and usage.

Click the download icon tsv_icon to capture the Driven table data and download it to a file.

Next