> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/cloudevents/cloudevents-spans/


# CloudEventsスパンに関するセマンティック規約

**ステータス**: [Development][DocumentStatus]

## 定義

[CloudEvents仕様](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#overview)より。

> CloudEventsは、サービス、プラットフォーム、システムをまたいだ相互運用性を提供するために、共通の形式でイベントデータを記述するための仕様です。

CloudEventsの概念、用語、背景に関するより詳しい情報は、[CloudEvents Primer](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/primer.md)文書を参照してください。

## 規約

CloudEvents固有の計装は、[メッセージングスパンに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/messaging-spans/)で説明されているスパン構造に従うべきです（SHOULD）。

上記の規約とは独立してCloudEventsを計装する場合、計装はトレースコンテキストを伝搬する手段として[CloudEvents Distributed Tracing Extension](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/extensions/distributed-tracing.md)に依拠できます。

## スパン属性

さらに、計装は、上記の規約から作成されたスパンに、次のCloudEvents固有の属性を記録してもかまいません。

<!-- semconv cloudevents -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`cloudevents.event_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloudevents/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id)は、イベントを一意に識別します。 | `123e4567-e89b-12d3-a456-426614174000`; `0001` |
| [`cloudevents.event_source`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloudevents/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1)は、イベントが発生したコンテキストを識別します。 | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` |
| [`cloudevents.event_spec_version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloudevents/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | イベントが使用する[CloudEvents仕様のバージョン](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion)。 | `1.0` |
| [`cloudevents.event_subject`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloudevents/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | イベントプロデューサー（sourceによって識別される）のコンテキストにおける、イベントの[subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject)。 | `mynewfile.jpg` |
| [`cloudevents.event_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloudevents/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type)には、発生元の出来事に関連するイベントの種類を記述する値が含まれます。 | `com.github.pull_request.opened`; `com.example.object.deleted.v2` |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status