範例：整合來自 Datadog 和 Splunk 的通知

在 AWS 帳戶中建立自訂事件匯流排：

1. 前往 https://console.aws.amazon.com/events 開啟 Amazon EventBridge 主控台

2. 選擇匯流排、事件匯流排。

3. 在自訂事件匯流排下，選擇建立。

4. 在名稱下提供事件匯流排的名稱。建議的格式為 APMName-AWSIncidentDetectionResponse-EventBus。

   例如，如果您使用 Datadog 或 Splunk，請使用下列其中一項：

   • Datadog：Datadog-AWSIncidentDetectionResponse-EventBus

   • Splunk：Splunk-AWSIncidentDetectionResponse-EventBus

在您的 AWS 帳戶中建立 AWS Lambda 函式

1. 開啟 AWS Lambda 主控台的 Functions (函數) 頁面。

2. 選擇 Create function (建立函數)。

3. 選擇從頭開始撰寫索引標籤。

4. 在函式名稱中，使用 APMName-AWSIncidentDetectionResponse-LambdaFunction 格式輸入名稱。

   以下是 Datadog 和 Splunk 的範例：

   • Datadog：Datadog-AWSIncidentDetectionResponse-LambdaFunction

   • Splunk：Splunk-AWSIncidentDetectionResponse-LambdaFunction

5. 在執行時期中，輸入 Python 3.10。

6. 其餘欄位保留預設值。選擇 Create function (建立函數)。

7. 在程式碼編輯頁面上，將預設 Lambda 函式內容取代為下列程式碼範例中的函式。

   請注意下列程式碼範例中以 # 開頭的註解。這些註解指出要變更哪些值。

   Datadog 轉換程式碼範本：

   import logging
   import json
   import boto3
   
   logger = logging.getLogger()
   logger.setLevel(logging.INFO)
   
   # Change the EventBusName to the custom event bus name you created previously or use your default event bus which is called 'default'.
   # Example 'Datadog-AWSIncidentDetectionResponse-EventBus'
   EventBusName = "Datadog-AWSIncidentDetectionResponse-EventBus" 
   
   def lambda_handler(event, context):
       # Set the event["detail"]["incident-detection-response-identifier"] value to the name of your alert that is coming from your APM. Each APM is different and each unique alert will have a different name. 
       # Replace the dictionary path, event["detail"]["meta"]["monitor"]["name"], with the path to your alert name based on your APM payload. 
       # This example is for finding the alert name for Datadog.
       event["detail"]["incident-detection-response-identifier"] = event["detail"]["meta"]["monitor"]["name"] 
       logger.info(f"We got: {json.dumps(event, indent=2)}")
       
       client = boto3.client('events')
       response = client.put_events(
        Entries=[
                 {
                  'Detail': json.dumps(event["detail"], indent=2),
                  'DetailType': 'ams.monitoring/generic-apm', # Do not modify. This DetailType value is required.
                  'Source': 'GenericAPMEvent', # Do not modify. This Source value is required.
                  'EventBusName': EventBusName # Do not modify. This variable is set at the top of this code as a global variable. Change the variable value for your eventbus name at the top of this code.    
                }
        ]
       )
       print(response['Entries'])

   Splunk 轉換程式碼範本：

   import logging
   import json
   import boto3
   
   logger = logging.getLogger()
   logger.setLevel(logging.INFO)
   
   # Change the EventBusName to the custom event bus name you created previously or use your default event bus which is called 'default'. 
   # Example Splunk-AWSIncidentDetectionResponse-EventBus
   EventBusName = "Splunk-AWSIncidentDetectionResponse-EventBus" 
   
   def lambda_handler(event, context):
       # Set the event["detail"]["incident-detection-response-identifier"] value to the name of your alert that is coming from your APM. Each APM is different and each unique alert will have a different name. 
       # replace the dictionary path event["detail"]["ruleName"] with the path to your alert name based on your APM payload. 
       # This example is for finding the alert name in Splunk.
       event["detail"]["incident-detection-response-identifier"] = event["detail"]["ruleName"]
       logger.info(f"We got: {json.dumps(event, indent=2)}")
       
       client = boto3.client('events')
       response = client.put_events(
       Entries=[
                {
                 'Detail': json.dumps(event["detail"], indent=2),
                 'DetailType': 'ams.monitoring/generic-apm', # Do not modify. This DetailType value is required.
                 'Source': 'GenericAPMEvent', # Do not modify. This Source value is required.
                 'EventBusName': EventBusName # Do not modify. This variable is set at the top of this code as a global variable. Change the variable value for your eventbus name at the top of this code. 
               }
           ]
       )
       print(response['Entries'])

8. 選擇部署。

9. 將 PutEvents 許可新增至您要傳送轉換資料的目標事件匯流排的 Lambda 執行角色：

   1. 開啟 AWS Lambda 主控台的 Functions (函數) 頁面。

   2. 選取函式，然後在組態索引標籤上選擇許可。

   3. 在執行角色下選取角色名稱，以在 AWS Identity and Access Management 主控台中開啟執行角色。

   4. 在許可政策下，選取現有的政策名稱以開啟政策。

   5. 在此政策中定義的許可下，選擇編輯。

   6. 在政策編輯器頁面上，選取新增陳述式：

   7. 政策編輯器會新增類似下方新的空白陳述式

      

   8. 將自動產生的新陳述式取代為下列內容：

      
      {
        "Sid": "AWSIncidentDetectionResponseEventBus0",
        "Effect": "Allow",
        "Action": "events:PutEvents",
        "Resource": "arn:aws:events:{region}:{accountId}:event-bus/{custom-eventbus-name}"
      }

   9. 如果您在 Lambda 程式碼中使用預設事件匯流排，則資源是您在 步驟 2：建立自訂事件匯流排 中建立的自訂事件匯流排的 ARN，或是預設事件匯流排的 ARN。

10. 檢閱並確認已將所需許可新增至角色。

11. 選擇將此新版本設定為預設值，然後選擇儲存變更。

1. 前往 https://console.aws.amazon.com/events 開啟 Amazon EventBridge 主控台

2. 選擇規則，然後選取與您的 APM 相關聯的合作夥伴事件匯流排。以下是合作夥伴事件匯流排的範例：

   • Datadog：aws.partner/datadog.com/eventbus-name

   • Splunk：aws.partner/signalfx.com/RandomString

3. 選擇建立規則，以建立新的 EventBridge 規則。

4. 針對規則名稱，以下列格式 APMName-AWS Incident Detection and Response-EventBridgeRule 輸入名稱，然後選擇下一步。範例名稱如下：

   • Datadog：Datadog-AWSIncidentDetectionResponse-EventBridgeRule

   • Splunk：Splunk-AWSIncidentDetectionResponse-EventBridgeRule

5. 針對事件來源，選取 AWS 事件或 EventBridge 合作夥伴事件。

6. 範例事件和建立方法保留預設值。

7. 針對事件模式，選擇如下：

   1. 事件來源：EventBridge 合作夥伴。

   2. 合作夥伴：選取您的 APM 合作夥伴。

   3. 事件類型：所有事件。

   以下是範例事件模式：

   範例 Datadog 事件模式

   

   範例 Splunk 事件模式

   

8. 針對目標，選擇如下：

   1. 目標類型：AWS 服務

   2. 選取目標：選擇 Lambda 函式。

   3. 函式：您在步驟 2 中建立的 Lambda 函式名稱。

9. 選擇下一步、儲存規則。