tencent cloud

文档反馈

链路追踪

最后更新时间:2024-11-01 20:44:50

    使用场景

    通过事件集提供的链路追踪能力,用户可以查看每条投递到 EventBridge 的事件详情,并查看事件在 EventBridge 中的完整处理链路,方便对于每条事件进行跟踪与管理。

    前提条件

    链路追踪会将您的事件处理日志上报至 CLS 的指定日志集,并将日志内容集成在事件总线控制台,方便您做检索与查看,为保证功能正常使用,请确认您已开启 CLS 服务并且创建了相关服务角色,详情见 权限说明

    功能介绍

    产品维度

    事件集维度,用户可以在事件集上,完成相关链路追踪功能配置绑定。

    上报类型

    默认投递

    上报到 EB 默认日志集,日志集自动配置默认索引。
    日志集默认配置 3 天存储。
    上报基础事件日志信息,包含云服务告警事件的全部事件日志,以及自定义事件经过规则匹配成功后,投递到目标的投递失败日志。

    自定义投递

    投递到自定义的日志集,请注意开启全文索引
    可以按照实际业务需求,选择合适的投递方案,支持投递方案如下:
    事件经过规则匹配成功后,上报投递到目标的全部日志(包含成功日志 & 失败日志)。
    事件经过规则匹配成功后,只上报投递到目标的投递失败日志。
    事件经过规则匹配成功后,只上报投递到目标的投递成功日志。
    事件经过规则匹配成功后,上报投递到目标的全部日志(包含成功日志 & 失败日志)& 事件规则匹配失败日志。
    事件经过规则匹配成功后,只上报投递到目标的投递失败日志 & 事件规则匹配失败日志。
    事件经过规则匹配成功后,只上报投递到目标的投递成功日志 & 事件规则匹配失败日志。

    补充说明

    对于单一事件 ID,如果规则匹配失败且开启了相关投递,规则维度直接上报。
    对于单一事件 ID,如果规则匹配成功,会在目标维度上报投递结果(成功/失败)。
    如果上报 CLS 失败(平台错误/超限错误等),该条日志将被丢弃。

    操作步骤

    创建流程

    1. 登录 事件总线控制台,选择左侧导航栏中的事件集
    2. 选择新建事件集,在新建事件集的同时,完成上报方式的配置。您可以根据实际情况,选择默认投递自定义投递或者暂不开启
    3. 完成创建后,根据实际需要绑定事件源连接器。选择事件集详情页中的管理事件规则,进入事件规则页面。如下图所示:
    
    
    4. 单击新建事件规则,根据页面提示和实际需求,填写相关信息,完成规则和目标的绑定,如下图所示:
    
    
    5. 单击确定即可完成创建,创建完成后,发送事件,即可在事件集详情的事件查询页面查看相关日志。

    日志检索

    在事件查询页面,您可以用多种方式进行日志的筛选检索,具体说明如下:

    云服务事件集

    1. 登录 事件总线控制台,选择左侧导航栏中的事件集
    2. 选择事件集名称,进入事件集事件查询页。 您可以通过选择上方对应字段,完成日志的筛选。
    字段
    说明
    时间范围
    默认展示 15 分钟内事件日志,最多可选择 3 天,需要更多日志,请在 CLS 控制台进行筛选。
    事件筛选
    对于云服务事件集,支持筛选全部事件或只展示云服务告警事件。
    事件源&事件类型
    可以选择已有云服务事件源,或自定义填写,如果选择自定义,需要填写完整 type 字段(示例:cvm:ErrorEvent:GuestOom)。
    事件规则
    当一个事件集绑定多条规则时,您可以根据指定规则进行筛选,查看对应规则的事件投递日志。
    事件 ID
    通过事件 ID,查询唯一指定事件的轨迹和事件详情。

    自定义事件集

    1. 登录 事件总线控制台,选择左侧导航栏中的事件集
    2. 选择事件集名称,进入事件集事件查询页。 您可以通过选择上方对应字段,完成日志的筛选。
    字段
    说明
    时间范围
    默认展示 15 分钟内事件日志,最多可选择 3 天,需要更多日志,请在 CLS 控制台进行筛选。
    事件类型
    对于自定义事件集,需要填写完整 type 字段(示例:cvm:ErrorEvent:GuestOom)。
    事件规则
    当一个事件集绑定多条规则时,您可以根据指定规则进行筛选,查看对应规则的事件投递日志。
    事件 ID
    通过事件 ID,查询唯一指定事件的轨迹和事件详情。

    事件详情

    1. 登录 事件总线控制台,选择左侧导航栏中的事件集
    2. 选择事件集名称,进入事件集事件查询页。单击事件列表中的查看详情,即可看到该事件的完整内容、投递结果、耗时等详细信息。
    耗时计算方式为目标投递时间-进入事件集时间,如果投递失败产生重试,耗时中会加上重试间隔。
    对于同一事件在统一规则下的追踪记录,最多展示10条结果(前5条+最后5条)。

    计费说明

    链路追踪能力本身不计费,但因为将日志上报到了 CLS 服务,CLS 日志服务本身为独立计费产品,可能产生一定费用,具体计费方式参考 日志服务计费概述
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持