Event Analytics Monitoring dashboard

The Event Analytics Monitoring dashboard provides troubleshooting information for ITSI's Event Analytics functionality.

Rules Engine Statistics

Panel	Description
Rules Engine Information	The Java version being used by the Rules Engine. ITSI requires Java 8 - 11 to run notable event management features.
Rules Engine Real-Time Search Configuration	Configuration information related to the following settings in savedsearches.conf: dispatch.indexedRealtime - Defaults to "1". Do not modify this setting. dispatch.indexedRealtimeOffset - Defaults to "60". Increase this setting if events are not being grouped. dispatch.rt_backfill - Defaults to "0" (false). Do not modify this setting. cron_schedule - Defaults to * * * * *. Do not modify this setting.
Rules Engine Event Processing Volume	The number of events processed by each Rules Engine activity every 10 minutes.
Rules Engine Event Processing Times	The median time taken by each Rules Engine activity to process an event.
Rules Engine Schedulers Health Check	The number of times various Rules Engine schedulers run per 12-minute time frame. These statistics are used internally to ensure the schedulers are running as expected. By default, the Event Periodic Backfill Scheduler runs every 12 minutes, the Policy Rules Check Scheduler runs every 1 minute for each aggregation policy, and the Policy Group Updates KV Store Sync Scheduler runs every 28 seconds for each aggregation policy.
Rules Engine Starts and Stops	The number of times the Rules Engine starts and stops each hour. A Rules Engine restart can kick off multiple backfill processes with the default phased_execution_mode value in limits.conf, which might lead to the creation of duplicate episodes. Restarts can also help troubleshoot if you aren't seeing certain expected episodes.
Rules Engine Activity	The number of states for each completed Rules Engine instance. You can use the instance ID to search the ITSI logs and troubleshoot issues.
Rules Engine Activity Details	The details of activities of each Rules Engine instance completed. You can use the instance ID to search the ITSI logs and troubleshoot issues.

Skipped Events

Panel	Description
Skipped Events Count	A raw count of skipped events (events that are not included in any episodes) over the past 7 days. Under normal conditions, this number should be zero.
Skipped Events Percentage	The percentage of ungrouped events versus grouped events over the past 7 days. Under normal conditions, this percentage should be zero. The Rules Engine skips events when it fails to group events into the itsi_grouped_alerts index. Check the Rules Engine logs for errors.
Backfilled Events Count	A raw count of backfilled events over the past 7 days. Under normal conditions, this number should be small.
Backfilled Events Percentage	The percentage of backfilled events versus tracked events over the past 7 days. Under normal conditions, this percentage should be less than 1%.

Episode Processing Time

Panel	Description
Episode Processing Times	The amount of time it takes to convert tracked alerts (active raw notable events) to grouped alerts (active grouped notable events). Under normal conditions, the processing time should be about 60 seconds.
Event Processing Volume	The number of events tracked in its_tracked_alerts, processed by the Rules Engine, and ingested into its_grouped_alerts per 10-minute time frame. Use this panel to troubleshoot grouping issues.
Event Processing Times	The median time each Rules Engine component takes to process events. This time does not include the real-time search delay and is calculated from the point at which event is received by the Rules Engine.
Event Processing Time by Policy	The median amount of time, in seconds, for each of your aggregation policies to process a single event.
Actions Processing Volume	The total number of episode actions created, queued, and processed by the Rules Engine every 10 minutes.
Actions Processing Times	The minimum, median, and maximum amount of time that the Rules Engine takes to process a single action.

Real-time Search Status

Panel	Description
Event Analytics Real-Time Search Status	The current state of real-time searches, including how much disk space they've used so far and how long they've been running. The searches exist in savesearches.conf.

HEC Tokens

Panel	Description
Event Analytics HEC Tokens	Shows which HEC tokens are available by host. If you create notable events using HEC tokens, this table shows which of your instances to send events to using the 'Auto Generated ITSI Event Management Token'. The absence of any of these tokens will lead to event analytics not working properly.

KV Store Lookups

Panel	Description
Event Analytics KV Store Lookups	Compares the created KV store lookups with the ones that are required for event analytics but not created. If a lookup is not created, you must add it to transforms.conf.

Action Queue

Panel	Description
Event Analytics Action Queue Errors	A count of action queue errors over time. To search for the action queue errors, run the following search: index=_internal sourcetype="itsi_internal_log" source="*itsi_notable_event_actions_queue_consumer*" ERROR

Event Size Check

Panel	Description
Notable Event Size Check	Notable event sizes over time. The maximum allowable event size is 10000 bytes. If your events exceed this limit, increase the TRUNCATE setting in props.conf.

Correlation Search

Panel	Description
Events By Correlation Searches and Indexes	The number of tracked alerts and grouped alerts per correlation search. Use the dropdown menu to filter by individual correlation searches.

Aggregation Policy

Panel	Description
Events by Aggregation Policy	The number of grouped alerts per aggregation policy. You can filter by one or more aggregation policies to compare the number of events per policy.