EventBridge Module

Configuration in this directory creates eventbridge to send the aws events to your coralogix account.

Usage

module "eventbridge_coralogix" {
  source                         = "github.com/coralogix/terraform-coralogix-aws//modules/eventbridge"
  eventbridge_stream             = var.coralogix_eventbridge_stream_name
  role_name                      = var.eventbridge_role_name
  private_key                    = var.coralogix_privatekey
  coralogix_region               = var.coralogix_region
  custom_url                     = var.custom_url
  sources                        = var.eventbridge_sources
  application_name               = var.application_name
  policy_name                    = var.policy_name
}

• Override Coralogix applicationName: The application name by default is the eventbridge delivery stream name, but it can be overriden by setting an environment variable called application_name.

Coralogix account region

The coralogix region variable accepts one of the following regions:

• EU1
• EU2
• AP1
• AP2
• AP3
• US1
• US2
• Custom

Endpoints

Region	Logs Endpoint
EU1	https://ingress.eu1.coralogix.com/aws/event-bridge
EU2	https://ingress.eu2.coralogix.com/aws/event-bridge
AP1	https://ingress.ap1.coralogix.com/aws/event-bridge
AP2	https://ingress.ap2.coralogix.com/aws/event-bridge
AP3	https://ingress.ap3.coralogix.com/aws/event-bridge
US1	https://ingress.us1.coralogix.com/aws/event-bridge
US2	https://ingress.us2.coralogix.com/aws/event-bridge
Custom	https://ingress.<custom_domain>/aws/event-bridge

Requirements

Name	Version
terraform	>= 1.9
aws	>= 6.0

Providers

Name	Version
aws	>= 6.0

Resources

Name	Type
aws_cloudwatch_event_api_destination.api-connection	resource
aws_cloudwatch_event_connection.event-connectiong	resource
aws_cloudwatch_event_rule.eventbridge_rule	resource
aws_cloudwatch_event_target.my_event_target	resource
aws_iam_policy.eventbridge_policy	resource
aws_iam_role.eventbridge_role	resource
aws_iam_role_policy_attachment.eventbridge_policy_attachment	resource
aws_caller_identity.current_identity	data source
aws_region.current_region	data source

Inputs

Name	Description	Type	Default	Required
application_name	Coralogix application name	string	n/a	yes
coralogix_region	Coralogix account region. Accepted values: EU1, EU2, AP1, AP2, AP3, US1, US2, Custom	string	n/a	yes
custom_url	Custom coralogix url	string	null	no
eventbridge_stream	AWS eventbridge delivery stream name	string	n/a	yes
private_key	Your Coralogix private key	string	n/a	yes
role_name	The name of the eventbridge role	string	n/a	yes
sources	The services for which we will send events	list(any)	[ "aws.ec2", "aws.autoscaling", "aws.cloudwatch", "aws.events", "aws.health", "aws.rds" ]	no
policy_name	Custom aws_iam_policy	string	EventBridge_policy	no
detail_type	AWS eventbridge detail type for the rule to filter by	list(string)	null	no

Outputs

No outputs.

Events Sources

EC2

• AWS API call via cloudtrail
• EBS Fast Snapshot Restore State-change Notification
• EBS Multi-Volume Snapshots Completion Status
• EBS Snapshot Notification
• EBS Volume Notification
• EC2 AMI State Change
• EC2 Fast Launch State-change Notification
• EC2 Instance Rebalance Recommendation
• EC2 Instance State-change Notification
• EC2 Spot Instance Interruption Warning
• EC2 Spot Instance Request Fulfillment

AutoScaling

• AWS API call via cloudtrail
• Instance launch and terminate
• Instance refresh

Cloudwatch

• AWS API call via cloudtrail
• CloudWatch alarm state change
• CloudWatch alarm configuration change

Events

• AWS API call via cloudtrail
• EventBridge scheduled event

Health

• AWS API call via cloudtrail
• Specific health events

RDS

• AWS API call via cloudtrail
• DB cluster event
• DB cluster snapshot event
• DB instance event
• DB parameter group event
• DB security group event
• DB snapshot event

For further information on additional events sources and event types, see this AWS doc

Examples

Examples can be found under the examples directory