IBM WebSphere Message Broker Monitoring, WebSphere MQ Monitoring, and WebSphere MQ Configuration agents, Version 7.1

Sample reports

Eight sample reports are provided in the report package for WebSphere® Message Broker Monitoring agent. For the agent to get data to display in the sample reports, historical data collection must be enabled for the related attribute groups.

Table 1. Historical attribute groups for sample reports
Sample report Attribute group
Broker Daily Availability report
  • WebSphere Message Broker V7.0 or later: Broker Status (detailed data)
  • WebSphere Message Broker V6 (all releases): Broker Information (detailed data)
Broker Weekly Availability report
Broker Execution Group Daily Availability report WebSphere Message Broker V7.0 or later only: Execution Group Status (detailed data)
Broker Execution Group Weekly Availability report
Broker Message Flow Daily Availability report WebSphere Message Broker V7.0 or later only: Message Flow Status (detailed data)
Broker Message Flow Weekly Availability report
Broker Top n Elapsed Microseconds report
  • WebSphere Message Broker V7.0 or later: Accounting Message Flow Statistics (summarized data)
  • WebSphere Message Broker V6 (all releases): Message Flow Accounting (summarized data)
Broker Message Flow Detail report

Broker Daily Availability report

This report shows the daily availability of the broker that you specified, including the availability of the whole day and the availability of 24 hours. Use this report to check the broker status in one day.

Table 2. Parameters of Broker Daily Availability report
Parameter group Parameter name Usage
Date Range Report Period Select the day you want to check the broker status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the broker that you want to check.
Broker Name Specify the name of the broker that you want to monitor.
Record Type Record Type Select 1 for snapshot report and 2 for archived report.
Note: WebSphere Message Broker V7.0 or later can only use archived report.

Broker Execution Group Daily Availability report

This report shows the daily availability of the execution group that you specified, including the availability of the whole day and the availability of 24 hours. Use this report to check the execution group status in one day. This report is for WebSphere Message Broker V7.0 or later only.

Table 3. Parameters of Broker Execution Group Daily Availability report
Parameter group Parameter name Usage
Date Range Report Period Select the day you want to check the execution group status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the broker that you want to check.
Broker Name Specify the name of the broker that you want to monitor.
Execution Group Name Select the execution group that runs within the broker.

Broker Execution Group Weekly Availability report

This report shows the weekly availability of the execution group that you specified, including the availability of a whole week and the availability of each day in the week. Use this report to check the execution group status in one week. This report is for WebSphere Message Broker V7.0 or later only.

Table 4. Parameters of Broker Execution Group Weekly Availability report
Parameter group Parameter name Usage
Date Range Report Period Select one day of a week that you want to check the execution group status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the broker that you want to check.
Broker Name Specify the name of the broker that you want to monitor.
Execution Group Name Select the execution group that runs within the broker.

Broker Message Flow Daily Availability report

This report shows the daily availability of the message flow that you specified, including the availability of the whole day and the availability of 24 hours. Use this report to check the message flow status in one day. This report is for WebSphere Message Broker V7.0 or later only.

Table 5. Parameters of Broker Message Flow Daily Availability report
Parameter group Parameter name Usage
Date Range Report Period Select the day you want to check the message flow status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the message flow that you want to check.
Broker Name Specify the name of the broker.
Execution Group Name Specify the name of the execution group.
Message Flow Name Specify the name of the message flow that you want to check.
Status Warning Specify an integer as the warning threshold. If the message flow availability percentage is lower than this threshold, the value is marked as warning status.
Critical Specify an integer as the critical threshold. If the message flow availability percentage is lower than this threshold, the value is marked as critical status.

Broker Message Flow Detail report

The report shows the usage of the selected message flow during the specified time period. The line chart shows maximum elapsed microseconds, average elapsed microseconds, and minimum elapsed microseconds that the message flow takes to process in different colors. The table shows detailed information about elapsed time.

You can use this report to identify the elapsed time trend over a specified period. The report can be run hourly, daily, weekly, monthly, quarterly, or yearly.

