CloudEvents Span 的语义约定
状态: 开发中
定义
CloudEvents 是一个用于描述常见格式事件数据的规范,旨在提供跨服务、平台和系统的互操作性。
有关 CloudEvents 的概念、术语和背景的更多信息,请参阅 CloudEvents入门指南 文档。
约定
CloudEvent 特定的仪器化应遵循 消息 Span 的语义约定 中描述的 Span 结构。
如果 CloudEvents 的仪器化独立于上述约定,仪器化可以依靠 CloudEvents 分布式跟踪扩展 来传播跟踪上下文。
Span 属性
此外,仪器化可以记录上述约定所创建 Span 上的以下 CloudEvent 特定属性。
Attributes
| 键 | Stability | 需求级别 | Value Type | 描述 | Example Values |
|---|---|---|---|---|---|
cloudevents.event_id | 必需 | 字符串 | 该 event_id 唯一标识了事件。 | 123e4567-e89b-12d3-a456-426614174000; 0001 | |
cloudevents.event_source | 必需 | 字符串 | 该 source 标识了事件发生的上下文。 | https://github.com/cloudevents; /cloudevents/spec/pull/123; my-service | |
cloudevents.event_spec_version | 推荐 | 字符串 | 事件使用的 CloudEvents 规范的版本。 | 1.0 | |
cloudevents.event_subject | 推荐 | 字符串 | 事件在事件生产者(由 source 标识)的上下文中的 subject。 | mynewfile.jpg | |
cloudevents.event_type | 推荐 | 字符串 | 该 event_type 包含一个描述与原始事件相关的事件类型的字符串。 | com.github.pull_request.opened; com.example.object.deleted.v2 |