Overview

The Monitoring feature in the Administration Console allows you to monitor system parameters. The system parameters can be CPU usage, memory usage, server load, and so on, for different iProcess® Engine components and services.

For a particular component or service, you can configure parameters for which you require graphical data, and also the time interval for which you need the data to be collected. For example, a graph to view the Work Item Server’s (WIS) CPU, thread, and memory usage data for every minute is depicted in the following illustration.

Figure 52: WIS Usage Graph (Per Minute)

Frequency Type

The data in the Monitoring section is divided into three pages based on the following frequency types:

• Minute: Displays the graphical data for every minute.
• Hourly: Displays the graphical data for every hour.
• Daily: Displays the graphical data for each day.
Note:
  • Some metrics are gathered only at an hourly or a daily level. This is because these metrics do not vary significantly enough to require more frequent monitoring, and are also resource-expensive to be captured at lower levels.
  • Metrics for daily or hourly levels that are captured in minutes are aggregate values, such as minimum, maximum, or average of the minute or hourly metrics.
  • Sometimes, the parameter name or the parameters list is too long to display on the graph. In such a case, you might not be able to view all the parameters of the graph. You can view all the parameters of the component by scrolling the scrollbar at the bottom of the graph beside the parameter name.

Dashboard

Each page (Minute, Hourly, and Daily) has a dashboard that displays real-time graphical data based on the parameters configured.

Note: You can add up to eight graphs to each dashboard.

For each frequency type, you can configure graphs from a list of templates. The following topics list steps to configure graphs and effectively monitor the required system information.

Show/Hide Parameters

For any graph that displays statistical data for more than one parameter for multiple components, you can choose to see or hide data for a specific parameter. To show or hide a parameter’s data, click the parameter name. The parameter name can be seen in the following illustration with a circular highlight.

A parameter for a component when visible, displays the data with a colored symbol corresponding to that parameter. For instance, the following illustration shows the parameter name M1SPO1MEM indicated with a diamond symbol and the corresponding plotted line for memory usage for the iProcess Objects Server (iPOS).

In the parameter name, M1 implies machine name, SPO1 implies the process instance 1 for SPO, and Memory is the metric that is computed.

Figure 53: Show Parameters

However, when hidden, the parameter name is grayed out and the corresponding data for the parameter is no longer displayed on the graph (see the following illustration).

Figure 54: Hide Parameters

Note: Click the parameter name again to restore displaying its data. The parameter name acts like a toggle button.

Zoom and Zoom Reset

You can view graphical data for a specific time period by using the zoom feature. The displayed graph shows an expanded view for the selected time period.

To view the graph for a specified time period, perform the following steps:

  1. Click the Zoom icon at the upper-right corner of the graph that you want to view for a selected time period.
  2. When you hover the mouse to select from the start period, it displays a plus (+) sign. Click and drag the plus (+) sign to the end time period where you want to view the graph.
    For example, if there is a spike in the CPU usage for a given process at around 9:20 PM, you can zoom-in to a 10-minute time span on either side to get a closer picture. It means that you can see data only between 9:15 pm to 9:25 pm. In this way, you can spot the issue better, which otherwise is not so obvious when the data covers a longer timeline.

    3. Figure 55: Zoom Graph for Specific Time Period

    Note: Click the Zoom Reset icon to reset the graph to the default view.

Date/Time-Specific Graphs

You can view graphical data for a specific time period by providing the date and time on the expanded view of the graph.

To view the expanded view for a graph, perform the following steps:

1. Double-click the graph for which you require to view the data for a specific time period.
This displays a full view of the graph. For instance, when you click the iPOS Load graph, when viewed in full mode, displays as shown in the following illustration.

Figure 56: Full View of Graph
2. On the expanded view of the graph, you can see more data than what you saw on the dashboard. For example, on the Hourly dashboard, if you could see data for thirty hours, on the expanded view you can see about ten times more data, which is approximately three hundred hours or thirteen days.
3. To view the data for a specific date or time range, click Date/Time Filter.
4. On the Date/Time Filter dialog, click the From Date field to select the start date. You can also specify a start time if required.
5. Click the To Date field to select an end date. You can also specify an end time if required.
6. Click Apply to view the graphical data for the specified date and time.
Note: When you choose the start time and end time in the Choose Date/Time Range dialog, there is a time limit for graphs of each frequency. Following is the time limit for each frequency:
  • Minute: Not more than 4 hours.
  • Hourly: Not more than 14 days.
  • Daily: Not more than 90 days.

Exporting Metrics Using the swadm Utility

You can use the swadm utility to export metrics to a file in the CSV format from the iProcess Engine Server. For more information, see iProcess Engine Metrics in the TIBCO iProcess® Engine Administrator’s Guide.