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

Define generic error.message #1992

Open
wants to merge 8 commits into
base: main
Choose a base branch
from

Conversation

dyladan
Copy link
Member

@dyladan dyladan commented Mar 12, 2025

Context: #1990 (comment)

This defines a generic error.message attribute for human-readable error messages to provide additional context and details about an error which occurred. It is meant to be used in conjunction with error.type which is low-cardinality.

@github-actions github-actions bot added the enhancement New feature or request label Mar 12, 2025
@trask
Copy link
Member

trask commented Mar 12, 2025

I'm supportive of this. I've added it to both the general semconv meeting and log SIG meeting agendas just in case we don't get feedback here on the PR.

@dyladan
Copy link
Member Author

dyladan commented Mar 12, 2025

Created #1994 for the feature flag implementation of this just to keep things separate

dyladan and others added 4 commits March 12, 2025 19:57

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
Co-authored-by: Trask Stalnaker <trask.stalnaker@gmail.com>
stability: development
examples: ["Unexpected input type: string", "The user has exceeded their storage quota"]
brief: A message providing more detail about an error in human-readable form.
note: |
Copy link
Contributor

Choose a reason for hiding this comment

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

We should probably also recommend NOT using this in metrics due to cardinality.

Copy link
Member

Choose a reason for hiding this comment

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

does the text below cover your concern?

error.message is recommended for events but not metrics or spans due to its unbounded cardinality and overlap with span status.

It is NOT RECOMMENDED to duplicate the value of `error.type` in `error.message`.
It is also NOT RECOMMENDED to duplicate the value of `exception.message` in `error.message`.

`error.message` is recommended for events but not metrics or spans due to its unbounded cardinality and overlap with span status.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
`error.message` is recommended for events but not metrics or spans due to its unbounded cardinality and overlap with span status.
`error.message` is NOT RECOMMENDED for metrics or spans due to its unbounded cardinality and overlap with span status.

component: error

# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
note: Add `error.message` property for human-readable error message.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
note: Add `error.message` property for human-readable error message.
note: Add `error.message` property for human-readable error message on events.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
Status: Ready to be Merged
Development

Successfully merging this pull request may close these issues.

None yet

7 participants