Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add explanation of double colons to Collector config page #4524

Merged
merged 3 commits into from
May 23, 2024

Conversation

tiffany76
Copy link
Contributor

@tiffany76 tiffany76 commented May 22, 2024

Fixes #4484.

This PR adds an explanation for the use of double colons to refer to nested keys in YAML config paths.


Preview: https://deploy-preview-4524--opentelemetry.netlify.app/docs/collector/configuration/#location

@tiffany76 tiffany76 requested review from a team and jpkrohling and removed request for a team May 22, 2024 20:59
Comment on lines +43 to +46
When referring to nested keys in YAML paths, make sure to use double colons (::)
to avoid confusion with namespaces that contain dots. For example:
`receivers::docker_stats::metrics::container.cpu.utilization::enabled: false`.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want this as advice to the user or as an explanation of what we are doing? (Genuine question)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the "tip" approach but I would also be OK with making it more of an explanation. I have no strong preference to be honest.

Copy link
Member

@mx-psi mx-psi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This phrasing looks good to me, I think it's fine to leave as a tip

@svrnm svrnm merged commit 2001473 into open-telemetry:main May 23, 2024
15 checks passed
@tiffany76 tiffany76 deleted the yaml-paths branch May 23, 2024 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Clarify use of double colon (::) notation in Collector config YAML paths
3 participants