NAME
Sentry - Yet another lightweight Sentry client
VERSION
version 0.01
SYNOPSIS
my $sentry = Sentry->new( $dsn, tags => { type => 'autocharge' } );
$sentry->fatal( 'msg' );
$sentry->error( 'msg' );
$sentry->warn ( 'msg' );
$sentry->warning ( 'msg' ); # alias to warn
$sentry->info ( 'msg' );
$sentry->debug( 'msg' );
$sentry->error( $error_msg, extra => { var1 => $var1 } );
All this methods return event id as result or die with error
%params:
message* -- error message
event_id -- message id (by default it's random, but you can generate it manually on client side)
platform* -- A string representing the platform the SDK is submitting from. E.g. 'python', 'perl by default'
logger -- the name of the logger which created the record, e.g 'sentry.errors'
level -- 'fatal', 'error', 'warning', 'info', 'debug' ('error' by default)
culprit -- The name of the transaction (or culprit) which caused this exception. For example, in a web app, this might be the route name: /welcome/
server_name -- host from which the event was recorded
release -- the release version of the application
tags -- tags for this event (could be array or hash )
environment -- environment name, such as ‘production’ or ‘staging’.
modules -- a list of relevant modules and their versions
extra -- hash ref of additional data. Non scalar values are Dumperized forcely
* - required params
Sentry Interfaces could be also provided as %params, e.g.
$sentry->info ( 'msg', stacktrace => {
frames => [{
"abs_path" => "/real/file/name.pl",
"filename" => "file/name.pl",
"function" => "myfunction",
"vars" => {
"key" => "value"
}
}]
});
$sentry->warn ( 'msg', user => {
"id" => "unique_id",
"username" => "my_user",
"email" => "foo@example.com",
"ip_address" => "127.0.0.1",
"subscription" => "basic"
});
List of supported additional parameters with link to corresponded Sentry Interfaces
exception message stacktrace template breadcrumbs
contexts request threads user debug_meta repos sdk
DESCRIPTION
Module for sending messages to Sentry, open-source cross-platform crash reporting and aggregation platform.
Implements Sentry reporting API https://docs.sentry.io/clientdev/
It doesn't form stacktrace, just send it
NAME
Sentry
SEE ALSO
https://docs.sentry.io/clientdev/overview/#building-the-json-packet
https://docs.sentry.io/clientdev/attributes/
https://docs.sentry.io/clientdev/interfaces/
new
Constructor
my $sentry = Sentry->new(
'http://public_key:secret_key@example.com/project-id',
sentry_version => 5 # protocol version can be omitted, 7 by default
);
See also
https://docs.sentry.io/clientdev/overview/#parsing-the-dsn
https://docs.sentry.io/clientdev/overview/#authentication
AUTHOR
Pavel Serikov <pavelsr@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2018 by Pavel Serikov.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.