2017 © Pedro Peláez
 

library monolog-slack

This package contains handlers/processors for communicating monolog with slack.

image

webthink/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  • Tuesday, June 26, 2018
  • by gmponos
  • Repository
  • 1 Watchers
  • 1 Stars
  • 300 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 6 Versions
  • 0 % Grown

The README.md

Send logs to Slack using Monolog

codecov Build Status SensioLabsInsight MIT licensed, (*1)

Notice I have created another package that contains a collection of Monolog handlers that can send your logs using a PSR-18 clients. The package is monolog-http, (*2)

I will focus my efforts on the package above. If you are using the current package let me know WDYT., (*3)

Give a :star: to monolog-http if you like it., (*4)

Description

This is a package that can help you send logs through monolog to Slack using webhooks. Monolog already has a handler for Slack using Webhooks but I am not in favor of it for these reasons:, (*5)

It has some bugs, (*6)

  • Slack accepts 2000 characters. For more details see. Current package is not able to send more than 2000 characters but it is able to send until 2000 characters and be well formatted.

Flexibility, (*7)

  • The Handler on this package allows you to pass your own PSR-18 client that can be configured in your own way.

Performance, (*8)

  • SlackWebhookHandler does not have timeouts and it executes retries when slack service is down see Because you are allowed to pass your own PSR-18 client you can have it configured in your own way.

Formatting, (*9)

  • Current package gives you the ability to add a custom formatter to the SlackwebhookHandler in order to format Attachments. Monolog allows you to pass a formatter to SlackHandlers but the formatter is applied only to simple messages of slack and they are not applied for Attachments.
  • I have created my own custom formatters. I like the formatting of Slack Records that I have more than the one that monolog has.

Install

You can install this package through composer, (*10)

$ composer require webthink/monolog-slack

Documentation

Simple initialization

You can initialize a SlackWebhookHandler simple with the following lines:, (*11)

$client = new PSR18Client(); // PSR18Client does not exist. Use your own implementation.
$requestFactory = new PSR17RequestFactory(); // PSR18Client does not exist. Use your own implementation.
$handler = new SlackWebhookHandler($client, $requestFactory, 'your_webhook_url');

Formatters

Inject custom formatter

Now if you need to pass a custom slack formatter then you can to do the following:, (*12)

$handler->setFormatter($yourFormatter);, (*13)

  • Note-1: The formatter passed inside the slack handler must be an instance of SlackFormatterInterface.
  • Note-2: If you do not pass a custom Formatter SlackWebhookHandler uses the SlackLineFormatter by default.

SlackLineFormatter

slacklineformatter, (*14)

SlackShortAttachmentFormatter

slackshortattachementformatter, (*15)

SlackLongAttachmentFormatter

slacklongattachementformatter, (*16)

Changelog

Please see CHANGELOG for more information what has changed recently., (*17)

Testing

  1. Run composer install from bash.
  2. Run composer tests from bash.

The Versions

26/06 2018

dev-master

9999999-dev https://github.com/gmponos/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

MIT

The Requires

 

The Development Requires

by George Mponos

26/06 2018

dev-add_clover

dev-add_clover https://github.com/gmponos/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

MIT

The Requires

 

The Development Requires

by George Mponos

26/06 2018

v0.3.0

0.3.0.0 https://github.com/gmponos/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

MIT

The Requires

 

The Development Requires

by George Mponos

26/06 2018

dev-custom_clients

dev-custom_clients https://github.com/gmponos/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

MIT

The Requires

 

The Development Requires

by George Mponos

24/06 2018

v0.2.0

0.2.0.0 https://github.com/webthinkgr/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

MIT

The Requires

 

The Development Requires

by George Mponos

24/03 2018

v0.1.0

0.1.0.0 https://github.com/webthinkgr/monolog-slack

This package contains handlers/processors for communicating monolog with slack.

  Sources   Download

The Requires

 

The Development Requires