Generate Attribute Registry using Weaver

[jsuereth]

This PR is ready for review. Upon enough acceptance, a weaver version will be cut with all necessary functionality so and this PR will be updated to only use this version.

How to Review

All content under attributes-registry is autogenerated files. For styling issues/concerns, you can comment directly on jinja templates under templates/registry/markdown.

For issues where attribute registry "groups" are not displaying, you can comment on templates/registry/markdown/weaver.yaml where the configuration for resolving attribute registry exists.

For issues on snippet generation (and moving from local to full in all snippets), comment directly on templates with problematic issues and we'll open bugs against Weaver to improve its out of the box support (Note: this will be moving to JINJA templates we would control in semconv repository eventually).

Ready-For-Merge TODOs

Blocking

• Move to stable release of weaver
• Get Jinja to render lint-compliant markdown OR just run markdown lint after JINJA (@jsuereth)
  • Run markdown "fix" after codegen everytime
  • For "check" we run generation -> markdown fix and then git diff
• Figure out how to fail "check" if registry is not up-to-date
• Better "notes" support for group files
• Markdown-appropriate "kebab-case" filter in weaver (@lquerel)
• Title-case filter in weaver (@lquerel)
• Figure out why peer.md is not generating
• Figure out how system.md was missing in current registry.
• Update file-names to use same - or _ as previously used.
• Fix rendering of template attributes to do {{name}}.<key> (@jsuereth)
• Remove extra space rendered when notes are empty.
• Add location for recording an exception and link to that in registry (@jsuereth)
• Figure out why attribute registry links are now gone from snippet generation elsewhere
• Update to weaver with k8s fragmentation fixes, so we don't get K 8 S titles.
• Weaver "enum descriptions" don't default to the enum value on none. ((fix) Fixes some subtle issues in weaver-semconv-gen weaver#118)
• update snippet generation to always use full
• Figure out bug in sampling-relevant attributes (HTTP trace semconv lacking real connection from client/server to general trace attributes. #928)
• Figure out bug where jvm.buffer.pool.name shows up as pool.name.
• Move .NET attributes to registry (Move .NET-specific attributes to the registry #943)
• [cleanup] Fix up documentation to remove "common" attributes section and instead list all attributes when showing a span. #959
• Move JVM metrics to attribute registry (Move JVM attribtues to registry. #979)

Nice to Have

• Limit # of example enums in weaver-snippet to 3-5 (weaver_semconv_gen should limit enum examples to 3-5 instances, not all of them. weaver#122)
• Filter for generation of TITLE + FILENAME for attribute registry namespace from attribute_group id ([feature] Add filters for dealing with semconv attribute registry weaver#113)
• weaver_semconv_gen: Fix typos/differences for event snippets weaver#126
• weaver_semconv_gen: Enum value description uses id in lieu of brief weaver#127
• Move deprecated attributes to the bottom of the registry markdown (Generate Attribute Registry using Weaver #917 (comment))

Changes

Update the entire docs/attributes-registry directory to be autogenreated from semantic convention YAML.

• Add new makefile target for generating the attribute registry
• Add jinja templates for rendering README / namespace markdown files as close as possible to oriiginal
• Add new makefile target for testing difference between weaver-generated snippets and existing snippets.
• Clean up some oddities in model YAML files when detected.
• Update "recording an exception" to link to stable opentelemetry.io page.
• Update markdown "fix" prettier usage to apply to the attribute registry.
• Update makefile check to see if attribute registry is out of date

Merge requirement checklist

• CONTRIBUTING.md guidelines followed.
• Change log entry added, according to the guidelines in When to add a changelog entry.
  • If your PR does not need a change log, start the PR title with [chore]
• schema-next.yaml updated with changes to existing conventions.

[nirga]

@jsuereth looks like unrelated changed in the gen-ai folder?

[jsuereth]

@jsuereth looks like unrelated changed in the gen-ai folder?

@nirga What are you seeing that's not related?

As part of this PR:

• All attribute registry links are now /docs/attributes-registry vs. relative paths.
• All enums are now open (decision made a while ago, snippet generation now accounts for it)
• All markdown snippets implicitly use "full" config.

[ChrsMark]

LGTM

[lquerel]

LGTM