腾讯云 CLS 集成指引

title: "腾讯云日志服务CLS集成"
description: "通过 webhook 的方式同步腾讯云日志服务 CLS 监控告警事件到快猫星云，实现告警事件自动化降噪处理"
date: "2024-05-11T10:00:00+08:00"
url: "https://docs.flashcat.cloud/zh/flashduty/tencent-cls-integration-guide"

通过 webhook 的方式同步腾讯云日志服务 CLS 监控告警事件到 Flashduty，实现告警事件自动化降噪处理。

在 Flashduty

您可通过以下2种方式，获取一个集成推送地址，任选其一即可。

使用专属集成

当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。

展开

进入 Flashduty 控制台，选择 协作空间，进入某个空间的详情页面
选择 集成数据 tab，点击 添加一个集成，进入添加集成页面
选择 腾讯云CLS 集成，点击保存，生成卡片。
点击生成的卡片，可以查看到 推送地址，复制备用，完成。

使用共享集成

当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。

展开

进入 Flashduty 控制台，选择 集成中心=>告警事件，进入集成选择页面。
选择 腾讯云CLS 集成：
- 集成名称：为当前集成定义一个名称。
点击保存后，复制当前页面的新生成的 推送地址 备用。
点击 创建路由，为集成配置路由规则。您可以按条件匹配不同的告警到不同的协作空间，也可以直接设置默认协作空间作为兜底，后续再按需调整。
完成。

在腾讯云的 CLS

步骤 1：配置通知渠道组

登录您的腾讯云控制台，选择日志服务 CLS 产品，进入监控告警 - 通知渠道组
单击 新建 开始新建

如图，名称 填写具体的渠道组名称，渠道类型选择“自定义接口回调”，回调地址 填写集成的推送地址，请求方法 选择POST
点击 确定 保存， 添加 可以添加多个渠道

步骤 2：配置告警策略

登录您的腾讯云控制台，选择日志服务 CLS 产品，进入监控告警 - 告警策略
单击 新建 开始新建

如图，告警名称填写具体的告警名称，日志主题选择具体的日志主题
执行语句 填写具体的查询语句，查询时间范围选择时间范围，点击预览可以查看执行的结果，触发条件输入具体的触发条件
告警级别，分为紧急、告警和提醒，根据告警的严重程序选择，执行周期根据需要选择
多维分析，触发告警时可针对原始日志进行额外的检索分析，将结果附加在告警通知中，以辅助定位告警原因。多维分析不会影响告警触发条件。
告警通知，通知渠道组，可以关联到具体的渠道组

步骤 3：配置自定义回调

关联渠道组后，可以看到回调内容配置
请求头，可以添加具体的请求的headers
请求内容，返回具体的请求数据格式，参考：

{
    "uin": "{{escape .UIN}}",
    "nickname": "{{escape .Nickname}}",
    "region": "{{escape .Region}}",
    "alarm": "{{escape .Alarm}}",
    "alarm_id": "{{escape .AlarmID}}",
    "condition": "{{escape .Condition}}",
    "happen_threshold": "{{escape .HappenThreshold}}",
    "alert_threshold": "{{escape .AlertThreshold}}",
    "topic": "{{escape .Topic}}",
    "topic_id": "{{escape .TopicId}}",
    "level": "{{escape .Level}}",
    "label": {{.Label}},
    "start_time": "{{escape .StartTime}}",
    "start_time_unix": "{{escape .StartTimeUnix}}",
    "notify_time": "{{escape .NotifyTime}}",
    "notify_time_unix": "{{escape .NotifyTimeUnix}}",
    "notify_type": "{{escape .NotifyType}}",
    "consecutive_alert_nums": "{{escape .ConsecutiveAlertNums}}",
    "duration": "{{escape .Duration}}",
    "trigger_params": "{{escape .TriggerParams}}",
    "record_group_id": "{{escape .RecordGroupId}}",
    "detail_url": "{{escape .DetailUrl}}",
    "query_url": "{{escape .QueryUrl}}",
    "message": {{.Message}},
    "query_result": {{.QueryResult}},
    "query_log": {{.QueryLog}},
    "analysis_result": {{.AnalysisResult}}
}

状态对照

腾讯云CLS监控告警级别到 Flashduty 映射关系：

腾讯云 CLS 监控	Flashduty	状态
Info	Info	提醒
Warn	Warning	警告
Critical	Critical	紧急

修改于 5 个月前