File: README.md

package info (click to toggle)
golang-github-stvp-roll 0.0~git20170522.3627a5c-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 84 kB
  • sloc: makefile: 2
file content (53 lines) | stat: -rw-r--r-- 1,606 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
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](https://github.com/heroku/rollbar).

[API docs on godoc.org](http://godoc.org/github.com/stvp/roll)

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
============

* @challiwill
* @tysonmote
* @apg

This library was forked from [stvp/rollbar](https://github.com/stvp/rollbar),
which had contributions from:

* @kjk
* @Soulou
* @paulmach