The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Airbrake::V2 - Airbrake Notifier API V2 Client

VERSION

version 0.04

SYNOPSIS

  use Net::Airbrake::V2;

  my $airbrake = Net::Airbrake::V2->new(
      api_key    => 'xxxxxxx',
      # project_id is not used.
  );

  eval { die 'Oops' };
  $airbrake->notify($@);

DESCRIPTION

API Compatible with Net::Airbrake but converts v3 requests to v2 and then converts the response back.

This makes it usable with Errbit <= v0.3.

Note: This is currently based heavily on the internals of Net::Airbrake (as of 0.02). This enables laziness at the cost of fragility. As such the implementation is subject to change.

See Net::Airbrake for descriptions of methods and arguments.

METHODS

stringify_ref

The values of the the "var" hashes ("params", "session", and "environment") that are references (other than hashes) will stringified.

This is currently done with Data::Dumper which is similar to the way the ruby gem dumps structures. The format is subject to change.

convert_request

  $client->convert_request(\%v3_request);
  Net::Airbrake::V2->convert_request(\%v3_request, \%config);

Convert a v3 request (JSON) to v2 (XML). This rearranges the data structure as best it can.

This can also be called as a class method if a config hash is passed, containing:

  • api_key

convert_response

Convert v2 response (XML) to v3 response (JSON).

VERSION DIFFERENCES

Some data may be lost converting from v3 to v2. Specifically v2 does not have explicit places for:

  errors/{i}/backtrace/{i}/column
  context/os
  context/language
  context/userAgent
  context/userId
  context/userName
  context/userEmail

SEE ALSO

SUPPORT

Perldoc

You can find documentation for this module with the perldoc command.

  perldoc Net::Airbrake::V2

Websites

The following websites have more information about this module, and may be of help to you. As always, in addition to those websites please use your favorite search engine to discover more resources.

Bugs / Feature Requests

Please report any bugs or feature requests by email to bug-net-airbrake-v2 at rt.cpan.org, or through the web interface at https://rt.cpan.org/Public/Bug/Report.html?Queue=Net-Airbrake-V2. You will be automatically notified of any progress on the request by the system.

Source Code

https://github.com/rwstauner/Net-Airbrake-V2

  git clone https://github.com/rwstauner/Net-Airbrake-V2.git

AUTHOR

Randy Stauner <rwstauner@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Randy Stauner.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.