The only tool you need to know what is happening and how to fix it.
Go alertingexception-trackerissue-trackinglogsmetricsmonitoringobservability-platformopen-telemetryotelsession-replaytelemetrytraces
Release docs + release workflows
dduxa7bfd10da2f8
diff --git a/.github/workflows/release-docs.yml b/.github/workflows/release-docs.ymlnew file mode 100644index 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.ymlindex 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 gitrun: |@@ -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: Summaryrun: |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.ymlnew file mode 100644index 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.shindex 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; thenexit 1fi-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 ]]; thenecho "no backend/v* tags found"exit 0fi+# 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[@]}"; doVERSION="${TAG#backend/v}"TITLE="Backend v${VERSION}"+ BLOG_FILE="$BLOG_DIR/v${VERSION}.mdx"if gh release view "$TAG" >/dev/null 2>&1; thenecho "skip ${TAG} (release already exists)"@@ -41,19 +64,33 @@ for TAG in "${TAGS[@]}"; docontinuefi- 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 ]]; thenPREV_TAG="$TAG"continuefi- 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"donediff --git a/website/content/blog/v1.5.0.mdx b/website/content/blog/v1.5.0.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxindex 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.