raven-lua

A small Lua interface to Sentry that also has a helpful wrapper function call() that takes any arbitrary Lua function (with arguments) and executes it, traps any errors and reports it automatically to Sentry.

Synopsis

localraven=require"raven"-- http://pub:secret@127.0.0.1:8080/sentry/proj-idlocalrvn=raven.new {
-- multiple senders are available for different networking backends,-- doing a custom one is also very easy.sender=require("raven.senders.luasocket").new {
dsn="http://pub:secret@127.0.0.1:8080/sentry/proj-id",
},
tags= { foo="bar" },
}
-- Send a message to sentrylocalid, err=rvn:captureMessage(
"Sentry is a realtime event logging and aggregation platform.",
{ tags= { abc="def" } } -- optional
)
ifnotidthenprint(err)
end-- Send an exception to sentrylocalexception= {{
["type"]="SyntaxError",
["value"]="Wattttt!",
["module"]="__builtins__"
}}
localid, err=rvn:captureException(
exception,
{ tags= { abc="def" } } -- optional
)
ifnotidthenprint(err)
end-- Catch an exception and send it to sentryfunctionbad_func(n)
returnnot_defined_func(n)
end-- variable 'ok' should be false, and an exception will be sent to sentrylocalok=rvn:call(bad_func, 1)

Documentation

See docs/index.html for more details.

Prerequisites

To run the tests:

 luarocks install lunit
luarocks install lua-cjson
luarocks install luaposix
luarocks install luasocket
luarocks install luasec
make test

To generate the docs:

 luarocks install ldoc
make doc