Download the PHP package bgalati/monolog-sentry-handler without Composer
On this page you can find all versions of the php package bgalati/monolog-sentry-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bgalati/monolog-sentry-handler
More information about bgalati/monolog-sentry-handler
Files in bgalati/monolog-sentry-handler
Package monolog-sentry-handler
Short Description Sentry handler for PHP SDK v2/v3
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package monolog-sentry-handler
Monolog Sentry Handler
It is a Monolog handler for Sentry PHP SDK v2 and v3 with breadcrumbs support.
Features
- Send each log record to a Sentry server
- Send log records as breadcrumbs when they are handled in batch; the main reported log record is the one with the highest log level
- Send log along with exception when one is set in the main log record context
- Customize data sent to Sentry to fit your needs
- Compatible with Monolog 1, 2 and 3
Installation
The suggested installation method is via composer:
Basic usage
Check out the handler constructor to know how to control the minimum logging level and bubbling.
Note
- It is a good idea to combine this handler with a
FingersCrossedHandlerand aBufferHandlerto leverage Sentry breadcrumbs. It gives maximum context for each Sentry event.Look at the symfony guide for a complete example with Monolog and symfony
Documentation
- Symfony guide: it gives a way to integrate this handler to your app
- Working example with Symfony
- Extension points: Customize data sent to Sentry and more
FAQ
What are the differences with the official Monolog Sentry handlers?
At the moment the official SDK proposes two Monolog handlers:
Sentry\Monolog\Handler: each logs becomes a Sentry event- Depending on the setup it can create a lot of noise.
Sentry\Monolog\BreadcrumbHandler: each logs is added as a breadcrumb in the current event- It cannot be used only with Monolog: it requires default integrations to work correctly.
Both of them don't send event immediately. Thus, sending Sentry events happens; either when PHP process terminates or when the flush is done explicitly.
This lib proposes a Handler that is different:
- It flushes Sentry events on each call: looks like a standard for Monolog handlers
- It adds log records as breadcrumbs when it is used with a buffering handler like
FingersCrossedHandler
What about contributing it to the Monolog project?
As per this comment, Monolog project does not accept new handler with 3rd party dependencies.
For new handlers with third-party dependencies IMO the right way is to publish as a third-party package, with requires on monolog and on whichever dependency is needed. It lets Composer resolve everything which makes more sense really.
Contributing
Fork me.
Install dependencies with make vendor.
Run tests with make tests.
Changelog
See CHANGELOG.md.
Credits
All versions of monolog-sentry-handler with dependencies
monolog/monolog Version ^1.6 || ^2.0 || ^3.0
sentry/sentry Version ^3.1 || ^4.0