README.md

roll

roll is a basic Rollbar client for Go that reports errors and logs messages. It automatically builds stack traces and also supports arbitrary traces. All errors and messages are sent to Rollbar synchronously.

roll is intentionally simple. For more advanced functionality, check out heroku/rollbar.

API docs on godoc.org

Notes

• Critical-, Error-, and Warning-level messages include a stack trace. However, Go's error type doesn't include stack information from the location the error was set or allocated. Instead, roll uses the stack information from where the error was reported.
• Info- and Debug-level Rollbar messages do not include stack traces.
• When calling roll away from where the error actually occurred, roll's stack walking won't represent the actual stack trace at the time the error occurred. The *Stack variants of Critical, Error, and Warning take a []uintptr, allowing the stack to be provided, rather than walked.

Running Tests

go test will run tests against a fake server by default.

If the environment variable TOKEN is a Rollbar access token, running go test will produce errors using an environment named test.

TOKEN=f0df01587b8f76b2c217af34c479f9ea go test

Verify the reported errors manually in the Rollbar dashboard.

Contributors

• @apg

This library was forked from stvp/rollbar, which had contributions from:

• @kjk
• @Soulou
• @paulmach