README
¶
Stanza Go SDK
Stanza is a developer-first tool for increasing reliability based on prioritized traffic management, quota allocation, and rate-limiting. On the back-end, it helps prevent downtime related to overload and excessive use of third-party APIs. On the front-end, it helps segment and weight your traffic, react automatically to overload or other conditions, and inspect the state of your critical user journeys.
"Stanza Go SDK" provides higher-order functions ("guards") for adding this fault tolerance to your Golang application.
Installation
Stanza's sdk-go can be installed like any other Go library via go get:
$ go get github.com/StanzaSystems/sdk-go@latest
Configuration
To use sdk-go, you'll need to import the sdk-go package and initialize it with a Stanza API Key and other options.
If not specified in the SDK initialization, the API Key, Service Name, Service Release, and Environment are read from the environment variables STANZA_API_KEY, STANZA_SERVICE_NAME, STANZA_SERVICE_RELEASE, and STANZA_ENVIRONMENT, respectively.
For more information, see the Initialize Stanza section of our Go SDK documentation.
Usage
The SDK supports adding flow control, traffic shaping, concurrency limiting, circuit breaking, and adaptive system protection (via Sentinel) as well as weighted, prioritized, global rate limiting (via our own custom implementation). All of which is externally managed by the Stanza Dashboard.
The adapters/fiberstanza/example directory is a good place to start! (It's an example application which shows how to wrap inbound and outbound HTTP traffic with Stanza Guards.)
Or browse the Official Stanza Documentation for more info on how to get started.
Community
Join Stanza's Community Discord to get involved and help us improve the SDK!
Directories