# 攻击告警与报告

> 攻击开始的瞬间即通过 Telegram、邮件或自定义 Webhook 收到通知，并可下载取证数据。

Source: https://docs.avenlith.com/zh/attack-alerts  
Category: DDoS 防护  
Last updated: 2026-09-22

## 通知渠道

告警可发送至邮件、Telegram、Slack、Microsoft Teams、PagerDuty 或任意 HTTPS Webhook。

```bash
avenlith shield alert create --channel telegram --chat-id 123456789
avenlith shield alert create --channel webhook --url https://ops.example.com/hooks/shield
avenlith shield attacks list --since 7d --output table
```

## Webhook 内容

```json
{
  "event": "attack.started",
  "attack_id": "atk_9Qx2",
  "target": "203.0.113.24",
  "vector": "udp_amplification",
  "peak_bps": 412000000000,
  "peak_pps": 38200000,
  "mitigation": "scrubbing",
  "started_at": "2026-09-18T21:04:11Z"
}
```

事件类型：`attack.started`、`attack.updated`（每 60 秒）、`attack.ended`。请求通过 `X-Avenlith-Signature` 头（HMAC-SHA256）签名。

## 报告

每次攻击结束后都会生成报告，包含攻击向量、峰值带宽与包速率、主要来源网络，以及 10 秒的抓包（PCAP）样本。

> **Note:** > 报告保留 13 个月，可导出为 PDF 提供给保险公司或执法机关。