Skip to content

feat(transports/betterstack): add new Better Stack transport#88

Merged
theogravity merged 4 commits into
mainfrom
feature/betterstack-transport
May 11, 2026
Merged

feat(transports/betterstack): add new Better Stack transport#88
theogravity merged 4 commits into
mainfrom
feature/betterstack-transport

Conversation

@theogravity
Copy link
Copy Markdown
Contributor

Summary

New transports/betterstack package that ships logs to Better Stack's HTTP intake API.

What's New

  • Better Stack Transport: Full implementation with:
    • Source token authentication via Authorization: Bearer <token> header
    • Configurable timestamp field (default: dt)
    • Automatic metadata flattening at root level
    • Customizable HTTP headers (auth/content-type replaced, user headers preserved)
    • Comprehensive unit tests and livetest support

Key Features

  • Wraps transports/http for batched delivery with configurable BatchSize/BatchInterval
  • Supports all log levels (trace, debug, info, warn, error, fatal, panic)
  • Properly handles metadata fields as flat JSON properties
  • URL validation enforces HTTPS unless AllowInsecureURL=true
  • HTTP headers merge: auth/content-type replaced, custom headers preserved

Testing

go test ./transports/betterstack/ -v          # all tests pass
go test -tags=livetest ./transports/betterstack/ -v  # live API (requires BETTERSTACK_SOURCE_TOKEN)

Documentation

  • Added docs/src/transports/betterstack.md
  • Updated sidebar in docs/.vitepress/config.ts (Cloud section)
  • Added to transport list partial
  • Updated llms.txt, llms-full.txt

Changelog

Changeset added: .changeset/tiny-wren.md


resolves: #88

@theogravity theogravity force-pushed the feature/betterstack-transport branch from 42fc4f8 to 42dd239 Compare May 11, 2026 00:38
@theogravity theogravity merged commit 4be05a1 into main May 11, 2026
13 checks passed
@theogravity theogravity deleted the feature/betterstack-transport branch May 11, 2026 00:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant