View a markdown version of this page

Inserisci allarmi dagli APM con integrazione diretta EventBridge - Guida per l'utente AWS Incident Detection and Response
Opzione 1: Utilizzo CloudFormationOpzione 2: integrazione manuale

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Inserisci allarmi dagli APM con integrazione diretta EventBridge

L'argomento seguente mostra il processo di invio degli allarmi ad AWS Incident Detection and Response da strumenti di Application Performance Monitoring (APM) che si integrano direttamente con Amazon. EventBridge Per un elenco completo degli APM con integrazione diretta con Amazon EventBridge, consulta le integrazioni di Amazon. EventBridge

Puoi distribuire il CloudFormation modello fornito o configurare manualmente questa integrazione. Prima di configurare l'integrazione, verifica che il ruolo AWS collegato al servizio (SLR) sia stato creato nei AWSServiceRoleForHealth_EventProcessor tuoi account.

Opzione 1: Utilizzo CloudFormation

È disponibile un CloudFormation modello per semplificare il processo di creazione dell'infrastruttura di integrazione necessaria per inserire gli allarmi per AWS Incident Detection and Response dal tuo APM con l'integrazione Amazon. EventBridge

Nota

  • Sono previsti costi aggiuntivi per le risorse distribuite tramite questo CloudFormation modello (ad esempio: Lambda e). EventBridge Per ulteriori informazioni sui prezzi di questi servizi, consulta Prezzi. AWS

  • Distribuisci questo CloudFormation modello in ogni AWS account e regione in cui AWS Incident Detection and Response deve inserire gli allarmi. Gli incidenti e i casi di supporto vengono aperti sull' AWS account da cui è stato ricevuto l'avviso APM.

  • Questo documento utilizza New Relic come esempio, tuttavia il CloudFormation modello può essere utilizzato per qualsiasi APM dotato di integrazione SaaS con Amazon. EventBridge

  • Dopo aver testato l'integrazione, rimuovi le istruzioni logger.info () TransformLambdaFunction per evitare che il payload venga visualizzato in Amazon Logs. CloudWatch

Prerequisiti per l'implementazione di questo modello: CloudFormation

  • Una fonte di Partner Event deve essere configurata in Amazon. EventBridge Per istruzioni su come configurare l'APM come fonte di eventi, consulta Ricezione di eventi da un partner SaaS con Amazon EventBridge nella Amazon EventBridge User Guide.

  • La TransformLambdaFunction (funzione Lambda) nel modello deve essere modificata per impostare il valore desiderato in base ["detail"]["incident-detection-response-identifier"] al percorso JSON del nome dell'avviso nel payload APM.

Fasi dei prerequisiti:

  1. Aprire la EventBridge console. Nel menu Integrazione, seleziona Sorgenti di eventi per i partner.

    • Cerca il tuo APM nella casella dei EventBridge partner Amazon.

    • Scegli Configurazione, quindi segui le istruzioni fornite.

      • Nota: l'ultimo passaggio è scegliere Associa a Event Bus nella console della sorgente dell'evento Partner. Selezionando questa opzione si crea automaticamente un Partner Event Bus con lo stesso nome della sorgente dell'evento Partner (i nomi devono corrispondere).

    • Copia il nome del Partner Event Bus o della fonte. L'Event Bus o sorgente viene utilizzato come parametro, denominatoPartnerEventBusNameParameter, durante la distribuzione del CloudFormation modello.

      • Esempio di New Relic: aws.partner/newrelic.com/1234567/source_name

    • Copia la prima parte del Partner Event Bus o della sorgente da inserire PartnerEventBusPrefixParameter durante l'implementazione del CloudFormation modello.

      • Un esempio di New Relic è aws.partner/newrelic.com

  2. Scarica e modifica il CloudFormation modello.

    • TransformLambdaFunctionIndividua il file nel modello

    • Sotto def lambda_handler(event, context) impostato event["detail"]["incident-detection-response-identifier"] sul percorso json in cui appare il nome dell'allarme nel payload JSON dell'allarme APM. Ogni APM avrà un percorso diverso. Di seguito sono riportati alcuni esempi, tuttavia i payload specifici potrebbero essere diversi.

      • Esempio di New Relic:. event["detail"]["incident-detection-response-identifier"] = event["detail"]["workflowName"]

      • Esempio di Datadog: event["detail"]["incident-detection-response-identifier"] = event["detail"]["meta"]["monitor"]["name"]

      • Esempio di Splunk: event["detail"]["incident-detection-response-identifier"] = event["detail"]["ruleName"]

    • Salva il CloudFormation modello.

Distribuzione del CloudFormation modello:

  1. Apri la CloudFormation console nell'account e nella regione di destinazione.

  2. Scegli Crea stack, Con nuove risorse (standard)

    • Seleziona Scegli un modello esistente, Carica un file modello, Scegli file, quindi carica il CloudFormation modello salvato localmente.

  3. Specifica i dettagli dello stack:

    • Inserisci il nome dello stack (esempio: NewRelicIntegrationForIDR).

    • Specificate i valori dei parametri ottenuti durante il completamento del prerequisito.

      • APMNameParameter(Esempio:NewRelic)

      • PartnerEventBusNameParameter(Esempio:aws.partner/newrelic.com/1234567/source_name)

      • PartnerEventBusPrefixParameter(Esempio:aws.partner/newrelic.com)

    • Scegli Avanti.

  4. Configura le opzioni dello stack:

    • Scorri fino alla fine della pagina e seleziona la casella CloudFormation per consentire la creazione di risorse IAM con nomi personalizzati.

  5. Revisione e creazione:

    • Verifica che i valori dei parametri siano configurati correttamente e scegli Invia.

  6. Lo CloudFormation stack distribuisce le risorse necessarie per integrare gli eventi APM in AWS Incident Detection and Response. Attendi che venga visualizzato lo stato dello stack. CREATE_COMPLETE

  7. Lo CloudFormation stack crea le seguenti risorse, supponendo che i valori di esempio siano stati inseriti nei parametri di New Relic e siano stati eseguiti nella US-EAST-1 regione.

    • CustomEventBus: NewRelic-AWSIncidentDetectionResponse-EventBus

    • EventBridgeRule: aws. partner/newrelic. com/1234567/nome_sorgente | NewRelic-AWSIncidentDetectionResponse-EventBridgeRule

    • TransformLambdaExecutionRole: IDR-TransformLambdaExecutionRole-us-east-1

    • TransformLambdaFunction: NewRelic-AWSIncidentDetectionResponse-Lambda-Transform

    • TransformLambdaPermission: NewRelicIntegrationForIDR-TransformLambdaPermission - [stringa_casuale]

Test di integrazione

Dopo aver implementato lo stack, testate l'integrazione inviando un payload di prova dal vostro APM:

  1. Accedi alla console Lambda e seleziona la funzione. APMNameParameter-AWSIncidentDetectionResponse-Lambda-Transform Selezionare la scheda Monitor (Monitora).

  2. Cerca un'invocazione riuscita nei grafici delle metriche.

  3. Scegli View Amazon CloudWatch Logs per controllare i flussi di log relativi al payload di test o a eventuali errori.

Condivisione del tuo Event Bus ARN con AWS Incident Detection and Response

  1. Apri la EventBridge console Amazon. Seleziona Event bus.

  2. Copia l'ARN del bus di eventi personalizzato creato come parte dello CloudFormation stack, (esempio: arn:aws:events:us-east-1:123456789123:event-bus/NewRelic-AWSIncidentDetectionResponse-EventBus.)

  3. Durante il processo di onboarding, AWS Incident Detection and Response crea una EventBridge regola gestita su questo bus di eventi personalizzato per inserire gli allarmi APM.

Opzione 2: integrazione manuale

Diagramma che mostra un esempio di integrazione utilizzando un bus di eventi partner o altre sorgenti di bus di AWS eventi.

Completa i passaggi seguenti per ogni AWS account e AWS regione da cui AWS Incident Detection and Response deve inserire gli allarmi. AWS Incident Detection and Response consiglia di impostare gli allarmi nello stesso AWS account e nella stessa regione delle risorse applicative per velocizzare l'identificazione e l'analisi delle risorse interessate. Gli incidenti e i casi di supporto vengono aperti sull' AWS account da cui è stato ricevuto l'avviso APM.

  1. Crea un bus di eventi per i EventBridge partner configurando il tuo APM come fonte di eventi per i EventBridge partner Amazon (ad esempio,). aws.partner/apm_name/integrationName Per linee guida sulla configurazione dell'APM come fonte di eventi, consulta Ricezione di eventi da un partner SaaS con Amazon. EventBridge

  2. Effettua una delle seguenti operazioni:

    • (Consigliato) Crea un bus di eventi EventBridge personalizzato denominato. $YourApmName-AWSIncidentDetectionResponse-EventBus

    • (Alternativa) Utilizzate il bus di EventBridge eventi predefinito anziché un bus di eventi personalizzato.

    AWS Incident Detection and Response installerà una regola gestita (AWSHealthEventProcessorEventSource-DO-NOT-DELETE) sul bus di eventi personalizzato o predefinito tramite AWSServiceRoleForHealth_EventProcessor SLR. L'origine della regola sarà il bus di eventi personalizzato o predefinito, la destinazione della regola sarà AWS Incident Detection and Response e la regola corrisponderà allo schema di acquisizione di eventi APM di terze parti.

  3. Crea una funzione Lambda denominata $YourApmName-AWSIncidentDetectionResponse-LambdaFunction per trasformare gli eventi del bus di eventi del tuo partner. Gli eventi trasformati corrisponderanno alla regola AWSHealthEventProcessorEventSource-DO-NOT-DELETE gestita.

    • Gli eventi trasformati includono un identificatore AWS Incident Detection and Response univoco e impostano il tipo di origine e di dettaglio dell'evento sui valori richiesti. Ciò consente alla struttura del payload JSON trasformata di corrispondere al modello di regole gestite.

    • Imposta l'obiettivo della funzione Lambda sul bus di eventi personalizzato (consigliato) creato nel passaggio 2 o sul bus di eventi predefinito.

  4. Crea una EventBridge regola e definisci i modelli di eventi che corrispondono all'elenco di eventi da inviare ad AWS Incident Detection and Response. L'origine della regola è il bus di eventi partner creato nella Fase 1 (aws.partner/apm_name/integrationName). L'obiettivo della regola è la funzione Lambda creata nel passaggio 3 ([apm_name]-AWSIncidentDetectionResponse-LambdaFunction). Per linee guida sulla definizione della EventBridge regola, consulta EventBridge le regole di Amazon.

Per un esempio dettagliato su come configurare manualmente le integrazioni dei bus di eventi dei partner con AWS Incident Detection and Response, consulta Integrazione delle notifiche da Datadog e Splunk.