opentelemetry-semantic-conventions

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Use this skill when you need released semantic convention guidance for naming, attributes, or compliance checks.

If the broader task is manual instrumentation design or review, pair this with

opentelemetry-manual-instrumentation

当您需要已发布的命名、属性或合规性检查相关语义规范指导时，可使用本Skill。

如果更广泛的任务是手动工具设计或评审，请将其与

opentelemetry-manual-instrumentation

配合使用。

do not load the full semantic convention spec into context
use the bundled lookup script to query only the needed released group or attribute

identify the boundary type such as
```
http
```
,
```
db
```
,
```
messaging
```
,
```
rpc
```
,
```
network
```
,
```
gen-ai
```
, or
```
mcp
```
pick one primary group first, then add related groups only when they add needed context
see
```
references/semconv-selection.md
```

list groups:

./scripts/query-otel-semantic-conventions.sh --groups

inspect one group:

./scripts/query-otel-semantic-conventions.sh http

inspect one kind:

./scripts/query-otel-semantic-conventions.sh http spans

inspect one exact attribute or entry:

./scripts/query-otel-semantic-conventions.sh http http.request.method

use required and recommended attributes before optional ones
derive semconv-governed span names directly from the released naming rule
do not prepend or append protocol labels, hostnames, product names, business hints, or other custom prose to semconv-governed span names
if the released naming rule does not provide a low-cardinality target, use the simpler fallback allowed by that convention
if no released key exists, use a stable custom namespace and keep values bounded

include the group name, released version, and source URL from the script output
call out any concrete compatibility limitation if the implementation cannot fully match the released guidance

列出所有组：

./scripts/query-otel-semantic-conventions.sh --groups

查看单个组：

./scripts/query-otel-semantic-conventions.sh http

查看单个类型：

./scripts/query-otel-semantic-conventions.sh http spans

查看单个具体属性或条目：

./scripts/query-otel-semantic-conventions.sh http http.request.method