Skip to content

CloudTrail  >  Structures  >  InsightSelector

InsightSelector

Structure Class

InsightSelector dataclass

A JSON string that contains a list of Insights types that are logged on a trail or event data store.

Attributes

event_categories class-attribute instance-attribute 
event_categories: list[SourceEventCategory] | None = None

Select the event category on which Insights should be enabled.

  • If EventCategories is not provided, the specified Insights types are enabled on management API calls by default.

  • If EventCategories is provided, the given event categories will overwrite the existing ones. For example, if a trail already has Insights enabled on management events, and then a PutInsightSelectors request is made with only data events specified in EventCategories, Insights on management events will be disabled.

insight_type class-attribute instance-attribute 
insight_type: InsightType | None = None

The type of Insights events to log on a trail or event data store. ApiCallRateInsight and ApiErrorRateInsight are valid Insight types.

The ApiCallRateInsight Insights type analyzes write-only management API calls or read and write data API calls that are aggregated per minute against a baseline API call volume.

The ApiErrorRateInsight Insights type analyzes management and data API calls that result in error codes. The error is shown if the API call is unsuccessful.