[BUG]: Missing docs for naming schema

[katiehockman]

Tracer Version(s)

1.72.1

Bug Report

There are a few environment variables related to the naming schema versioning, but there are no public docs which discuss how to configure it. It makes the user experience for these a bit confusing.

These env vars don't have public docs in https://docs.datadoghq.com/tracing/trace_collection/library_config/go:

• DD_TRACE_SPAN_ATTRIBUTE_SCHEMA
• DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED (this one is partially explained here, but there's no reference I can find that describes the env var otherwise)

And hi team, thanks for the good work ❤

[darccio]

Hi @katiehockman! We'll check with the guild and fix the docs 😄

It's nice to see an open issue by a familiar face!

[rarguelloF]

Hello Katie! I hope everything is going well :)

About those 2 environment variables:

• DD_TRACE_SPAN_ATTRIBUTE_SCHEMA is intentionally undocumented because the effort behind it was discontinued. We will mark it as deprecated in the code to clarify its status for existing users. While the option will remain available in the immediate future, we do not recommend using it and could disappear in a future major release.
• DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED is documented in the context where it is recommended to be used (Inferred services).

Regardless of this, as @darccio mentioned, we will review the documentation and make sure it is up to date. Thanks for reporting this!