-
Notifications
You must be signed in to change notification settings - Fork 183
docs: clarify tag search behavior in Jaeger UI (fixes jaegertracing/jaeger#7333) #952
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
base: main
Are you sure you want to change the base?
docs: clarify tag search behavior in Jaeger UI (fixes jaegertracing/jaeger#7333) #952
Conversation
chethanac15
commented
Jul 19, 2025
…aeger#7333) Signed-off-by: Chethan A C <[email protected]>
✅ Deploy Preview for romantic-neumann-1959d7 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
yurishkuro
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
changes should be made in _dev folders, not concrete versions, so that those changes are sticky for future versions.
and this behavior is probably the same for both v1 and v2, it would make sense to update the v2 docs (v1 is being retired end of this year)
|
|
||
| ## Tag Search Behavior | ||
|
|
||
| Jaeger UI indexes and allows searching for tags/attributes only if their values are strings. If a tag is set as an array (e.g., `["value"]`), it will not be searchable in the UI. This is important for users who want to search for specific tags, such as request IDs, in the Jaeger UI. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am not sure this is accurate. If the array tag can be retrieved from db then it was indexed as well, but most likely as a JSON string.
…ify array tag indexing) Signed-off-by: Chethan A C <[email protected]>
|
|
||
| ## Tag Search Behavior | ||
|
|
||
| Jaeger UI indexes and allows searching for tags (attributes) whose values are strings. If a tag is set as an array (for example, `["value"]`), it may be indexed as a JSON string (e.g., `'["value"]'`). In such cases, you would need to search for the exact JSON string representation in the UI. This can be confusing, as searching for just `value` will not match an array-valued tag; you must search for the full JSON string (e.g., `'["value"]'`). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
it may be indexed as a JSON string (e.g.,
'["value"]'
are you just restating what I said or did you validate it? Can you search by a string like that?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it's a bug. I don't want to make changes to documentation before we fix the bug. jaegertracing/jaeger#7346
|
@yurishkuro
I validated this in a running Jaeger instance. I sent a trace with a tag whose value is an array (serialized as ["value"]). The trace appears in the UI when searching by service, but searching for the tag using array_tag:["value"] returns no results. This confirms that array-valued tags are not searchable in the Jaeger UI, even if they are stored as JSON strings.
I will update the documentation to clarify that only string-valued tags are reliably searchable.
|

