CloudEvents Span 的语义约定

状态: 开发中

定义

来自 CloudEvents 规范

CloudEvents 是一个用于描述常见格式事件数据的规范,旨在提供跨服务、平台和系统的互操作性。

有关 CloudEvents 的概念、术语和背景的更多信息,请参阅 CloudEvents入门指南 文档。

约定

CloudEvent 特定的仪器化应遵循 消息 Span 的语义约定 中描述的 Span 结构。

如果 CloudEvents 的仪器化独立于上述约定,仪器化可以依靠 CloudEvents 分布式跟踪扩展 来传播跟踪上下文。

Span 属性

此外,仪器化可以记录上述约定所创建 Span 上的以下 CloudEvent 特定属性。

Attributes

Stability需求级别Value Type描述Example Values
cloudevents.event_idDevelopment必需字符串event_id 唯一标识了事件。123e4567-e89b-12d3-a456-426614174000; 0001
cloudevents.event_sourceDevelopment必需字符串source 标识了事件发生的上下文。https://github.com/cloudevents; /cloudevents/spec/pull/123; my-service
cloudevents.event_spec_versionDevelopment推荐字符串事件使用的 CloudEvents 规范的版本1.0
cloudevents.event_subjectDevelopment推荐字符串事件在事件生产者(由 source 标识)的上下文中的 subjectmynewfile.jpg
cloudevents.event_typeDevelopment推荐字符串event_type 包含一个描述与原始事件相关的事件类型的字符串。com.github.pull_request.opened; com.example.object.deleted.v2