Go

AllStak SDK for Go services. Captures errors, logs, inbound and outbound HTTP requests, spans, database telemetry, and cron heartbeats.

Install

go get github.com/AllStak/allstak-go

Setup

package main

import (
	"context"
	"errors"
	"net/http"
	"os"

	allstak "github.com/AllStak/allstak-go"
)

func main() {
	client := allstak.New(allstak.Config{
		APIKey:      os.Getenv("ALLSTAK_API_KEY"),
		Environment: os.Getenv("APP_ENV"),
		Release:     os.Getenv("ALLSTAK_RELEASE"),
		ServiceName: "checkout-api",
	})
	defer client.Flush(context.Background())

	mux := http.NewServeMux()
	mux.HandleFunc("/checkout", func(w http.ResponseWriter, r *http.Request) {
		ctx, finish := client.StartSpan(r.Context(), "checkout.authorize")
		defer finish(nil)

		client.CaptureLog(allstak.LogPayload{
			Level:   "info",
			Message: "checkout started",
		})

		w.WriteHeader(http.StatusCreated)
	})

	client.CaptureException(context.Background(), errors.New("example error"))
	http.ListenAndServe(":3000", allstak.Middleware(client)(mux))
}

Outbound HTTP

httpClient := &http.Client{
	Transport: allstak.NewTransport(client, nil),
}

Gin

import allstakgin "github.com/AllStak/allstak-go/integrations/allstakgin"

router.Use(allstakgin.Middleware(client))

Echo

import allstakecho "github.com/AllStak/allstak-go/integrations/allstakecho"

e.Use(allstakecho.Middleware(client))

The Echo middleware recovers panics as fatal events, captures errors returned from handlers, records the inbound request with the matched route template (e.g. /users/:id), and propagates trace context to downstream/outbound calls.

Configuration

Privacy

The SDK redacts common sensitive headers and fields. Avoid putting secrets in custom metadata.

Troubleshooting

• No events: confirm ALLSTAK_API_KEY is set and the client is reused for the process lifetime.
• Missing request correlation: keep traceparent, baggage, and x-request-id headers through proxies.
• Short-lived command: call client.Flush(ctx) before exit.

Contributing and Support

• Report bugs with the GitHub bug report template: https://github.com/AllStak/allstak-go/issues/new/choose
• Open pull requests using the checklist in CONTRIBUTING.md.
• Report security vulnerabilities privately through SECURITY.md.

License

MIT