--- sourceDocument: Brazil IT Operations Management sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # AWS events-driven discovery # AWS events-driven discovery {#ariaid-title1} Release version: Brazil Updated October 15, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Use AWS events-driven discovery to keep your CMDB current automatically when AWS resource configurations change, without waiting for a scheduled Discovery run. ## How it works {#aws-events-driven-discovery__how-it-works} Figure 1. Overview of the AWS events-driven discovery 1. AWS Config detects a change in the lifecycle state or configuration of a cloud resource. 2. AWS Config sends a Simple Notification Service (SNS) notification to the ServiceNow Cloud Events REST API. 3. The API writes the event to the Cloud Event \[sn_cmp_cloud_event\] table if it meets any of the following criteria: * The Type of the event is SubscriptionConfirmation. * The Type of the event is Notificationand messageType is ConfigurationItemChangeNotification. * Amazon CloudWatch raised the event for a tag change on a Configuration Item (CI). {#aws-events-driven-discovery__ul_pb3_rhz_vvb} 4. The Cloud Event Scheduler picks up events in the Ready state for batch processing and updates the affected resource in the CMDB. When response mappings are available, event-driven discovery uses them to update the CI. Otherwise, it triggers the appropriate Discovery pattern. {#aws-events-driven-discovery__ol_vyd_ljg_skc} ## Requirements for AWS events-driven discovery {#aws-events-driven-discovery__requirements} Before configuring AWS events-driven discovery, verify the following requirements are met: * The Discovery (com.snc.discovery) plugin is activated. * Valid AWS service accounts with associated logical datacenters are discovered. * Required roles: discovery_admin and sn_cmp.cloud_event_integration. * An AWS role with access to SNS, AWS Config, and the resource types you want to track. * Download the [Cloud Discovery patterns spreadsheet](https://downloads.docs.servicenow.com/resource/enus/api/servicenow-discovery-patterns-api-details.xlsx) so you can grant user permissions required for running the Discovery patterns. In addition to permissions, the spreadsheet also includes useful information such as pattern names, types, CI Classes, and links to vendor documentation. New patterns are available quarterly, so check periodically to be sure you have the latest version of the spreadsheet.{#aws-events-driven-discovery__cloud-discovery-api-ph-short-prereq} {#aws-events-driven-discovery__ul_cnr_zjg_skc} For setup instructions, see [Configure AWS Config event notifications](https://www.servicenow.com/docs/_hP6MXGmqrrAnup8jb0_BA "Configure the Amazon Web Services (AWS) Config service to send event notifications to the ServiceNow instance for any changes in the lifecycle state of a resource."). ## Configuration properties {#aws-events-driven-discovery__configuration-properties} {#aws-events-driven-discovery__table_config_properties__entry__2} | Property | Description | |-|-| | sn_cmp.cloud_event.use_response_mapping_aws | Determines the CMDB update method. When set to True and suitable response mappings are available, event-driven discovery uses response mappings to create or update the CI in the CMDB. Otherwise, event-driven discovery triggers the appropriate Discovery pattern. * Type: Boolean * Default: true | | sn_cmp.cloud_event.parallel_scheduler_count | Controls the number of Cloud Event Scheduler instances running in parallel. Increase this value to improve event processing rate when event inflow is high. For more information, see [Scale the AWS cloud event schedulers](https://www.servicenow.com/docs/ql1OvZh2UiHTeu1U4TJAWQ "Scale the cloud event schedulers to improve the Amazon Web Services (AWS) event processing rate of the ServiceNow instance."). * Type: Integer * Default: 1 | | sn_cmp.error_events.default_domain | The sys_id of the service-provider domain. Set this property to limit the visibility of failed events to the service-provider administrator. * Type: String * Default: global {#aws-events-driven-discovery__ul_efl_1hg_skc} | [ ] {#aws-events-driven-discovery__table_config_properties} ## Domain separation {#aws-events-driven-discovery__domain-separation} During event processing, the Cloud Event Scheduler identifies the domain of the associated service account and assigns it to the event. If domain identification fails before processing, the event can remain unassigned and be visible across all domains. To limit the visibility of failed events to the service-provider administrator, set the sn_cmp.error_events.default_domain property to the sys_id of the service-provider domain. **Related tasks** * [Configure AWS Config event notifications](https://www.servicenow.com/docs/_hP6MXGmqrrAnup8jb0_BA "Configure the Amazon Web Services (AWS) Config service to send event notifications to the ServiceNow instance for any changes in the lifecycle state of a resource.") * [Scale the AWS cloud event schedulers](https://www.servicenow.com/docs/ql1OvZh2UiHTeu1U4TJAWQ "Scale the cloud event schedulers to improve the Amazon Web Services (AWS) event processing rate of the ServiceNow instance.") * [Create a database index for the Cloud Events table](https://www.servicenow.com/docs/THRs04tp4~a1uyCY0TUewQ "Create a database index from the specified columns of the Cloud Events [sn_cmp_cloud_event] table to improve the AWS cloud event processing performance.") **Related reference** * [AWS discovery using patterns](https://www.servicenow.com/docs/Y0yjdHKR~_I76hi21l9C4A "Discovery and Service Mapping Patterns uses patterns to discover components of the Amazon AWS Cloud deployment during horizontal discovery. Discovering some of these resources might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.") * [AWS Events pattern-based discovery](https://www.servicenow.com/docs/CCOgb6_Di_sVR1YwEQQDtg "Discovery uses event patterns to update Amazon AWS Cloud component data in near real-time. Discovering some of these resources might require updating to the latest version of the Discovery and Service Mapping Patterns application from the ServiceNow Store.")