Provide docs for Monolog integration and make it an "official integration".

[timkelty]

Problem Statement

If you want to use Sentry via Monolog and are not using a supported framework like Laravel or Symfony, it is not clear how to proceed.

Given that Monolog pretty much the defacto logging lib for PHP, it seems like this should be an "official integration". Having a supported Monolog handler should also reduce the need for bespoke framework integrations, or at least the amount of code they have to supply.

https://github.com/getsentry/sentry-php/blob/master/src/Monolog/Handler.php exists, but has no docs.

To make things more confusing:

• The official Laravel integration uses a Monolog handler, but for some reason, a different one.
• Any search for "sentry monolog" will land you on @B-Galati's 3rd party handler, which is not even listed here.

Solution Brainstorm

• Document Sentry\Monolog\Handler
  • Make it canonical (the Laravel integration should use it)
  • Treat it as an "official integration"

[getsantry[bot]]

Assigning to @getsentry/support for routing ⏲️

[cleptric]

Laravel already uses the PHP SDKs Monolog Handler, see https://github.com/getsentry/sentry-laravel/blob/master/src/Sentry/Laravel/SentryHandler.php#L23.

We used to have docs for this, looks like they got forgotten about during the last major version migration.

For now, something like https://github.com/Seldaek/monolog#basic-usage should do the trick.

[B-Galati]

Agree. If I am not mistaken, other languages SDK are using logging lib as well.