Skip to content

[PR 1/5] docs: add UModel-OpenTelemetry semantic convention mapping (discussion draft)#14

Open
Alyyyyyy wants to merge 1 commit into
alibaba:mainfrom
Alyyyyyy:pr/otel-mapping-draft
Open

[PR 1/5] docs: add UModel-OpenTelemetry semantic convention mapping (discussion draft)#14
Alyyyyyy wants to merge 1 commit into
alibaba:mainfrom
Alyyyyyy:pr/otel-mapping-draft

Conversation

@Alyyyyyy
Copy link
Copy Markdown

@Alyyyyyy Alyyyyyy commented Jun 2, 2026

Summary

This PR implements step 1 of the RFC sequence proposed in #7: the OTel mapping document at docs/en/otel-mapping.md.

What this document is

A lightweight conceptual bridge between UModel's data model and OpenTelemetry's semantic conventions. It maps:

UModel OpenTelemetry
EntitySet Instrumentation Scope
Entity (domain, type, id) Resource Attributes
Relation (topo edge) Span Link / Service Map Edge
Field constraints Semantic Convention attributes

What this document is NOT

  • ❌ A schema design — no YAML, no worked examples
  • ❌ A specification — marked as Community Discussion Draft throughout
  • ❌ Prescriptive — every section invites feedback and correction

Context

This is a discussion draft prepared by CAICT (China Academy of Information and Communications Technology) as a strawman proposal. An extended version with worked examples is available for workshop discussions.

RFC Sequence (from #7)

# PR Status
1 OTel mapping doc this PR
2 Default GraphStore change @qiansheng91
3 SDK codegen --exclude-contrib flag pending
4 Schema directory restructure pending
5 Documentation updates pending

Feedback welcome on all sections.

…n draft)

Add otel-mapping.md as proposed in Issue alibaba#7, PR 1 of the RFC sequence.
This is a community discussion draft prepared by CAICT, mapping UModel
concepts (EntitySet, Entity, Relation, Field constraints) to OpenTelemetry
equivalents (Instrumentation Scope, Resource Attributes, Span Link, Semantic
Conventions).

The document is intentionally lightweight — a concept bridge, not a schema
design. An extended version with worked examples is available for workshop
discussions.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Jun 2, 2026

CLA assistant check
All committers have signed the CLA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants