Cloud SIEM Audit Logging

The Audit Event Index and System Event Index provide event logs in JSON format on your account activity so you to monitor and audit changes. By default the Audit Event Index and System Event Index are enabled for Cloud SIEM and Enterprise accounts.

note

This page describes functionality that is available to users whose Cloud SIEM URL ends in sumologic.com.

Where to find documentation  

To learn more, see Cloud SIEM audit log definitions.

Scoping your search

This section explains how to scope a search of the Audit Event Index and System Event Index to return Cloud SIEM events.

Limit search to user or system events

Cloud SIEM audit events are stored in two Partitions:

• sumologic_audit_events. This index contains user action events, which are events that were triggered by a user action, either from the UI or an API. For example, a user created an Insight from a Signal using the Cloud SIEM UI.
• sumologic_system_events. This index contains system action events, which are events that were triggered by the system. For example, an Insight was generated by Cloud SIEM.

Use _index=sumologic_audit_events to limit results to events related to user actions

Use  _index=sumologic_system_events to limit results to events related to system actions.

Limit search to Cloud SIEM events

You can use the subsystem field, which every event log contains, to limit the events returned to Cloud SIEM-related events:

subsystem=cse*

For information about other fields you can use in Audit Index searches, see auto-generated documentation at the documentation URL for your deployment.

Limit search by Cloud SIEM feature

The table below shows the _sourceCategory that is assigned to event logs by Cloud SIEM feature.

Product Feature	_sourceCategory Value
Action	cseAction
Aggregation Rule	cseRule
Configure Assigned Insight Emails (Relates to the option, on the Actions page, that causes a user to receive an email whenever another user assigns an Insight to them.)	cseConfiguration
Automation	cseAutomation
Chain Rule	cseRule
Cloud SOAR Incident	cseCloudSoar
Context Action	cseContextAction
Custom Entity Type	cseCustomEntityType
Custom Insight	cseCustomInsight
Custom Match List Column	cseCustomMatchListColumn
Custom Tag Schema	cseCustomTagSchema
Customer Sourced Entity Lookup Table	cseCustomerSourcedEntityLookupTable
Enrichment	cseEnrichment
Entity	cseEntity
Entity Criticality Config	cseEntityCriticalityConfig
Entity Domain Configuration	cseEntityNormalization
Entity Group Configuration	cseEntityGroupConfiguration
Entity Note	cseEntityNote
Favorite Field	cseFavoriteField
First Seen Rule	cseRule
Insight	cseInsight
Insight Comment	cseInsightComment
Inventory Entity Lookup Table	cseInventoryEntityLookupTable
Log Mapping	cseLogMapping
Match List	cseMatchList
Match Rule	cseRule
MITRE ATT&CK Coverage	cseMitreAttackCoverage
Network Block	cseNetworkBlock
Outlier Rule	cseRule
Rule Tuning Expression	cseRuleTuningExpression
Streaming Export Configuration	cseStreamingExportConfiguration
Sumo Mapping	cseSumoMapping
Suppressed List	cseSuppressList
Templated Match Rule	cseRule
Threat Intel Source (Applies to all source types on the Threat Intel page.)	cseThreatIntelSource
Threat Intel Source Poll	cseThreatIntelSource
Threshold Rule	cseRule
Virus Total Configuration	cseConfiguration
Yara Rule	cseYara
Yara Source	cseYara

_sourceName and _sourceHost assignment

The _sourceName and _sourceHost fields are assigned to audit event logs as follows.

Metadata Field	Assignment Description
_sourceName	Value of the common parameter, eventName.
_sourceHost	The remote IP address of the host that made the request. If not available the value will be no_sourceHost.

Common parameters

Each audit event log has common keys that categorize it to a product area and provide details of the event.

Parameter	Description	Data Type
accountId	The unique identifier of the organization.	String
eventId	The unique identifier of the event.	String
eventName	The name of the event.	String
eventTime	The event timestamp in ISO 8601 format.	String
eventFormatVersion	The event log format version.	String
operator	Information of who did the operation. If it's missing, the Sumo service was the operator.	JSON object of Strings
subsystem	The product area of the event.	String

Search for Cloud SIEM events 

To search the Audit Event Index or System Event Index for logs that describe Cloud SIEM events:

1. Start a log search.
2. In the search tab, enter a search using _index to specify the partition you want to search, and other metadata or fields to further scope your search. For example:

   _index=sumologic_system_events
   | json auto
   | where subsystem="cse*"
3. Choose the time range for your search.
4. Click Start to run the search.

Example event log

Here is an example InsightCreated event log.

Index retention period 

By default, the retention period of the Audit Event Index is the same as the retention period of your Default Partition. You can change the retention period by editing the relevant partitions, sumologic_audit_events and sumologic_system_events. For more information, see Create and Edit a Partition.