Alerting: View Memory Metrics for Rules

Document created by RSA Information Design and Development on Sep 12, 2017Last modified by RSA Information Design and Development on Sep 12, 2018
Version 8Show Document
  • View in full screen mode

This topic tells ESA rule writers how to view memory metrics for rules. You can see estimated memory usage for each rule running on a server, and you can use this information to modify your rule statements and conditions if they use too much memory.

Rules can sometimes consume more memory than you expect, causing your ESA to slow down or stop. To see approximately how much memory a rule is using, you can configure memory metrics. Memory metrics allow you to view an estimated memory usage for each rule in the Health & Wellness System Stats browser (so you will need permissions to access this module). You can use this information to modify your rules to be more efficient. 

At a high level, you will need to complete the following steps to use the memory metrics to troubleshoot memory usage for rules:

  1. Ensure that the memory metrics feature is enabled (via Explorer > CEP > Metrics > EnableStats). The Memory Metrics feature is enabled by default.
  2. Ensure you have the correct permissions to view the Health & Wellness module. For information on roles and  permissions, see Role Permissions
  3. View the memory statistics in Health & Wellness.
  4. (Recommended) Configure Health & Wellness ESA policies to send an email if memory thresholds are exceeded. See "Manage Policies" in the System Maintenance Guide for instructions on sending email notifications.
  5. Use the memory metrics data to modify rules to be more efficient, if necessary.


The following are requirements for using memory metrics:

  • Memory Metrics feature is enabled (via ExplorerCEP > MetricsEnableStats).
  • The user must have the appropriate permissions to view Health & Wellness statistics. 
  • (Recommended) Configure the ESA Health & Wellness policy to send an email when memory thresholds are exceeded.


View Memory Metrics in the Health & Wellness System Monitoring Module

  1. Go to ADMIN > Health & Wellness > Monitoring.
  2. View the details for your ESA service.
  3. Click the Rules tab. 
  4. You can view the average memory usage for each rule for the previous hour. 

ESA Metrics showing average memory usage per hour

View Memory Metrics in the Health & Wellness System Stats Browser

  1. Go to ADMIN > Health & Wellness > System Stats Browser.
  2. For component, select Event Stream Analysis. For category, enter ESA-Metrics.

    H&W Memory metrics

    The name of the rule is displayed in the Subitem field, and the memory usage is displayed in the Value column.

  3. To view the historical memory usage for the rule, click on the Historical Graph icon. 

Note: The Last Update field reflects when Health & Wellness polls ESA. However, the Memory Metrics is not synchronized with the Health & Wellness polling. For example, if the memory threshold is exceeded on 10/10/18 at 12 p.m., but Health & Wellness polls at 10/10/18 at 12:10 p.m., the Last Update field will display a timestamp of 10/10/18 12:10 p.m. 

Enable or Disable the Memory Metrics Feature

  1. Go to ADMIN > Services, select your ESA service, and then select Actions icon > View > Explore.
  2. Navigate to CEP > Metrics > configuration as shown below.

    Admin Services Explore view for ESA showing EnableStats field

  3. Change the field EnableStats to true or false depending on whether you want to enable or disable the memory metrics feature.
Previous Topic:Troubleshoot ESA
You are here
Table of Contents > Getting Started with ESA > View Memory Metrics for Rules