Skip to content

fix: trace row labels#4443

Merged
BloggerBust merged 5 commits into
mainfrom
feat/trace-row-labels
Jul 16, 2026
Merged

fix: trace row labels#4443
BloggerBust merged 5 commits into
mainfrom
feat/trace-row-labels

Conversation

@BloggerBust

@BloggerBust BloggerBust commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Description

The run trace view labeled engine-generated rows only by their span names, such as hatchet.engine.workflow_run, so repeated rows were indistinguishable. A user reported this in Discord. The span name stays the primary label, consistent with how trace tools label spans, and each engine row gains a badge with its Hatchet identity. The PR also fixes a queued-bar color bug on retried tasks.

Type of change

  • Bug fix (non-breaking change which fixes an issue)

What's Changed

  • Engine trace rows show their workflow, task, or event identity in a badge next to the span name; the short run id, event id, or retry number stays visible when the name truncates.
  • Tooltips title the span name and show the identity as the subtitle.
  • A successful retry no longer shows its queued bar as an error.
  • Added unit tests for the identity and error-state helpers.

Checklist

Changes have been:

  • Tested (unit tests, plus manual verification in a local dashboard)
  • Linted and formatted
  • Added to CHANGELOG (where applicable) -- see Keep a Changelog

🤖 AI Disclosure
  • I acknowledge that an LLM was used in the creation of this Pull Request, in accordance with Hatchet's AI_POLICY.md.

  • Details: Claude Opus 4.8 (Claude Code) was used for the investigation and writing the unit tests.

Before

shot-20260716-121410 shot-20260716-121632

After

shot-20260716-121516 shot-20260716-122114

@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hatchet-docs Ready Ready Preview, Comment Jul 16, 2026 6:51pm

Request Review

@github-actions github-actions Bot added the dashboard Related to the Hatchet dashboard label Jul 16, 2026
@BloggerBust BloggerBust force-pushed the feat/trace-row-labels branch from df9d8cf to 927f693 Compare July 16, 2026 00:27
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Optional test failure: The load-deadlock job failed on this PR (optimistic-scheduling=true). This check is non-mandatory and does not block merging, but may be worth investigating. View logs

The Traces tab showed the raw engine span name on every row, such as
hatchet.engine.workflow_run, which a user cannot read.

Note: A short run id is appended to workflow-run rows because run display names
are not unique across concurrent runs.
Retried tasks render start_step_run span attempts all with the same
task name, so the rows were indistinguishable in the trace view. Step-run
labels now append the retry number from hatchet.retry_count when it is above
zero. I also

The queued bar was colored by hasErrorInTree, which walks the subtree, so a
successful retry showed red, because the converter nests the failed attempts
under the surviving one. isSpanError colors by an engine span's own status and
only falls back to the subtree for non-engine spans.
Rows for hatchet.engine.event and hatchet.engine.event_emitted showed
the internal span name. They now show the event key, with a short event
id appended so rows stay distinct when one task emits the same key more
than once.
Replacing span names on engine rows made the trace view inconsistent
with how trace tooling labels spans, so the raw span name is back as
the primary label on every row. The workflow, task, or event identity
now renders in the badge next to it, split into name and discriminator
so the short run id, event id, or retry number stays visible when the
name truncates. Group headers return to raw span names, and tooltips
title the span name with the identity as the subtitle.

@mrkaye97 mrkaye97 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🚢 looks great!

@BloggerBust BloggerBust merged commit 8f6e443 into main Jul 16, 2026
41 of 42 checks passed
@BloggerBust BloggerBust deleted the feat/trace-row-labels branch July 16, 2026 20:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dashboard Related to the Hatchet dashboard

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants