Rollbar.com interface for Common Lisp
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
README.md
rollbar.asd
rollbar.lisp

README.md

Rollbar.com is a service for collecting automated telemetry (ie, bug reports, mostly) through their web service.

This package is a completely independent attempt to re-implement their general “per-language” APIs in such a way as to be useful for Common Lisp programs. It is not particularly “authorized” and definitely not “supported” by Rollbar, but they have kindly added it to their list of third-party libraries, so it's not unknown to them.

Automatic telemetry

In general, you should be able to establish a dynamic extent in which Rollbar is your effective “debugger” and have conditions reported to the servers without much additional tooling on your part.

  (rollbar:with-configuration
    (:access-token "…"
     :environment "development"
     :code-version "v1.0"
     :framework "my-cool-framework"
     :server (machine-instance))
    (rollbar:with-rollbar-for-debugger ()
       (main)))

See also rollbar:classify-error-level to customize how conditions are classified.

“Manual” telemetry

See: rollbar:notify for the general case, or rollbar:debug!, info!, warning!, error!, and critical! to skip right to various levels.

(rollbar:notify :info "Hello, World")
  
(handler-case
    (error "I'm so sad")
  (error (condition)
    (rollbar:error! "Good-bye, Cruel World"
                    :condition condition)))