Esempio: integra le notifiche di Datadog e Splunk

Crea un bus di eventi personalizzato nel tuo AWS account:

1. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/

2. Scegli Buses, Event bus.

3. In Custom event bus, scegli Crea.

4. Fornisci un nome per il bus dell'evento in Nome. Il formato consigliato è APMName- AWSIncidentDetectionResponse-EventBus.

   Ad esempio, usa uno dei seguenti se usi Datadog o Splunk:

   • Datadog: Datadog-AWSIncidentDetectionResponse-EventBus

   • Splunk: Splunk-AWSIncidentDetectionResponse-EventBus

Crea una AWS Lambda funzione nel tuo account AWS

1. Apri la pagina Funzioni sulla AWS Lambda console.

2. Scegli Crea funzione.

3. Scegli la scheda Autore da zero.

4. Per Nome della funzione, inserisci un nome utilizzando il formatoAPMName-AWSIncidentDetectionResponse-LambdaFunction.

   Di seguito sono riportati alcuni esempi per Datadog e Splunk:

   • Datadog: Datadog-AWSIncidentDetectionResponse-LambdaFunction

   • Splunk: Splunk-AWSIncidentDetectionResponse-LambdaFunction

5. Per Runtime, inserisci Python 3.10.

6. Lascia i campi rimanenti con i valori predefiniti. Scegli Crea funzione.

7. Nella pagina di modifica del codice, sostituisci il contenuto predefinito della funzione Lambda con la funzione nei seguenti esempi di codice.

   Notate i commenti che iniziano con # nei seguenti esempi di codice. Questi commenti indicano quali valori modificare.

   Modello di codice di trasformazione 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'])

   Modello di codice di trasformazione 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. Seleziona Deploy (Implementa).

9. Aggiungi l'PutEventsautorizzazione al ruolo di esecuzione Lambda per il bus di eventi a cui stai inviando i dati trasformati:

   1. Apri la pagina Funzioni sulla AWS Lambda console.

   2. Seleziona la funzione, quindi scegli Autorizzazioni nella scheda Configurazione.

   3. In Ruolo di esecuzione, seleziona il nome del ruolo per aprire il ruolo di esecuzione nella AWS Identity and Access Management console.

   4. In Criteri di autorizzazione, seleziona il nome del criterio esistente per aprire il criterio.

   5. In Autorizzazioni definite in questa politica, scegli Modifica.

   6. Nella pagina dell'editor delle politiche, seleziona Aggiungi nuova dichiarazione:

   7. L'editor delle politiche aggiunge una nuova dichiarazione vuota simile alla seguente

      

   8. Sostituisci la nuova istruzione generata automaticamente con la seguente:

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

   9. La risorsa è l'ARN del bus eventi personalizzato che hai creato Passaggio 2: crea un bus di eventi personalizzato o l'ARN del tuo bus eventi predefinito se utilizzi il bus eventi predefinito nel tuo codice Lambda.

10. Verifica e conferma che le autorizzazioni richieste siano state aggiunte al ruolo.

11. Scegli Imposta questa nuova versione come predefinita, quindi scegli Salva modifiche.

1. Apri la EventBridge console Amazon all'indirizzo https://console.aws.amazon.com/events/

2. Scegli Regole, quindi seleziona il bus degli eventi partner associato al tuo APM. Di seguito sono riportati alcuni esempi di bus per eventi partner:

   • Datadog: aws. partner/datadog.com/eventbus-nome

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

3. Scegli Crea regola per creare una nuova EventBridge regola.

4. Per il nome della regola, inserisci un nome nel formato seguenteAPMName-AWS Incident Detection and Response-EventBridgeRule, quindi scegli Avanti. Di seguito sono riportati alcuni esempi di nomi:

   • Datadog: Datadog-AWSIncidentDetectionResponse-EventBridgeRule

   • Splunk: Splunk-AWSIncidentDetectionResponse-EventBridgeRule

5. Per Event source, seleziona AWS events o EventBridge partner events.

6. Lascia Sample event e Creation method come valori predefiniti.

7. Per Event pattern, scegliete quanto segue:

   1. Fonte dell'evento: EventBridge partner.

   2. Partner: seleziona il tuo partner APM.

   3. Tipo di evento: tutti gli eventi.

   Di seguito sono riportati esempi di modelli di eventi:

   Esempio di pattern di eventi Datadog

   

   Esempio di pattern di eventi Splunk

   

8. Per Targets, scegli quanto segue:

   1. Tipi di target: AWS servizio

   2. Seleziona un obiettivo: scegli la funzione Lambda.

   3. Funzione: il nome della funzione Lambda creata nel passaggio 2.

9. Scegliete Avanti, Salva regola.