basic-example

July 3, 2026 · View on GitHub

REST API 示例，演示 OTel GenAI Semantic Conventions v1.41.1 中全部 well-known gen_ai.operation.name。

运行

# 编辑 src/main/resources/application.yml — 替换 <your-dashscope-api-key> 及 CMS 占位符

cd examples/basic-example
mvn spring-boot:run

端点

端点operation.name
POST /api/chatchat
POST /api/embeddingembeddings
POST /api/toolexecute_tool
POST /api/agentinvoke_agent
POST /api/workflowinvoke_workflow
POST /api/retrievalretrieval
POST /api/create-agentcreate_agent

示例

curl -X POST http://localhost:8080/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello"}'

配置见 src/main/resources/application.yml。

otel-util-genai 必填配置

配置项说明环境变量
otel.semconv.stability.opt.in启用 GenAI 实验语义OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental
otel.instrumentation.genai.capture.message.content消息内容采集模式OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span_and_event
otel.instrumentation.genai.emit.event推荐 true，写入 OTel Log EventOTEL_INSTRUMENTATION_GENAI_EMIT_EVENT=true

接入阿里云 CMS/ARMS GenAI 视图

导出 OTLP 到 CMS 时，OTEL_RESOURCE_ATTRIBUTES 须包含：

gen_ai.instrumentation.sdk.name=loongsuite-genai-utils
acs.arms.service.feature=genai_app
acs.cms.workspace=<your-workspace-id>

详见 application.yml 中的注释。