Contact Us

Health Monitoring

The Health Monitoring app (formerly Open Component Monitoring)  in SAP Focused Run supports Application & System Monitoring  by providing additional monitoring metrics that go beyond standard system monitoring. Use Health Monitoring when configuration differs vastly between managed objects. In addition, Health Monitoring is used to provide low-barrier monitoring for managed objects that are not included in the landscape management database (LMDB).

Health Monitoring provides the following types of metrics for monitoring managed objects:

For all metric types except Cloud Service metrics, the monitoring data of a metric is collected by a Simple Diagnostics Agent (SDA). Depending on the type of metric, an SDA is used which is either installed on a host of the monitored object or on a host in a collection group in which the monitored object is located.

A collection group corresponds either to a customer network or to a subnetwork of a customer network. Collection groups of the first kind are available in Health Monitoring automatically if the relevant customer networks are defined in SAP Focused Run. You can create, change, and delete collection groups of the second kind in the Health Monitoring app.

In the case of Cloud Service metrics, how monitoring is performed depends on the type of collection involved. With pull data collection, monitoring is by means of integration with the Expert Scheduling Management Cockpit and an ABAP collection job (frequency: five minutes). With push data collection, the managed service sends the metrics directly to the Health Monitoring app.

Configuration: General

Activate Collection Group

Many Health Monitoring metrics are unmodeled, which means they are not assigned to a specific technical system in the landscape. Nevertheless, they need to be executed by a Simple Diagnostics Agent, which must be located inside the collection group. It is therefore necessary, as a first step, to define a central Simple Diagnostics Agent in the collection group which should execute the Health Monitoring metrics.

To activate a collection group, proceed as follows:

  • Choose the Configuration button in the top right corner of the Health Monitoring app.
  • Expand the Collection Group area.
  • You can see all the collection groups in scope and their status. Choose the switch next to the collection group to activate it.
  • Select the Simple Diagnostics Agent that should be used by Health Monitoring and choose Save.
  • The collection group is now active and can be used by Health Monitoring.
  • Note: You can choose the Edit button to assign another Simple Diagnostics Agent, if necessary.

Create New Metrics

Perform the following steps to create a new Health Monitoring metric:

  • Choose the corresponding tab on left of the screen (for example, Availability to create an Availability metric).
  • Choose the + button.
  • Select a metric type (only relevant for Availability and Application Check metrics).
  • Maintain metric and alert attributes (see the table below for descriptions of parameters shared by all metrics).
  • Choose Save.
  • Your metric is now active and is visible in the Health Monitoring application

If you have to create or change multiple Availability metrics simultaneously, you can use the mass maintenance functionality in Health Monitoring (available since SAP Focused Run 3.0 SP00).

For further details, see the relevant guide Mass Maintenance of Availability Metrics in Health Monitoring:

For details of how to create OS Script metrics, see the document Creating OS Script Metrics with Health Monitoring.

Here is a list of the parameters used by all metrics except Cloud Service metrics in the Health Monitoring app. For information about Cloud Service metrics, see here.

FieldDescription
Metric NameA descriptive name for the metric. It is advisable to choose a name that can be easily understood by others.
Collection GroupThe collection group in which the metric is created
Collection Interval/ Collection FrequencyHow often the metric is collected
ThresholdThe metric threshold. For each metric, you specify a threshold and what happens when this threshold is reached – for example, set status of metric to red (error).
Metric DocumentationAdditional information about the metric
Alert ActiveParameter that allows an alert to be triggered when the metric fails
Alert NameThe name of the alert. It is advisable to choose a descriptive name that can be easily understood by others.
SeveritySeverity of the alert in Alert Management. Maintain a value between 0 (very low) and 9 (Critical).
Notification Variant (optional)Selection of notification for sending an additional e-mail for the alert, if required
Additional AttributesAn attribute and an attribute value (optional) add additional information to a metric. You can also add multiple attribute/value pairs to a metric. For example, you could specify an attribute SID and an attribute value FRN for a metric to specify that this metric refers to an SAP system with the system ID FRN. You can use additional attributes to group the data displayed (for example, in the Attribute Overview tab or in a table).
Outbound Connector Variant (optional)Selection of outbound connector for forwarding the alert via BAdI implementation, if required

For details of individual metrics and their additional parameters, see here. 

Configuration: Cloud Services

To find out more about configuring cloud services, see Configuration of Cloud Services for Health Monitoring.

Configuration: Examples

Groupware Connector

You can create the following metrics to monitor the availability of a Groupware Connector Server:

