Punch card widget

About the punch card widget

The punch card widget draws a matrix that indicates the quantity of a selected measure by dimension over a specified time range. The time period groupings are displayed as columns, the dimensions as rows, and the measure values as dots that vary in size according to their values.

Configuration options

The following table lists the configuration options of this widget: 

Widget title Enter a descriptive title for the widget.
Widget description Enter a description of the widget.
Widget size Select the size of the widget window in the dashboard layout. The units are columns x rows. For example, 3x2 will fit the widget across three columns and two rows.
Time Range The period of time for which you want to analyze data in a single view of the chart. You can choose from 1 hour up to 1 year. This determines the time period represented across the width of the matrix.
Group by Specify how you want to group the values over the time range. This will determine the periods for which the Field to Show values will be aggregated. For example, given a Time Range of 1 week, and a Group by of 1 day, The punch card widget will have seven columns with the Field to Show values aggregated by day.
Actions  Add or remove elements of the grouping field. Select All to include all values.
Field to show Select from among the available aggregated fields. This selection determines the dots that will appear in the matrix.


The below widget shows the daily average response time per ISP over one month. 

  • Time Range is set to 1 month.
  • Group by is set to 1 day.
  • Field to show is set to Average (responseTime). 

You can adjust the display of the widget in the dashboard. The Global Size slider changes the way the dots are sized in the matrix:

  • When the slider is in the OFF position, the size of each dot is relative only to the other dots in the same row (in our example, for the same ISP).

  • When the slider is in the ON position, the size of each dot is relative to all of the other dots in the matrix (in our example, each dot is sized in comparison with all other ISPs).

Have we answered your question?

If not, please contact our technical support team via email by clicking the button below.