Configuring the GPU Status View
You can group and sort the aggregated data based on a range of state variables, using the Configuration Options dialog, opened by selecting the configure icon (
).
). Figure 146, GPU Status Configuration Options dialog
Select Variables to Display
Variables selected in the Display column are placed into the Group By and Sort By columns where they are available to be selected to change the aggregation. Some variables are selected for display by default, including state, dev, function, process, sm, warp, and lane. Add or remove variables by checking them in the Display column. Table 17 lists all available state variables.
Selecting or deselecting any item in this dialog activates the Preview button. For example, select line to add it to the display, then press Preview.
The line number is added to the display.
Preview provides just a temporary display of the view. Click OK to save the view or Reset to return the view to its default settings. Cancel closes the view with no changes.
Select Variables to Group or Sort By
Select one or more variables in the Group By or Sort By columns to change the grouping and sorting display.
Display by logical coordinates
For example, check the logical coordinates (bx, by, bz, lx, ly, lz) under Display, then select them in the Group By menu to change the display to logical coordinates, and then group by those coordinates.
Figure 147, Configuration “Group By”
Group by state
Consider a program in which the threads unexpectedly diverge, as displayed in the view:
Figure 148, Diverging threads in the GPU Status View
The four active SMs, numbered 0, 2, 4, and 6, have a state of either breakpoint or diverged. In each SM, 32 warps, numbered 0 through 31, are valid.In each warp, 32 lanes are valid. However, some of the lanes have diverged, visible in the tooltip that displays over long lines. The rest are at breakpoints.To make the view more useful, add line to the display and then group by lane state.
Figure 149, Grouping by thread state
While the information has not changed, it’s now easy to see that, in every warp and SM, half the lanes — numbers 16 through 31 — have hit the breakpoint on line 248. The other half of the lanes — numbers 0 through 15 — have diverged and are all at line 240.
You can use an include custom filter to refine the view further. See Configuring Custom Filters.
State Variables for Grouping and Sorting
State Variable | Description |
|---|---|
state | State of a lane. An enumerated value |
dev | Device ID for GPU (an integer) |
function | Name of the function that contains a lane PC |
line | "filename#number": the file and line number of a lane PC |
process | CPU process ID, either as MPI rank or as dpid |
sm | ID of an SM (an integer) |
warp | ID of a warp within an SM (an integer) |
pc | PC of a lane (an integer) |
lane | ID of a lane within a warp (an integer) |
dev_type | GPU device type (a character string) |
sm_type | SM type for the GPU (a character string) |
sm_count | Number of SMs in the device (an integer) |
warps_per_sm | Number of warps in each SM (an integer) |
lanes_per_warp | Number of lanes in each warp (an integer) |
regs_per_lane | Number of registers available to each lane (an integer) |
valid_warp_mask | Bit mask indicating which warps are valid in an SM |
valid_lane_mask | Bit mask indicating which lanes are valid in a warp |
active_lane_mask | Bit mask indicating which lanes are active in a warp |
broke_lane_mask | Bit mask indicating which lanes are at breakpoints |
bx | X coordinate of a block (an integer) |
by | Y coordinate of a block (an integer) |
bz | Z coordinate of a block (an integer) |
lx | X coordinate of a thread within a block (an integer) |
ly | Y coordinate of a thread within a block (an integer) |
lz | Z coordinate of a thread within a block (an integer) |
Configuring Custom Filters
Create a custom filter in the Create New Filter pane in which you can include or exclude values that match or do not match the values of certain state variables from the display. This pane contains combo boxes for building the filter.
Include/exclude: Determine whether to “include” or “exclude” a filter. If both “include” and “exclude” filters are specified, the first one determines the overall behavior.For example, if “include” comes first, then only threads meeting the criteria will be included. If '“exclude” is first, then all threads that don't meet the criteria will be displayed. Subsequent “include” and “exclude” filters define exceptions to this overall behavior. See Figure 151 for an example.
Variable: Choose a variable from the dropdown. The variable state is the default.
Comparison operator: Depends on the selected variable. If the state variable is a string value, the dropdown shows only == and !=. However, if it is an integer value, the dropdown contains additional comparison operators, like so: 
Value to compare: Enter the value to compare against here. The value field is an editable text box. For variables that have a limited set of valid values, those values are displayed. For instance, choosing the variable state populates this dropdown with a list of possible states:
AND/OR: Within a list of “include” or “exclude” filters, the predicates can be either “ANDed” or “ORed” together. If there are both AND and OR predicates, AND takes precedence over OR. To build a filter, select the elements, then click ADD.
Examples
Let’s look again at the program in which the threads diverged (Figure 148). In addition to grouping the output by thread state, Figure 150 uses a custom filter to limit the display to show only those threads that have diverged.
Figure 150, Custom filter by a state of “diverged”
You can create multiple custom filters, and activate or de-activate them using the left checkbox.
Use “include” and “exclude” together to establish the overall filter behavior, then refine it. Figure 151 first includes all threads at breakpoint, but then excludes those running on SM 2.
Figure 151, Mixing include and exclude filters