Table 6. Parameters of Broker Message Flow Detail report
Parameter group Parameter group Usage
Date Range Report Period Select the time span for the report from the predefined time range, such as Last Week, Current Month, Last 30 Days.
Start Date Select a start date from the calendar and start time from the time widget. You must specify both date and time.
End Date Select an end date from the calendar and start time from the time widget. You must specify both date and time.
Summarization Selection Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly from the list.
Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, the default value is -1.
Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.
Resource Selection Broker Name Specify the name of the broker that you want to monitor.
Execution Group Name Specify the name of the execution group that runs within the broker.
Message Flow Name Specify the name of the message flow that is associated with the execution group.
Record Type Record Type Select 1 for snapshot report and 2 for archived report.
Note: WebSphere Message Broker V7.0 or later can only use archived report.

Broker Message Flow Weekly Availability report

This report shows the weekly availability of the message flow that you specified, including the availability of a whole week and the availability of each day in the week. Use this report to check the message flow status in one week. This report is for WebSphere Message Broker V7.0 or later only.

Table 7. Parameters of Broker Message Flow Weekly Availability report
Parameter group Parameter name Usage
Date Range Report Period Select one day of a week that you want to check the message flow status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the broker that you want to check.
Broker Name Specify the name of the broker that you want to monitor.
Execution Group Name Specify the name of the execution group.
Message Flow Name Specify the name of the message flow that you want to check.
Status Warning Specify an integer as the warning threshold. If the message flow availability percentage is lower than this threshold, the value is marked as warning status.
Critical Specify an integer as the critical threshold. If the message flow availability percentage is lower than this threshold, the value is marked as critical status.

Broker Top n Elapsed Microseconds report

This report shows the top n message flows that take the most average time in microseconds to process. By default, this report shows the top 20 message flows for the selected broker. The chart view of the report shows the top n message flows and highlights the average elapsed time in different colors according to the threshold that you specified. The table shows more details about each message flow.

You can use this report to identify the overused message flows of a collection of systems. The report can be run hourly, daily, weekly, monthly, quarterly, or yearly. You can also click the concerned message flow in the chart view and navigate to the Message Flow Detail report to see more details of the selected message flow.

Table 8. Parameters of Broker Top n Elapsed Microseconds report
Parameter group Parameter name Usage
Date Range Report Period Select the time span for the report from the predefined time range, such as Last Week, Current Month, Last 30 Days.
Start Date Select a start date from the calendar and start time from the time widget. You must specify both date and time.
End Date Select an end date from the calendar and start time from the time widget. You must specify both date and time.
Summarization Selection Summarization Type Select the summarization types, such as Hourly, Daily, Weekly, Monthly, Quarterly, Yearly from the list.
Shift Period If shifts are enabled, the hourly table displays the shift period as 1 or 2, depending on the peak and off-peak hours that are configured in the data warehouse. The daily table consists of 1 and 2 corresponding to the peak and off-peak hours, and -1 corresponding to the summarized value for that day. If shifts are not enabled, the default value is -1.
Vacation Period If the vacation period is not enabled, the default value is -1. You can enter the value 1 or 2, if the vacation period is enabled.
Number of Systems Number of Systems to Display Specify an integer as the number of top resources that you want to see.
Record Type Record Type Select 1 for snapshot report and 2 for archived report.
Note: WebSphere Message Broker V7.0 or later can only use archived report.
Elapsed Microseconds Prompt Status Warning Specify an integer as the warning threshold. If the average elapsed time in microseconds of a message flow exceeds this threshold, the value is marked as warning status.
Critical Specify an integer as the critical threshold. If the average elapsed time in microseconds of a message flow exceeds this threshold, the value is marked as critical status.

Broker Weekly Availability report

This report shows the weekly availability of the broker that you specified, including the availability of a whole week and the availability of each day in the week. Use this report to check the broker status in one week.

Table 9. Parameters of Broker Weekly Availability report
Parameter group Parameter name Usage
Date Range Report Period Select one day of a week you want to check the broker status.
Sampling Interval Sampling Interval Specify the collection interval in the TEP History Collection Configuration panel.
Resource Selection Host Name Specify the host name of the broker that you want to check.
Broker Name Specify the name of the broker that you want to monitor.
Record Type Record Type Select 1 for snapshot report and 2 for archived report.
Note: WebSphere Message Broker V7.0 or later can only use archived report.


Feedback