Skip to content

The only tool you need to know what is happening and how to fix it.

Release docs + release workflows

dduxa7bfd10da2f8
diff --git a/.github/workflows/release-docs.yml b/.github/workflows/release-docs.yml
new file mode 100644
index 00000000..6cd0cf76
--- /dev/null
+++ b/.github/workflows/release-docs.yml
@@ -0,0 +1,42 @@
+name: Release Docs
+
+on:
+ release:
+ types: [published]
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ deploy:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup Node
+ uses: actions/setup-node@v4
+ with:
+ node-version: "latest"
+ cache: "npm"
+ cache-dependency-path: docs/package-lock.json
+
+ - name: Install dependencies
+ working-directory: docs
+ run: npm ci
+
+ - name: Build docs
+ working-directory: docs
+ run: npm run build
+
+ - name: Deploy to Cloudflare
+ uses: cloudflare/wrangler-action@v3
+ with:
+ apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+ accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+ workingDirectory: docs
+ command: deploy
+
+ - name: Summary
+ run: echo "Docs deployed (triggered by ${{ github.event_name }})." >> "$GITHUB_STEP_SUMMARY"
diff --git a/.github/workflows/release-traceway.yml b/.github/workflows/release-traceway.yml
index 0d30c151..27d84f59 100644
--- a/.github/workflows/release-traceway.yml
+++ b/.github/workflows/release-traceway.yml
@@ -60,9 +60,7 @@ jobs:
with:
node-version: "latest"
cache: "npm"
- cache-dependency-path: |
- frontend/package-lock.json
- website/package-lock.json
+ cache-dependency-path: frontend/package-lock.json
- name: Configure git
run: |
@@ -154,24 +152,10 @@ jobs:
--title "Backend v${{ inputs.version }}" \
--notes "$NOTES"
- - name: Install website dependencies
- working-directory: website
- run: npm ci
-
- - name: Build website
- working-directory: website
- run: npm run build
-
- - name: Deploy website to Cloudflare
- uses: cloudflare/wrangler-action@v3
- with:
- apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
- accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
- workingDirectory: website
- command: deploy
-
- name: Summary
run: |
echo "Released backend/v${{ inputs.version }}" >> "$GITHUB_STEP_SUMMARY"
echo "" >> "$GITHUB_STEP_SUMMARY"
echo "Users can now: \`go get github.com/tracewayapp/traceway/backend@v${{ inputs.version }}\`" >> "$GITHUB_STEP_SUMMARY"
+ echo "" >> "$GITHUB_STEP_SUMMARY"
+ echo "Website and docs deploys will run automatically on release publish." >> "$GITHUB_STEP_SUMMARY"
diff --git a/.github/workflows/release-website.yml b/.github/workflows/release-website.yml
new file mode 100644
index 00000000..6c2c1bda
--- /dev/null
+++ b/.github/workflows/release-website.yml
@@ -0,0 +1,42 @@
+name: Release Website
+
+on:
+ release:
+ types: [published]
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ deploy:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup Node
+ uses: actions/setup-node@v4
+ with:
+ node-version: "latest"
+ cache: "npm"
+ cache-dependency-path: website/package-lock.json
+
+ - name: Install dependencies
+ working-directory: website
+ run: npm ci
+
+ - name: Build website
+ working-directory: website
+ run: npm run build
+
+ - name: Deploy to Cloudflare
+ uses: cloudflare/wrangler-action@v3
+ with:
+ apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+ accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+ workingDirectory: website
+ command: deploy
+
+ - name: Summary
+ run: echo "Website deployed (triggered by ${{ github.event_name }})." >> "$GITHUB_STEP_SUMMARY"
diff --git a/scripts/backfill-github-releases.sh b/scripts/backfill-github-releases.sh
index 245904d9..0c22181c 100755
--- a/scripts/backfill-github-releases.sh
+++ b/scripts/backfill-github-releases.sh
@@ -3,7 +3,10 @@ set -euo pipefail
# Backfill GitHub Releases for existing backend/v* tags.
# Skips any tag that already has a release.
-# Notes are auto-generated by GitHub from commits since the previous tag.
+#
+# Release notes source:
+# 1. If website/content/blog/v<version>.mdx exists, use its body (after frontmatter).
+# 2. Otherwise, fall back to gh's --generate-notes (commits since previous tag).
#
# Requirements: gh CLI authenticated (`gh auth status`).
# Usage: scripts/backfill-github-releases.sh [--dry-run]
@@ -23,17 +26,37 @@ if ! gh auth status >/dev/null 2>&1; then
exit 1
fi
-mapfile -t TAGS < <(git tag --list 'backend/v*' --sort=version:refname)
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+BLOG_DIR="$REPO_ROOT/website/content/blog"
+
+TAGS=()
+while IFS= read -r line; do
+ TAGS+=("$line")
+done < <(git tag --list 'backend/v*' --sort=version:refname)
if [[ ${#TAGS[@]} -eq 0 ]]; then
echo "no backend/v* tags found"
exit 0
fi
+# Strip YAML frontmatter from a blog post (everything after the second `---`).
+extract_blog_body() {
+ local file="$1"
+ awk '
+ BEGIN { state = 0 }
+ /^---[[:space:]]*$/ {
+ if (state == 0) { state = 1; next }
+ if (state == 1) { state = 2; next }
+ }
+ state == 2 { print }
+ ' "$file"
+}
+
PREV_TAG=""
for TAG in "${TAGS[@]}"; do
VERSION="${TAG#backend/v}"
TITLE="Backend v${VERSION}"
+ BLOG_FILE="$BLOG_DIR/v${VERSION}.mdx"
if gh release view "$TAG" >/dev/null 2>&1; then
echo "skip ${TAG} (release already exists)"
@@ -41,19 +64,33 @@ for TAG in "${TAGS[@]}"; do
continue
fi
- echo "create ${TAG} -> '${TITLE}'"
+ if [[ -f "$BLOG_FILE" ]]; then
+ NOTES_SOURCE="blog: $(basename "$BLOG_FILE")"
+ else
+ NOTES_SOURCE="auto-generated (no blog post found)"
+ fi
+
+ echo "create ${TAG} -> '${TITLE}' [${NOTES_SOURCE}]"
if [[ $DRY_RUN -eq 1 ]]; then
PREV_TAG="$TAG"
continue
fi
- ARGS=(release create "$TAG" --title "$TITLE" --generate-notes)
- if [[ -n "$PREV_TAG" ]]; then
- ARGS+=(--notes-start-tag "$PREV_TAG")
+ if [[ -f "$BLOG_FILE" ]]; then
+ NOTES="$(extract_blog_body "$BLOG_FILE")"
+ if [[ -z "${NOTES//[[:space:]]/}" ]]; then
+ NOTES="$TITLE"
+ fi
+ gh release create "$TAG" --title "$TITLE" --notes "$NOTES"
+ else
+ ARGS=(release create "$TAG" --title "$TITLE" --generate-notes)
+ if [[ -n "$PREV_TAG" ]]; then
+ ARGS+=(--notes-start-tag "$PREV_TAG")
+ fi
+ gh "${ARGS[@]}"
fi
- gh "${ARGS[@]}"
PREV_TAG="$TAG"
done
diff --git a/website/content/blog/v1.5.0.mdx b/website/content/blog/v1.5.0.mdx
new file mode 100644
index 00000000..d262ba2c
--- /dev/null
+++ b/website/content/blog/v1.5.0.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.5.0"
+date: "2026-02-22"
+version: "1.5.0"
+---
+- First tagged release of the Traceway backend.
diff --git a/website/content/blog/v1.5.1.mdx b/website/content/blog/v1.5.1.mdx
new file mode 100644
index 00000000..35e0f012
--- /dev/null
+++ b/website/content/blog/v1.5.1.mdx
@@ -0,0 +1,11 @@
+---
+title: "Backend v1.5.1"
+date: "2026-02-22"
+version: "1.5.1"
+---
+- Added `disableLogging` option for embedded library use.
+- Gin now runs in release mode when used as a library (no logging).
+- Worked around Parquet UUID incompatibility with ClickHouse.
+- Fixed time representation in embedded ClickHouse.
+- Fixed duration insertion bug.
+- Documentation updates.
diff --git a/website/content/blog/v1.5.2.mdx b/website/content/blog/v1.5.2.mdx
new file mode 100644
index 00000000..573b46c0
--- /dev/null
+++ b/website/content/blog/v1.5.2.mdx
@@ -0,0 +1,7 @@
+---
+title: "Backend v1.5.2"
+date: "2026-02-22"
+version: "1.5.2"
+---
+- Suppressed Gin logging when the `disableLogging` option is enabled.
+- Added an OpenTelemetry example with in-process databases stored in memory.
diff --git a/website/content/blog/v1.5.3.mdx b/website/content/blog/v1.5.3.mdx
new file mode 100644
index 00000000..9ea83832
--- /dev/null
+++ b/website/content/blog/v1.5.3.mdx
@@ -0,0 +1,12 @@
+---
+title: "Backend v1.5.3"
+date: "2026-03-23"
+version: "1.5.3"
+---
+- Added a notifications system with rule-based alerting.
+- Added PHP/Symfony OpenTelemetry support, including automatic handler span tracing.
+- Added distributed tracing across services.
+- Added custom units to metrics.
+- Improved SQLite support and OpenTelemetry trace ID handling.
+- Improved embed docs and updated README.
+- Validation message cleanup.
diff --git a/website/content/blog/v1.6.2.mdx b/website/content/blog/v1.6.2.mdx
new file mode 100644
index 00000000..1467cb7e
--- /dev/null
+++ b/website/content/blog/v1.6.2.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.6.2"
+date: "2026-03-23"
+version: "1.6.2"
+---
+- Release packaging update; no functional changes.
diff --git a/website/content/blog/v1.6.3.mdx b/website/content/blog/v1.6.3.mdx
new file mode 100644
index 00000000..8d8462df
--- /dev/null
+++ b/website/content/blog/v1.6.3.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.6.3"
+date: "2026-03-23"
+version: "1.6.3"
+---
+- Added distributed tracing for Traceway itself.
diff --git a/website/content/blog/v1.6.5.mdx b/website/content/blog/v1.6.5.mdx
new file mode 100644
index 00000000..4ad0dcfd
--- /dev/null
+++ b/website/content/blog/v1.6.5.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.6.5"
+date: "2026-03-23"
+version: "1.6.5"
+---
+- Fixed metric record insertion bug.
diff --git a/website/content/blog/v1.6.6.mdx b/website/content/blog/v1.6.6.mdx
new file mode 100644
index 00000000..54c43145
--- /dev/null
+++ b/website/content/blog/v1.6.6.mdx
@@ -0,0 +1,11 @@
+---
+title: "Backend v1.6.6"
+date: "2026-03-27"
+version: "1.6.6"
+---
+- Added jQuery support with CDN deployment.
+- Added distributed trace ID parsing from OpenTelemetry headers.
+- Added a "current span" pill in the distributed tracing UI.
+- Fixed the empty-state code snippet on span detail view.
+- Documentation updates for jQuery and Symfony devtesting.
+- Bug fix closing #100.
diff --git a/website/content/blog/v1.7.0.mdx b/website/content/blog/v1.7.0.mdx
new file mode 100644
index 00000000..291bd086
--- /dev/null
+++ b/website/content/blog/v1.7.0.mdx
@@ -0,0 +1,8 @@
+---
+title: "Backend v1.7.0"
+date: "2026-03-31"
+version: "1.7.0"
+---
+- Added notifications for AI traces (OpenRouter integration).
+- README and website updates.
+- jQuery docs URL fixes.
diff --git a/website/content/blog/v1.7.1.mdx b/website/content/blog/v1.7.1.mdx
new file mode 100644
index 00000000..b3747402
--- /dev/null
+++ b/website/content/blog/v1.7.1.mdx
@@ -0,0 +1,8 @@
+---
+title: "Backend v1.7.1"
+date: "2026-03-31"
+version: "1.7.1"
+---
+- Improved Node.js OpenTelemetry integration with fixture tests.
+- Fixed faulty loggers.
+- Fixed 500 error when no records exist.
diff --git a/website/content/blog/v1.7.10.mdx b/website/content/blog/v1.7.10.mdx
new file mode 100644
index 00000000..b44937ac
--- /dev/null
+++ b/website/content/blog/v1.7.10.mdx
@@ -0,0 +1,11 @@
+---
+title: "Backend v1.7.10"
+date: "2026-04-26"
+version: "1.7.10"
+---
+- Added SQLite-based Docker deployment with Railway deploy info.
+- Added area chart for memory usage metrics.
+- Added additional graphs for the regular OpenTelemetry agent.
+- Improved docs styling and fixed SQLite docs.
+- Session replay page progress.
+- Bug fix closing #104.
diff --git a/website/content/blog/v1.7.11.mdx b/website/content/blog/v1.7.11.mdx
new file mode 100644
index 00000000..4f8d6575
--- /dev/null
+++ b/website/content/blog/v1.7.11.mdx
@@ -0,0 +1,9 @@
+---
+title: "Backend v1.7.11"
+date: "2026-04-27"
+version: "1.7.11"
+---
+- Removed the Process tab from the default view.
+- SQLite performance improvements.
+- Improved process metrics.
+- README updates.
diff --git a/website/content/blog/v1.7.12.mdx b/website/content/blog/v1.7.12.mdx
new file mode 100644
index 00000000..f252c75b
--- /dev/null
+++ b/website/content/blog/v1.7.12.mdx
@@ -0,0 +1,7 @@
+---
+title: "Backend v1.7.12"
+date: "2026-04-28"
+version: "1.7.12"
+---
+- Added logs and actions panel to frontend/Flutter stack traces.
+- Flutter docs updates.
diff --git a/website/content/blog/v1.7.13.mdx b/website/content/blog/v1.7.13.mdx
new file mode 100644
index 00000000..b927cb48
--- /dev/null
+++ b/website/content/blog/v1.7.13.mdx
@@ -0,0 +1,9 @@
+---
+title: "Backend v1.7.13"
+date: "2026-04-29"
+version: "1.7.13"
+---
+- Added SSO authentication.
+- Star metrics widgets to surface them on the home page.
+- SSO documentation.
+- Bug fixes.
diff --git a/website/content/blog/v1.7.14.mdx b/website/content/blog/v1.7.14.mdx
index dd9b2aad..006d4dde 100644
--- a/website/content/blog/v1.7.14.mdx
+++ b/website/content/blog/v1.7.14.mdx
@@ -3,5 +3,4 @@ title: "Backend v1.7.14"
date: "2026-05-01"
version: "1.7.14"
---
-- Initial release post on the new Traceway blog.
-- Future releases will be published here automatically with each version.
+- Updated badge color.
diff --git a/website/content/blog/v1.7.2.mdx b/website/content/blog/v1.7.2.mdx
new file mode 100644
index 00000000..8cd08ce8
--- /dev/null
+++ b/website/content/blog/v1.7.2.mdx
@@ -0,0 +1,8 @@
+---
+title: "Backend v1.7.2"
+date: "2026-04-02"
+version: "1.7.2"
+---
+- Added organization ID attribute to traces.
+- Added `release-traceway.sh` script.
+- README updates and cleanup.
diff --git a/website/content/blog/v1.7.3.mdx b/website/content/blog/v1.7.3.mdx
new file mode 100644
index 00000000..125fb6ba
--- /dev/null
+++ b/website/content/blog/v1.7.3.mdx
@@ -0,0 +1,11 @@
+---
+title: "Backend v1.7.3"
+date: "2026-04-10"
+version: "1.7.3"
+---
+- Added Flutter support with stack trace docs.
+- Added Hono framework support.
+- Started Next.js and NestJS docs and OpenTelemetry test examples.
+- Migrated JavaScript SDK toward an OpenTelemetry-based architecture.
+- Added Google Analytics tag to the website.
+- Various docs and website updates.
diff --git a/website/content/blog/v1.7.4.mdx b/website/content/blog/v1.7.4.mdx
new file mode 100644
index 00000000..ee5fed5e
--- /dev/null
+++ b/website/content/blog/v1.7.4.mdx
@@ -0,0 +1,8 @@
+---
+title: "Backend v1.7.4"
+date: "2026-04-15"
+version: "1.7.4"
+---
+- Improved presentation logic for stack traces.
+- Updated UI to correctly display Flutter stack traces.
+- Flutter docs updates.
diff --git a/website/content/blog/v1.7.5.mdx b/website/content/blog/v1.7.5.mdx
new file mode 100644
index 00000000..651df612
--- /dev/null
+++ b/website/content/blog/v1.7.5.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.7.5"
+date: "2026-04-15"
+version: "1.7.5"
+---
+- Fixed bug where the global value was used when opening a specific exception instance.
diff --git a/website/content/blog/v1.7.6.mdx b/website/content/blog/v1.7.6.mdx
new file mode 100644
index 00000000..80693da0
--- /dev/null
+++ b/website/content/blog/v1.7.6.mdx
@@ -0,0 +1,6 @@
+---
+title: "Backend v1.7.6"
+date: "2026-04-15"
+version: "1.7.6"
+---
+- Use the last occurrence when one exists for exception details.
diff --git a/website/content/blog/v1.7.7.mdx b/website/content/blog/v1.7.7.mdx
new file mode 100644
index 00000000..223e433d
--- /dev/null
+++ b/website/content/blog/v1.7.7.mdx
@@ -0,0 +1,11 @@
+---
+title: "Backend v1.7.7"
+date: "2026-04-21"
+version: "1.7.7"
+---
+- Logs feature v1: end-to-end logs ingestion, storage, and UI.
+- Added default metrics for Go and OpenTelemetry projects.
+- Started a Flutter session replays page.
+- Frontend redesigned to match the new website.
+- Improved contact-us page and docs styling.
+- Updated Flutter docs.
diff --git a/website/content/blog/v1.7.8.mdx b/website/content/blog/v1.7.8.mdx
new file mode 100644
index 00000000..6ca113d5
--- /dev/null
+++ b/website/content/blog/v1.7.8.mdx
@@ -0,0 +1,7 @@
+---
+title: "Backend v1.7.8"
+date: "2026-04-21"
+version: "1.7.8"
+---
+- Reverted backend metric and client controller changes due to a regression.
+- Frontend polish.
diff --git a/website/content/blog/v1.7.9.mdx b/website/content/blog/v1.7.9.mdx
new file mode 100644
index 00000000..0387106e
--- /dev/null
+++ b/website/content/blog/v1.7.9.mdx
@@ -0,0 +1,10 @@
+---
+title: "Backend v1.7.9"
+date: "2026-04-21"
+version: "1.7.9"
+---
+- Reapplied previously reverted backend metric improvements.
+- Added spans visualization and website image.
+- Logs sidebar fix.
+- Source map resolver fixes.
+- More website design work.