# NAME

Sentry - Yet another lightweight Sentry client

# VERSION

version 0.01

# SYNOPSIS

```perl
    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

```perl
    %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.

```perl
    $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](https://docs.sentry.io/clientdev/interfaces/exception/)
[message](https://docs.sentry.io/clientdev/interfaces/message/)
[stacktrace](https://docs.sentry.io/clientdev/interfaces/stacktrace/)
[template](https://docs.sentry.io/clientdev/interfaces/template/)
[breadcrumbs](https://docs.sentry.io/clientdev/interfaces/breadcrumbs/)

[contexts](https://docs.sentry.io/clientdev/interfaces/contexts/)
[request](https://docs.sentry.io/clientdev/interfaces/request/)
[threads](https://docs.sentry.io/clientdev/interfaces/threads/)
[user](https://docs.sentry.io/clientdev/interfaces/user/)
[debug\_meta](https://docs.sentry.io/clientdev/interfaces/debug/)
[repos](https://docs.sentry.io/clientdev/interfaces/repos/)
[sdk](https://docs.sentry.io/clientdev/interfaces/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

```perl
    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.