Notification channels

namespace App\Telemetry;

use Cbox\TelemetryInsights\Contracts\NotifiesChannel;
use Cbox\TelemetryInsights\Notify\Notification;

final readonly class PagerChannel implements NotifiesChannel
{
    public function send(Notification $notification): bool
    {
        // … deliver it …

        return true;
    }
}

Register it by name:

// config/telemetry-insights.php
'notify' => [
    'default' => ['slack', 'pager'],
    'channels' => [
        'log' => \Cbox\TelemetryInsights\Notify\LogChannel::class,
        'slack' => \Cbox\TelemetryInsights\Notify\SlackChannel::class,
        'webhook' => \Cbox\TelemetryInsights\Notify\WebhookChannel::class,
        'pager' => \App\Telemetry\PagerChannel::class,
    ],
],

Channels are resolved from the container, so constructor injection works.

The contract

A channel must not throw. Delivery is best-effort: a finding that reached three of four channels still reached someone, and a channel that raised an exception would take down the pass that produced the finding. Return false instead, and log if it is worth knowing about.

What a notification carries

toText() renders the whole thing as plain text for channels with no formatting at all.