Skip to main content

Amazon EventBridge integration

You can use an APEX AIOps Incident Management custom integration to ingest events from Amazon EventBridge.

Before you begin

Before you set up your Amazon EventBridge integration:

  • Make sure you are signed in to your Incident Management instance.

  • Make sure you are signed in to your AWS account.

  • Open the Amazon EventBridge console at https://console.aws.amazon.com/events/.

Create a custom integration in Incident Management

  1. In Incident Management, navigate to Integrations > Ingestion Services > Create your own Integration.

  2. Click Add New Integration.

  3. Under APEX AIOps Incident Management Endpoint, enter a unique name for your new integration (required).

    Note

    The name of the integration can be anything you choose. Incident Management will automatically generate an API endpoint URL independent of what you enter for this field.

  4. Under API Description, enter a description for the integration (optional).

  5. Under Data Type, select Events.

  6. Click Save.

  7. Keep the web page for this integration open in your browser while you complete the remaining steps in EventBridge.

Create a new rule in EventBridge

Within the EventBridge console, navigate to the EventBridge home page and click Create rule. Then fill out the sections as follows:

  1. Define rule detail:

    1. Enter a unique name for the rule. Optionally, provide a description.

    2. Select an event bus for the rule to apply to.

    3. Make sure that Enable the rule on the selected event bus is checked.

    4. Under "Rule type," select Rule with an event pattern.

    5. Click Next.

  2. Build event pattern:

    1. Under the "Event source" section, select AWS events or EventBridge partner events.

    2. Under the "Event pattern" section, set the event source, AWS service, and event type. You can also edit the event pattern by clicking "Edit pattern."

    3. Click Next.

  3. Select target(s):

    1. Under "Target types," select EventBridge API destination.

    2. Under "API destination," select Create a new API destination.

    3. Enter a unique name for the API destination, such as "APEX AIOps Incident Management." Optionally, provide a description.

    4. Under API destination endpoint, paste the endpoint URL for your Incident Management integration.

      The endpoint URL is provided for you in Incident Management on the page for your custom integration, under Configuration Information > APEX AIOps Incident Management Endpoint.

    5. Under "HTTP method," select POST.

    6. Under "Connection," select Create a new connection.

    7. Enter a unique name for the connection. Optionally, provide a description.

    8. Under "Destination type," select Other.

    9. Under "Authorization type," select API Key.

    10. Under "API key name," enter a unique name for the API key. Then, under Value, paste your Incident Management API key.

    11. Under "Execution role," select Create a new role for this specific resource.

    12. Click Next.

  4. Configure tags:

    1. Optionally, click Add new tag to add any desired tags.

    2. Click Next.

  5. Review and create:

    1. Scroll down to the bottom of the page and click Create rule.

EventBridge is now configured to send events to your Incident Management instance.

Configure the custom integration in Incident Management

  1. Go to your Incident Management instance.

  2. Open the page for your custom integration by going to Integrations > Ingestion Services > Create your own Integration > your-integration-name.

  3. In the Map Your Data section, you can view cached payloads of incoming events sent from EventBridge.

  4. Map your payload fields to the corresponding Incident Management fields.

    For a complete list of mapping types, save options, and instructions on how to use them, read Use mapping types in custom integrations.

  5. Go to the top of the page and click Save.