feat: add traceId to upload logs and improve observability - #647
Merged
Conversation
Threads a per-request trace ID through all upload-related log lines (pkg:put, alias:put, alias:post, map:put and the multipart parser). The trace ID is read from req.traceId which the service layer sets from the Fastify request ID. Additional changes: - Upload start and completion logs in pkg.put handler - Error logs for the four previously silent 502 failure paths - Tar extraction success log with total/written/failed file counts - Abort log when an upload is cancelled - eik.json presence/absence logged at debug level - Per-file write start and success logs downgraded from info to debug - Name and Version added to parser log lines where missing - traceId passed to sink.write() to enable GCS object metadata tagging - Copy-paste bug fixed in alias.put handler (was logging alias:post)
The @eik/sink base class type definition does not yet include the optional third options parameter. Suppress the type error with @ts-ignore until the base class is updated and a new version is published.
wkillerud
approved these changes
Aug 24, 2026
github-actions Bot
pushed a commit
that referenced
this pull request
Aug 24, 2026
# [2.3.0](v2.2.3...v2.3.0) (2026-08-24) ### Features * add traceId to upload logs and improve observability ([#647](#647)) ([32f8d38](32f8d38))
|
🎉 This PR is included in version 2.3.0 🎉 The release is available on: Your semantic-release bot 📦🚀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Threads a per-request trace ID through all upload-related log lines and adds missing log points across the upload path.
Trace ID
Each log line for a request now includes the trace ID from `req.traceId` (set by the service layer from the Fastify request ID). This makes it straightforward to filter all logs for a single upload in any log aggregation tool. The trace ID is also passed to `sink.write()` so GCS sinks can store it as object metadata.
New log points
pkg.put handler:
Multipart parser:
Alias handlers:
Log level changes
Per-file write start and success logs downgraded from `info` to `debug`. A package with 50 files previously produced 100 `info` lines per upload; these are now only visible when debug logging is enabled.
Bug fix
A copy-paste error in `alias.put.js` that logged `alias:post` instead of `alias:put` is corrected.