Persyaratan Muatan Untuk Menelan Peringatan APM dengan EventBridge

Dari mana Deteksi dan Respons Insiden menyerap peringatan APM?

AWS Incident Detection and Response menginstal aturan terkelola pada bus acara tempat Anda mengirim payload terakhir yang diubah. Ini adalah praktik terbaik untuk membuat bus acara khusus untuk tujuan ini.

Format apa yang harus diisi muatan?

Kunci JSON minimum berikut: pasangan nilai diperlukan jika peristiwa bus tertelan oleh Deteksi dan Respons Insiden AWS:

{  
    "detail-type": "ams.monitoring/generic-apm",  
    "source": "GenericAPMEvent"  
    "detail": {  
        "incident-detection-response-identifier": "Your alarm name from your APM",  
    }  
}

Contoh berikut menunjukkan acara dari bus acara mitra sebelum dan sesudah itu diubah.

Sebelum transformasi:

{  
    "version": "0",  
    "id": "a6150a80-601d-be41-1a1f-2c5527a99199",  
    "detail-type": "Datadog Alert Notification",  
    "source": "aws.partner/datadog.com/Datadog-aaa111bbbc",  
    "account": "123456789012",  
    "time": "2023-10-25T14:42:25Z",  
    "region": "us-east-1",  
    "resources": [],  
    "detail": {  
        "alert_type": "error",  
        "event_type": "query_alert_monitor",  
        "meta": {  
            "monitor": {  
                "id": 222222,  
                "org_id": 3333333333,  
                "type": "query alert",  
                "name": "UnHealthyHostCount",  
                "message": "@awseventbridge-Datadog-aaa111bbbc",  
                "query": "max(last_5m):avg:aws.applicationelb.un_healthy_host_count{aws_account:123456789012} <= 1",  
                "created_at": 1686884769000,  
                "modified": 1698244915000,  
                "options": {  
                    "thresholds": {  
                        "critical": 1.0  
                    }  
                },  
            },  
            "result": {  
                "result_id": 7281010972796602670,  
                "result_ts": 1698244878,  
                "evaluation_ts": 1698244868,  
                "scheduled_ts": 1698244938,  
                "metadata": {  
                    "monitor_id": 222222,  
                    "metric": "aws.applicationelb.un_healthy_host_count"  
                }  
            },  
            "transition": {  
                "trans_name": "Triggered",  
                "trans_type": "alert"  
            },  
            "states": {  
                "source_state": "OK",  
                "dest_state": "Alert"  
            },  
            "duration": 0  
        },  
        "priority": "normal",  
        "source_type_name": "Monitor Alert",  
        "tags": [  
            "aws_account:123456789012",  
            "monitor"  
        ]  
    }  
}

Perhatikan bahwa sebelum acara diubah, detail-type dan source menunjukkan rincian APM di mana peringatan berasal. Ini harus dimodifikasi sebelum dikonsumsi. incident-detection-response-identifierKuncinya belum ada dan juga harus ditambahkan sebelum konsumsi.

Fungsi Lambda mengubah peristiwa di atas dan memasukkannya ke bus acara khusus atau default target. Muatan yang diubah harus menyertakan pasangan kunci:value yang diperlukan.

Setelah transformasi:

{  
    "version": "0",  
    "id": "7f5e0fc1-e917-2b5d-a299-50f4735f1283",  
    "detail-type": "ams.monitoring/generic-apm",  
    "source": "GenericAPMEvent",  
    "account": "123456789012",  
    "time": "2023-10-25T14:42:25Z",  
    "region": "us-east-1",  
    "resources": [],  
    "detail": {  
        "incident-detection-response-identifier": "UnHealthyHostCount",  
        "alert_type": "error",  
        "event_type": "query_alert_monitor",  
        "meta": {  
            "monitor": {  
                "id": 222222,  
                "org_id": 3333333333,  
                "type": "query alert",  
                "name": "UnHealthyHostCount",  
                "message": "@awseventbridge-Datadog-aaa111bbbc",  
                "query": "max(last_5m):avg:aws.applicationelb.un_healthy_host_count{aws_account:123456789012} <= 1",  
                "created_at": 1686884769000,  
                "modified": 1698244915000,  
                "options": {  
                    "thresholds": {  
                        "critical": 1.0  
                    }  
                },  
            },  
            "result": {  
                "result_id": 7281010972796602670,  
                "result_ts": 1698244878,  
                "evaluation_ts": 1698244868,  
                "scheduled_ts": 1698244938,  
                "metadata": {  
                    "monitor_id": 222222,  
                    "metric": "aws.applicationelb.un_healthy_host_count"  
                }  
            },  
            "transition": {  
                "trans_name": "Triggered",  
                "trans_type": "alert"  
            },  
            "states": {  
                "source_state": "OK",  
                "dest_state": "Alert"  
            },  
            "duration": 0  
        },  
        "priority": "normal",  
        "source_type_name": "Monitor Alert",  
        "tags": [  
            "aws_account:123456789012",  
            "monitor"  
        ]  
    }  
}

Perhatikan bahwa detail-type sekarangams.monitoring/generic-apm, sumber sekarangGenericAPMEvent, dan di bawah detail ada pasangan key:value baru:. incident-detection-response-identifier

incident-detection-response-identifierNilai diambil dari nama peringatan berdasarkan muatan apa pun yang dikirim APM Anda. Jalur nama peringatan APM berbeda dari satu APM ke APM lainnya. Fungsi Lambda harus diatur untuk mengambil nama alarm dari jalur yang benar di payload APM JSON yang diterima oleh Lambda dan menggunakannya untuk nilainya. incident-detection-response-identifier

incident-detection-response-identifiernilai harus unik per jenis alarm yang dikirim ke AWS Incident Detection and Response. Setiap nama unik yang ditetapkan incident-detection-response-identifier harus diberikan kepada tim AWS Incident Detection and Response selama on-boarding. Peristiwa yang memiliki nilai incident-detection-response-identifier kunci yang tidak diketahui atau hilang tidak diproses.