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 more details about "service" to the Resource page #3763

Open
svrnm opened this issue Jan 11, 2024 · 1 comment
Open

Add more details about "service" to the Resource page #3763

svrnm opened this issue Jan 11, 2024 · 1 comment
Labels
docs help wanted Extra attention is needed

Comments

@svrnm
Copy link
Member

svrnm commented Jan 11, 2024

With service.name having a clear description now (open-telemetry/semantic-conventions#630) and service.type coming (open-telemetry/semantic-conventions#575), we should expand on this important topic on our concept pages (https://opentelemetry.io/docs/concepts/resources/#semantic-attributes-with-sdk-provided-default-value)

@svrnm svrnm added the docs label Jan 11, 2024
@cartermp
Copy link
Contributor

I'm thinking we're also due for another rewording of this to clarify what resources are exactly. One thing I've noted seems to work well with people is framing it up explicitly like this:

Spans, Logs, Metrics, and their attributes tell you what is happening.
Resources tell you where it is happening.

There's...a little bit of nuance lost there, like how a span also kinda tells you the "where", and how a resource isn't just about concrete things, but can represent a virtual entity like a service. But it's a framing that I've seen work well.

@svrnm svrnm added the help wanted Extra attention is needed label Apr 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs help wanted Extra attention is needed
Projects
None yet
Development

No branches or pull requests

2 participants