# OpenTelemetryセマンティック規約

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


セマンティック規約は、テレメトリーデータを収集・生成・利用する際に意味を与える、共通の（セマンティックな）属性の集合を定義します。
セマンティック規約は、スパン名や種別、メトリクスの計測器や単位、属性名・型・意味・有効な値などについても規定します。
セマンティック規約が対象とする範囲の詳細な定義は、[セマンティック規約の安定性](../spec/versioning-and-stability/#semantic-conventions-stabilityセマンティック規約の安定性)を参照してください。
セマンティック規約に従う利点は、コードベースやライブラリ、プラットフォームをまたいで標準化できる共通の命名規則に従うことにあります。
これによって、データの関連付けや利用が容易になります。

セマンティック規約は、次の領域について定義されています。

* **[General](./general/): 汎用のセマンティック規約**。
* [CI/CD](/works/otel-specs-ja/semconv/cicd/): CI/CDシステムのセマンティック規約。
* [クラウドプロバイダー](/works/otel-specs-ja/semconv/cloud-providers/): クラウドプロバイダーのライブラリのセマンティック規約。
* [CloudEvents](/works/otel-specs-ja/semconv/cloudevents/): CloudEvents仕様のセマンティック規約。
* [Database](./db/): データベース操作のセマンティック規約。
* [Exceptions](/works/otel-specs-ja/semconv/exceptions/): 例外のセマンティック規約。
* [FaaS](/works/otel-specs-ja/semconv/faas/): Function as a Service（FaaS）操作のセマンティック規約。
* [Feature Flags](/works/otel-specs-ja/semconv/feature-flags/): フィーチャーフラグ評価のセマンティック規約。
* [Generative AI](https://github.com/open-telemetry/semantic-conventions-genai): [OpenTelemetry GenAI semantic conventionsリポジトリ](https://github.com/open-telemetry/semantic-conventions-genai)に移動しました。
* [GraphQL](/works/otel-specs-ja/semconv/graphql/): GraphQL実装のセマンティック規約。
* [HTTP](./http/): HTTPクライアントとサーバーの操作のセマンティック規約。
* [Messaging](/works/otel-specs-ja/semconv/messaging/): メッセージング操作とシステムのセマンティック規約。
* [Object Stores](/works/otel-specs-ja/semconv/object-stores/): オブジェクトストア操作のセマンティック規約。
* [RPC](/works/otel-specs-ja/semconv/rpc/): RPCクライアントとサーバーの操作のセマンティック規約。
* [System](/works/otel-specs-ja/semconv/system/): Systemのセマンティック規約。

シグナル別に定義されているセマンティック規約は、次のとおりです。

* [Events](/works/otel-specs-ja/semconv/general/events/): イベントデータのセマンティック規約。
* [Logs](/works/otel-specs-ja/semconv/general/logs/): ログデータのセマンティック規約。
* [Metrics](/works/otel-specs-ja/semconv/general/metrics/): メトリクスのセマンティック規約。
* [Profiles](/works/otel-specs-ja/semconv/general/profiles/): プロファイルのセマンティック規約。
* [Resource](./resource/): リソースのセマンティック規約。
* [Trace](/works/otel-specs-ja/semconv/general/trace/): トレースとスパンのセマンティック規約。

設定に関するセマンティック規約は、次のとおりです。

* [Configuration](./configuration/): セマンティック規約に関連する設定オプション。

関連情報は、次のとおりです。

* [セマンティック規約の書き方](./how-to-write-conventions/)
* [非規範的な補足情報](/works/otel-specs-ja/semconv/non-normative/)

- [.NETに関するセマンティック規約](/works/otel-specs-ja/semconv/dotnet/)
- [Azureリソースログに関するセマンティック規約](/works/otel-specs-ja/semconv/azure/)
- [CI/CDに関するセマンティック規約](/works/otel-specs-ja/semconv/cicd/)
- [CLIプログラムに関するセマンティック規約](/works/otel-specs-ja/semconv/cli/)
- [CloudEventsに関するセマンティック規約](/works/otel-specs-ja/semconv/cloudevents/)
- [Configuration](/works/otel-specs-ja/semconv/configuration/)
- [DNSに関するセマンティック規約](/works/otel-specs-ja/semconv/dns/)
- [FaaSに関するセマンティック規約](/works/otel-specs-ja/semconv/faas/)
- [General semantic conventions](/works/otel-specs-ja/semconv/general/)
- [Generative AIに関するセマンティック規約](/works/otel-specs-ja/semconv/gen-ai/)
- [GraphQLに関するセマンティック規約](/works/otel-specs-ja/semconv/graphql/)
- [HTTPに関するセマンティック規約](/works/otel-specs-ja/semconv/http/)
- [NFSに関するセマンティック規約](/works/otel-specs-ja/semconv/nfs/)
- [OpenTelemetry SDKに関するセマンティック規約](/works/otel-specs-ja/semconv/otel/)
- [Resourceのセマンティック規約](/works/otel-specs-ja/semconv/resource/)
- [RPCに関するセマンティック規約](/works/otel-specs-ja/semconv/rpc/)
- [Systemのセマンティック規約](/works/otel-specs-ja/semconv/system/)
- [URLに関するセマンティック規約](/works/otel-specs-ja/semconv/url/)
- [アプリに関するセマンティック規約](/works/otel-specs-ja/semconv/app/)
- [オブジェクトストアに関するセマンティック規約](/works/otel-specs-ja/semconv/object-stores/)
- [クラウドプロバイダーに関するセマンティック規約](/works/otel-specs-ja/semconv/cloud-providers/)
- [セマンティック規約の書き方](/works/otel-specs-ja/semconv/how-to-write-conventions/)
- [データベース呼び出しとシステムに関するセマンティック規約](/works/otel-specs-ja/semconv/db/)
- [ハードウェアに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/)
- [フィーチャーフラグに関するセマンティック規約](/works/otel-specs-ja/semconv/feature-flags/)
- [ブラウザに関するセマンティック規約](/works/otel-specs-ja/semconv/browser/)
- [メッセージングシステムに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/)
- [モバイルプラットフォームに関するセマンティック規約](/works/otel-specs-ja/semconv/mobile/)
- [ランタイム環境に関するセマンティック規約](/works/otel-specs-ja/semconv/runtime/)
- [例外に関するセマンティック規約](/works/otel-specs-ja/semconv/exceptions/)
- [非規範的な補足情報](/works/otel-specs-ja/semconv/non-normative/)
- [データベースクライアントのスパンに関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-spans/)
- [データベースクライアントのメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-metrics/)
- [データベース例外に関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-exceptions/)
- [Cassandraに関するセマンティック規約](/works/otel-specs-ja/semconv/db/cassandra/)
- [Azure Cosmos DBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/cosmosdb/)
- [CouchDBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/couchdb/)
- [AWS DynamoDBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/dynamodb/)
- [Elasticsearchクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/elasticsearch/)
- [HBaseクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/hbase/)
- [MariaDBクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mariadb/)
- [MongoDBクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mongodb/)
- [MySQLクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mysql/)
- [Oracle Databaseに関するセマンティック規約](/works/otel-specs-ja/semconv/db/oracledb/)
- [PostgreSQLに関するセマンティック規約](/works/otel-specs-ja/semconv/db/postgresql/)
- [Redisクライアントの操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/redis/)
- [SQLデータベースに関するセマンティック規約](/works/otel-specs-ja/semconv/db/sql/)
- [Microsoft SQL Serverに関するセマンティック規約](/works/otel-specs-ja/semconv/db/sql-server/)
- [.NET](/works/otel-specs-ja/semconv/runtime/dotnet-metrics/)
- [Agent spans](/works/otel-specs-ja/semconv/gen-ai/gen-ai-agent-spans/)
- [Android](/works/otel-specs-ja/semconv/resource/android/)
- [Anthropic](/works/otel-specs-ja/semconv/gen-ai/anthropic/)
- [App Events](/works/otel-specs-ja/semconv/app/app-events/)
- [ASP.NET Core](/works/otel-specs-ja/semconv/dotnet/dotnet-aspnetcore-metrics/)
- [AWS Bedrock](/works/otel-specs-ja/semconv/gen-ai/aws-bedrock/)
- [AWS ECS](/works/otel-specs-ja/semconv/resource/cloud-provider/aws/ecs/)
- [AWS EKS](/works/otel-specs-ja/semconv/resource/cloud-provider/aws/eks/)
- [AWS Lambda](/works/otel-specs-ja/semconv/faas/aws-lambda/)
- [AWS SDK](/works/otel-specs-ja/semconv/cloud-providers/aws-sdk/)
- [AWS SNS](/works/otel-specs-ja/semconv/messaging/sns/)
- [AWS SQS](/works/otel-specs-ja/semconv/messaging/sqs/)
- [AWSにおける互換性の考慮事項](/works/otel-specs-ja/semconv/non-normative/compatibility/aws/)
- [AWSログ](/works/otel-specs-ja/semconv/resource/cloud-provider/aws/logs/)
- [Azure AI Inference](/works/otel-specs-ja/semconv/gen-ai/azure-ai-inference/)
- [Azureメッセージングシステムに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/azure-messaging/)
- [Azureリソースログイベントに関するセマンティック規約](/works/otel-specs-ja/semconv/azure/azure-events/)
- [Browser](/works/otel-specs-ja/semconv/resource/browser/)
- [CI/CD](/works/otel-specs-ja/semconv/resource/cicd/)
- [Cloud](/works/otel-specs-ja/semconv/resource/cloud/)
- [CloudFoundry](/works/otel-specs-ja/semconv/resource/cloudfoundry/)
- [code属性の移行ガイド](/works/otel-specs-ja/semconv/non-normative/code-attrs-migration/)
- [Connect](/works/otel-specs-ja/semconv/rpc/connect-rpc/)
- [Container](/works/otel-specs-ja/semconv/resource/container/)
- [Container](/works/otel-specs-ja/semconv/system/container-metrics/)
- [CPUメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/cpu/)
- [CPython](/works/otel-specs-ja/semconv/runtime/cpython-metrics/)
- [Deployment](/works/otel-specs-ja/semconv/resource/deployment-environment/)
- [Device](/works/otel-specs-ja/semconv/resource/device/)
- [DNS](/works/otel-specs-ja/semconv/dotnet/dotnet-dns-metrics/)
- [Dubbo](/works/otel-specs-ja/semconv/rpc/dubbo/)
- [Events](/works/otel-specs-ja/semconv/gen-ai/gen-ai-events/)
- [Exceptions](/works/otel-specs-ja/semconv/gen-ai/gen-ai-exceptions/)
- [Exceptions](/works/otel-specs-ja/semconv/http/http-exceptions/)
- [Exceptions](/works/otel-specs-ja/semconv/messaging/messaging-exceptions/)
- [Exceptions](/works/otel-specs-ja/semconv/rpc/rpc-exceptions/)
- [Function as a Service](/works/otel-specs-ja/semconv/resource/faas/)
- [General attributes](/works/otel-specs-ja/semconv/general/attributes/)
- [Go](/works/otel-specs-ja/semconv/runtime/go-metrics/)
- [Google Cloud AppHub](/works/otel-specs-ja/semconv/resource/cloud-provider/gcp/apphub/)
- [Google Cloud Pub/Subに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/gcp-pubsub/)
- [Google Cloud Run](/works/otel-specs-ja/semconv/resource/cloud-provider/gcp/cloud-run/)
- [Google Compute Engine](/works/otel-specs-ja/semconv/resource/cloud-provider/gcp/gce/)
- [GPUメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/gpu/)
- [gRPC](/works/otel-specs-ja/semconv/rpc/grpc/)
- [gRPCにおける互換性の考慮事項](/works/otel-specs-ja/semconv/non-normative/compatibility/grpc/)
- [Heroku](/works/otel-specs-ja/semconv/resource/cloud-provider/heroku/)
- [Host](/works/otel-specs-ja/semconv/resource/host/)
- [HTTP](/works/otel-specs-ja/semconv/dotnet/dotnet-http-metrics/)
- [HTTPメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/http/http-metrics/)
- [HTTPリクエストと接続のスパン](/works/otel-specs-ja/semconv/dotnet/dotnet-network-traces/)
- [HTTP規約の移行ガイド](/works/otel-specs-ja/semconv/non-normative/http-migration/)
- [JSON-RPC](/works/otel-specs-ja/semconv/rpc/json-rpc/)
- [JVM](/works/otel-specs-ja/semconv/runtime/jvm-metrics/)
- [K8sセマンティック規約の安定化に伴う移行](/works/otel-specs-ja/semconv/non-normative/k8s-migration/)
- [Kafkaに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/kafka/)
- [Kestrel](/works/otel-specs-ja/semconv/dotnet/dotnet-kestrel-metrics/)
- [Kubernetes](/works/otel-specs-ja/semconv/system/k8s-metrics/)
- [Kubernetesアノテーションによるリソース属性の指定](/works/otel-specs-ja/semconv/non-normative/k8s-attributes/)
- [Kubernetesの命名例外](/works/otel-specs-ja/semconv/non-normative/naming-known-exceptions/)
- [LLM呼び出しの例](/works/otel-specs-ja/semconv/gen-ai/non-normative/examples-llm-calls/)
- [Metrics](/works/otel-specs-ja/semconv/gen-ai/gen-ai-metrics/)
- [Metrics](/works/otel-specs-ja/semconv/messaging/messaging-metrics/)
- [Metrics](/works/otel-specs-ja/semconv/rpc/rpc-metrics/)
- [Model Context Protocol](/works/otel-specs-ja/semconv/gen-ai/mcp/)
- [NFS](/works/otel-specs-ja/semconv/nfs/nfs-metrics/)
- [Node.js](/works/otel-specs-ja/semconv/runtime/nodejs-metrics/)
- [OpenAI](/works/otel-specs-ja/semconv/gen-ai/openai/)
- [Openshift](/works/otel-specs-ja/semconv/resource/k8s/openshift/)
- [OpenShift](/works/otel-specs-ja/semconv/system/openshift-metrics/)
- [OS process](/works/otel-specs-ja/semconv/system/process-metrics/)
- [Processおよびプロセスランタイムリソース](/works/otel-specs-ja/semconv/resource/process/)
- [RabbitMQに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/rabbitmq/)
- [RocketMQに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/rocketmq/)
- [RPC規約の移行ガイド](/works/otel-specs-ja/semconv/non-normative/rpc-migration/)
- [S3](/works/otel-specs-ja/semconv/object-stores/s3/)
- [SignalR](/works/otel-specs-ja/semconv/dotnet/dotnet-signalr-metrics/)
- [Spans](/works/otel-specs-ja/semconv/cli/cli-spans/)
- [Spans](/works/otel-specs-ja/semconv/gen-ai/gen-ai-spans/)
- [Spans](/works/otel-specs-ja/semconv/http/http-spans/)
- [Spans](/works/otel-specs-ja/semconv/rpc/rpc-spans/)
- [System](/works/otel-specs-ja/semconv/system/system-metrics/)
- [T-shaped Signals](/works/otel-specs-ja/semconv/how-to-write-conventions/t-shaped-signals/)
- [V8 JSエンジン](/works/otel-specs-ja/semconv/runtime/v8js-metrics/)
- [Webengine](/works/otel-specs-ja/semconv/resource/webengine/)
- [z/OSソフトウェア](/works/otel-specs-ja/semconv/resource/zos/)
- [イベント](/works/otel-specs-ja/semconv/feature-flags/feature-flags-events/)
- [イベント](/works/otel-specs-ja/semconv/mobile/mobile-events/)
- [イベントに関するセマンティック規約](/works/otel-specs-ja/semconv/general/events/)
- [エラーの記録](/works/otel-specs-ja/semconv/general/recording-errors/)
- [エンクロージャーメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/enclosure/)
- [オペレーティングシステム](/works/otel-specs-ja/semconv/resource/os/)
- [サービスに関するセマンティック規約](/works/otel-specs-ja/semconv/resource/service/)
- [シグナルとエンティティの要求レベル](/works/otel-specs-ja/semconv/general/signal-requirement-level/)
- [システムセマンティック規約の一般的な使用例](/works/otel-specs-ja/semconv/non-normative/groups/system/use-cases/)
- [システム計装の設計思想](/works/otel-specs-ja/semconv/non-normative/groups/system/design-philosophy/)
- [スパン](/works/otel-specs-ja/semconv/cicd/cicd-spans/)
- [スパン](/works/otel-specs-ja/semconv/cloudevents/cloudevents-spans/)
- [スパン](/works/otel-specs-ja/semconv/faas/faas-spans/)
- [スパン](/works/otel-specs-ja/semconv/graphql/graphql-spans/)
- [スパンにおける例外に関するセマンティック規約](/works/otel-specs-ja/semconv/exceptions/exceptions-spans/)
- [セッションに関するセマンティック規約](/works/otel-specs-ja/semconv/general/session/)
- [セマンティック規約グループ](/works/otel-specs-ja/semconv/general/semantic-convention-groups/)
- [セマンティック規約のバージョン選択](/works/otel-specs-ja/semconv/configuration/version-selection/)
- [セマンティック規約ライブラリのコード生成](/works/otel-specs-ja/semconv/non-normative/code-generation/)
- [データベース規約の移行ガイド](/works/otel-specs-ja/semconv/non-normative/db-migration/)
- [テープドライブメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/tape-drive/)
- [ディスクコントローラーメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/disk-controller/)
- [トレースに関するセマンティック規約](/works/otel-specs-ja/semconv/general/trace/)
- [トレースの互換性に関するセマンティック規約](/works/otel-specs-ja/semconv/general/trace-compatibility/)
- [ネットワークメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/network/)
- [バッテリーメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/battery/)
- [ファンメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/fan/)
- [ブラウザイベントに関するセマンティック規約](/works/otel-specs-ja/semconv/browser/browser-events/)
- [プロファイルの属性](/works/otel-specs-ja/semconv/general/profiles/)
- [メッセージングスパンに関するセマンティック規約](/works/otel-specs-ja/semconv/messaging/messaging-spans/)
- [メトリクス](/works/otel-specs-ja/semconv/cicd/cicd-metrics/)
- [メトリクス](/works/otel-specs-ja/semconv/dns/dns-metrics/)
- [メトリクス](/works/otel-specs-ja/semconv/faas/faas-metrics/)
- [メトリクス](/works/otel-specs-ja/semconv/otel/sdk-metrics/)
- [メトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/general/metrics/)
- [メトリクスの要求レベル](/works/otel-specs-ja/semconv/general/metric-requirement-level/)
- [メモリメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/memory/)
- [リソースとEntity](/works/otel-specs-ja/semconv/how-to-write-conventions/resource-and-entities/)
- [ログ](/works/otel-specs-ja/semconv/cicd/cicd-logs/)
- [ログにおける例外に関するセマンティック規約](/works/otel-specs-ja/semconv/exceptions/exceptions-logs/)
- [ログの汎用属性](/works/otel-specs-ja/semconv/general/logs/)
- [例外](/works/otel-specs-ja/semconv/faas/faas-exceptions/)
- [共通ハードウェアメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/common/)
- [命名](/works/otel-specs-ja/semconv/general/naming/)
- [属性の要求レベル](/works/otel-specs-ja/semconv/general/attribute-requirement-level/)
- [推奨とOpt-InのCPUメトリクス](/works/otel-specs-ja/semconv/non-normative/groups/system/cpu-metrics-guidelines/)
- [温度メトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/temperature/)
- [物理ディスクメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/physical-disk/)
- [物理ホストメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/host/)
- [状態メトリクス](/works/otel-specs-ja/semconv/how-to-write-conventions/status-metrics/)
- [論理ディスクメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/logical-disk/)
- [電圧メトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/voltage/)
- [電源ユニットメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/hardware/power-supply/)