Groupware Connector

Create a new Windows Services metric with the following parameters:

  • Metric Name: Groupware Connector
  • Service Name: MsxGwConnector7.0_0
  • Host Name: <host name of groupware server>
  • Additional Attributes: Groupware
  • Collection Interval: 1 Minute
  • Alert Name: Groupware Connector not running
Groupware MS Proxy

Create a new Windows Services metric with the following parameters:

  • Metric Name: Groupware MS Proxy
  • Service Name: MsxGwProxy7.0_0
  • Host Name: <host name of groupware server>
  • Additional Attributes: Groupware
  • Collection Interval: 1 Minute
  • Alert Name: Groupware MS Proxy not running

Other configuration examples are available in our SAP Focused Run - Internet Demo System.

Data Quality Indicators

You can use data quality indicators to call up detailed information about the success of data collection for Simple Diagnostic Agents and Cloud Services. To display this information, choose the red status icon at the top-right of the UI.


In the Agents area, you can see the status of all Simple Diagnostics Agents configured in a collection group. In addition, the Cloud Services area displays the following information:  

  • Timestamp of last successful data collection and (if applicable) technical message and return code: To display this information in a pop-up, choose the rating icon in the Status column.
  • The data collection log in the Expert Scheduling Management Cockpit (services with pull data collection only): To display the cockpit, choose the Data Collection Log link. 

You can also view data quality indicators for cloud services in the following parts of the app:

  • Cloud Services section of the configuration (data collection status only) 
  • Details of configured cloud services 
  • Cloud Services monitoring page 

Housekeeping

The SAP_FRN_OCM_HOUSEKEEPING job deletes data that is no longer required from the Health Monitoring database tables (see the Master Guide for SAP Focused Run). The housekeeping job runs once a day.

To view the status of the last run and the scheduled date/time of the next run, proceed as follows:

In the Health Monitoring app, choose the Configuration button (gear icon) at the top right of the screen and then open the Infrastructure panel.


As of SAP Focused Run 3.0 FP03, it's no longer necessary to configure housekeeping via the database. The Configuration area of the UI, containing the Infrastructure panel, now also includes a Housekeeping section. 


The configuration tables are divided into two sections: Raw Data and Aggregated Data.

The value in the Raw Data field specifies how long monitoring data is kept in the Health Monitoring database tables – for example, 180 days. In this case, any monitoring data required for detailed or collector charts that is older than today minus 180 days is aggregated and deleted. Other raw data is simply deleted.

The value in the Aggregated Data field specifies how long aggregated monitoring data is kept in the Health Monitoring database tables – for example, 720 days. If the aggregated monitoring data is older than today minus 720 days, it is deleted.

If you've already customized raw data and aggregated values in an earlier feature pack, your legacy values are still available. The UI always displays the lowest configured value. If you make any changes to values on the UI, all values that depend on the relevant type (raw or aggregate) are updated.

To maintain housekeeping, change the values in the Housekeeping section of the Configuration panel and save them.

You can maintain the housekeeping settings for each of your SAP Focused Run systems, or you can transport the settings – for example, from a test system to a production system. To transport settings, go to transaction SM30 (Extended Table Maintenance), enter OCM_HKCONFIG in the Table/View field and choose the Maintain button. Next, select the table rows and choose Table View > Transport to store the settings in a Customizing request. You can now transport the Customizing request from your test system to your production system, for example.

Caution

If you adjust the housekeeping configuration, it's advisable not to make large changes (for example, double-digit reductions to the number of days).

If changes of this kind are unavoidable, be aware that housekeeping will be done step by step to avoid performance issues.

This means that aggregation will be done over a period of days until the change has been taken into consideration.

For example, if you change the housekeeping value from 180 to 100 days, housekeeping will run over a number of days until the difference between the oldest database entry and the newly configured value no longer affects performance.

Deprecated Functionalities

While we strongly recommend using the new Configuration panel on the UI of the Health Monitoring app, you can still configure housekeeping settings via the database, as in earlier feature packs.

To maintain housekeeping settings in database table ocm_hkconfig, do the following:

  • Go to transaction SM30 (Extended Table Maintenance) and enter OCM_HKCONFIG in the Table/View field. Then choose the Maintain button.
  • In the Store Table Name field, enter the Health Monitoring database table from which data is to be deleted (for example, ocm_mon_raw). In the field Partition Field Name, specify a date field of the database table. The lifespan is calculated based on the value in this field. In the Lifespan field, enter a lifespan in days. Then choose Save.