> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/cloud-providers/aws-sdk/


# AWS SDKクライアントスパンに関するセマンティック規約

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

## コンテキストの伝搬

[互換性](https://opentelemetry.io/docs/specs/semconv/non-normative/compatibility/aws/#context-propagation)を参照してください。

## AWS SDKスパン

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

**Status:** ![Development](https://img.shields.io/badge/-development-blue)

このスパンは、AWS SDKクライアント呼び出しを記述します。

**スパン名**は、AWS HTTP APIに従い、`Service.Operation`という形式でなければなりません（MUST）。例: `DynamoDB.GetItem`、`S3.ListBuckets`。これは、`rpc.service`と`rpc.method`を`.`で連結したものと等価であり、RPCクライアントスパンの命名ガイドラインと一致します。

AWS SDKスパン属性は、AWS SDK APIコールにおけるリクエストまたはレスポンスのパラメータに基づいています。これらの規約は、トレーシングを利用するAWSユーザーからのフィードバックに基づいて時間をかけて集められたものであり、新たに興味深い規約が見つかれば今後も増え続けます。

**スパン種別**は`CLIENT`であるべきです（SHOULD）。

**スパンステータス**は[エラーの記録](/works/otel-specs-ja/semconv/general/recording-errors/)文書に従うべきです（SHOULD）。

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`rpc.system`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/rpc/) | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>`rpc.system.name`に置き換えられました。 | `Required` | string | `aws-api`という値。 | `aws-api` |
| [`aws.extended_request_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/aws/) | ![Development](https://img.shields.io/badge/-development-blue) | `Conditionally Required` If available. | string | レスポンスヘッダー`x-amz-id-2`で返されるAWS拡張リクエストID。 | `wzHcyEWfmOGDIE5QOhTAqFDoDWP3y8IUvpNINCwL9N4TEHbUw0/gZJ+VZTmCNCWR7fezEN3eCiQ=` |
| [`aws.request_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/aws/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | レスポンスヘッダー`x-amzn-requestid`、`x-amzn-request-id`、`x-amz-request-id`のいずれかで返されるAWSリクエストID。 | `79b9da39-b7ae-508a-a6bc-864b2829c622`; `C9ER4AJX75574TDJ` |
| [`cloud.region`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 要求されたサービスへのアクセス先となるAWSリージョン。[1] | `us-east-1`; `us-west-2` |
| [`rpc.method`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/rpc/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | AWS SDKによって返される、リクエストに対応する操作の名前。 | `GetItem`; `PutItem` |
| [`rpc.service`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/rpc/) | ![Deprecated](https://img.shields.io/badge/-deprecated-red)<br>完全修飾名であることが期待される`rpc.method`に含めるべき値です。 | `Recommended` | string | AWS SDKによって返される、リクエスト先のサービス名。 | `DynamoDB`; `S3` |

**[1] `cloud.region`:** 特定のAWSサービス呼び出しに対してSDKクライアントが対象とするAWSリージョンを指定します。この属性の値は、[AWSのドキュメント](https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html#available-regions)に記載されているAWSリージョンコードに従うべきです（should）。

---

`rpc.system`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `apache_dubbo` | Apache Dubbo | ![Development](https://img.shields.io/badge/-development-blue) |
| `connect_rpc` | Connect RPC | ![Development](https://img.shields.io/badge/-development-blue) |
| `dotnet_wcf` | .NET WCF | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | gRPC | ![Development](https://img.shields.io/badge/-development-blue) |
| `java_rmi` | Java RMI | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | JSON-RPC | ![Development](https://img.shields.io/badge/-development-blue) |
| `onc_rpc` | [ONC RPC (Sun RPC)](https://datatracker.ietf.org/doc/html/rfc5531) | ![Development](https://img.shields.io/badge/-development-blue) |

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

## AWSサービス固有の属性

次のセマンティック規約は、特定のAWSサービスに対応して、一般的なAWS SDK属性を拡張します。

- [AWS DynamoDB](/works/otel-specs-ja/semconv/db/dynamodb/): *AWS DynamoDB*に関するセマンティック規約。
- [AWS S3](/works/otel-specs-ja/semconv/object-stores/s3/): *AWS S3*に関するセマンティック規約。
- AWS Bedrock: *AWS Bedrock*に関するセマンティック規約は、[OpenTelemetry GenAIセマンティック規約リポジトリ](https://github.com/open-telemetry/semantic-conventions-genai)に移動しました。
- [AWS SNS](/works/otel-specs-ja/semconv/messaging/sns/): *AWS SNS*に関するセマンティック規約。
- [AWS SQS](/works/otel-specs-ja/semconv/messaging/sqs/): *AWS SQS*に関するセマンティック規約。

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