#Laravel Teams Logging

A Laravel logging channel that sends application log messages directly to Microsoft Teams using an Incoming Webhook.

#Features

• Supports Laravel and Lumen
• Supports all Laravel log levels
• Compatible with Laravel's stack logging channel
• Two message styles:
  • Simple – lightweight notifications
  • Card – rich formatted messages with context
• Application/project name (Optional)

#Installation

Install the package via Composer:

composer require zanysoft/laravel-teams-logging

#Laravel

Register the service provider in config/app.php if required:

ZanySoft\LaravelTeamsLogging\LoggerServiceProvider::class,

Publish the configuration file:

php artisan vendor:publish --provider="ZanySoft\LaravelTeamsLogging\LoggerServiceProvider"

#Lumen

Register the service provider in bootstrap/app.php:

$app->register(
    ZanySoft\LaravelTeamsLogging\LoggerServiceProvider::class
);

Copy the package configuration file to your application's config directory, then enable it in bootstrap/app.php:

$app->configure('teams');

#Configuration

Create a custom logging channel in config/logging.php:

'teams' => [
    'driver' => 'custom',
    'via'    => ZanySoft\LaravelTeamsLogging\LoggerChannel::class,
    'level'  => 'debug',
    'url'    => env('TEAMS_WEBHOOK_URL')
],

#Environment

Add folloing details to your .env file:

• Message title (default value is APP_NAME)
• Message style (default simple).
• Microsoft Teams Incoming Webhook URL

TEAMS_MESSAGE_TITLE=
TEAMS_MESSAGE_STYLE=simple
TEAMS_WEBHOOK_URL=https://...

For instructions on creating an Incoming Webhook, refer to the Microsoft Teams documentation.

#Message Styles

The package supports two message styles:

Simple (Default)

Sends only the log message. (no context)

Log::channel('teams')->error('Something went wrong.');

Card

Displays a rich Teams card containing:

• Log level
• Message
• Timestamp
• Application name
• Additional log context

Log::channel('teams')->error(
    'Unable to process payment.',
    [
        'order_id' => 1452,
        'customer' => 'John Doe',
    ]
);

#Usage

Log a simple message:

Log::channel('teams')->error('Something went wrong.');

Log a message with additional context:

Log::channel('teams')->error(
    'Unable to process payment.',
     [
        'name'  => 'value',
        'order_id' => 1452,
        'amount'   => 49.99,
     ]
);

Note: Log context is only included when using the card style.

#Using the Stack Channel

To automatically send all application logs to Microsoft Teams, add the teams channel to your default logging stack:

'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => [
            'single',
            'teams',
        ],
    ],
],

#Screenshots

Examples of log messages displayed in Microsoft Teams using the card style.

#Debug

#Error

#Warning

#Critical

#License

This package is open-source software licensed under the MIT License.

See the LICENSE file for more information.