Laravel5.6の新機能でエラーをslackに送信

こんにちは。フリーランス・コンサルタント＆エンジニアの九保すこひです。

X（Twitter）やってます！
九保すこひ＠フリーランスエンジニア｜累計300万PVのブログ運営中

数日前、Laravel5.6がリリースされたので、新機能のログ（エラー）をslackに送信するという機能を試してみました。

この機能を使えば、公開したサイトにエラーが発生したら、slackで通知を受けることができるようになります。ユーザーからの不具合情報を待たなくとも修正すべき箇所を知ることができるんで、サイト運営には重宝しそうですね。

では、手順を見ていきましょう。

1 １．slackのウェブフックを取得する
2 ２．ウェブフックURLを書き込む
3 ３．logging.phpで設定
4 ４．テストのエラー送信
5 ちなみに

１．slackのウェブフックを取得する

エラーログをslackに送信するためには、WebHook（ウェブフック）と呼ばれる投稿用URLを取得する必要があります。以下のリンクから取得しておきましょう。

Incoming WebHooks

アクセスしたら、Add Configurationをクリック。

投稿したいチャンネルを選択し、Add Incoming WebHooks intragrationをクリック。

ウェブフックURLが作成されるので、これをコピーしましょう。

２．ウェブフックURLを書き込む

Laravelの.envに以下のように書き込みます。

LOG_CHANNEL=slack
LOG_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/*******/*******/**************

※注：今回は説明のため、LOG_CHANNELもstackからslackに変更しています。

３．logging.phpで設定

slackへのテスト投稿を楽にするために、/config/logging.phpでslackのエラーレベルを下げます。

'slack' => [
    'driver' => 'slack',
    'url' => env('LOG_SLACK_WEBHOOK_URL'),
    'username' => 'Laravel Log',
    'emoji' => ':boom:',
    'level' => 'debug',
],

※デフォルトではemergencyです。

４．テストのエラー送信

さぁ、これで準備は整いました。
無理やりエラーを発生させてslackへログをテスト投稿させてみましょう！

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HomeController extends Controller
{
    public function logging_slack() {

        \Log::notice('slackにテスト通知！');
        echo $test; // 変数を宣言してないんで、ここでエラー発生

    }
}

まず、Log::notice();の部分はエラーが発生する最低レベルです。
他にも以下のようなものがあるので、どの程度のエラーが発生したら通知をしたいかを自由に決めることができます。

Log::emergency($message);
Log::alert($message);
Log::critical($message);
Log::error($message);
Log::warning($message);
Log::notice($message);
Log::info($message);
Log::debug($message);

そして、テスト実行したらこのようなメッセージがslackに投稿されますよ！