在 Laravel 中使用 Slack 进行异常通知

0

异常处理是软件开发过程中无法逃避的问题。对于一套设计良好代码高效的程序,出现异常的可能性会比较低,但这并不意味着不会出现异常,有些异常甚至会引起严重的后果,所以如何及时的发现程序中的异常并处理它便显得十分重要了。

通常,我们可以依靠用户反馈、经常查看程序日志来发现程序存在的问题。但这要么不可靠要么不及时,所以下面我们介绍一种比较有效的做法--使用 Slack 通知程序跑出的异常信息。

Slack 是一款即时通信软件,类似于 QQ,它提供开放的 API,可以调用它向自己团队中指定的个人或者频道(Channel)发送消息,因此用它来进行异常通知是再合适不过的。

  1. 安装 maknz/slack-laravel

    具体的安装方法请参考 Github 上的 [readme](https://github.com/maknz/slack-laravel)。
    
  2. 配置

    安装完成后使用 php artisan vendor:publish 生成 config\slack.php 配置文件,然后在.env文件中添加如下三项配置值.
    
    ```
    SLACK_ENDPOINT=//slack 终端,即 slack 接口地址
    SLACK_CHANNEL=//消息默认接收频道
    SLACK_USERNAME//消息默认接收人
    ```
    > 当然,也可以直接直接在 config\slack.php 对应配置的默认值而不使用 .env,但并不推荐这样做。
    
    > 根据实际需要设置 SLACK_CHANNEL 和 SLACK_USERNAME ,二者并不是必须的
    
  3. 调整 AppExceptionsHandler 类的 report 方法,实现 Slack 通知异常信息的逻辑。代码如下:

    /**
     * Report or log an exception.
     *
     * This is a great spot to send exceptions to Sentry, Bugsnag, etc.
     *
     * @param  \Exception  $e
     * @return void
     */
    public function report(Exception $e)
    {
    if ($this->shouldReport($e)) {
        $slackMessage = "\n[Error.{$e->getCode()}] {$e->getMessage()}";
        $slackMessage.= "\n[Line.{$e->getLine()}] {$e->getFile()}";
        $slackMessage.= "\n[Time] ".date('Y-m-d H:i:s');
    
        try {
            Slack::to(config('slack.channel'))->send($slackMessage);
        } catch (\Exception $eOther) {
            \Log::info($slackMessage);
        }
    }
    
    return parent::report($e);
    }
对于一些可能频繁出现但又不致命的异常,例如404 NotFoundHttpException,我们可能并不想让程序通知它。为此,我们只需要在 Aop\Exceptions\Handler 类里的 $dontReort 属性中加入指定的异常的类型就可以了。
    protected $dontReport = [
        NotFoundHttpException::class,
        // ...
    ];

示例中展示的是对指定的频道(channel)发送信息,当然你还可以向指定的人发送,或者其它更复杂的用法。不过要注意指定的用户名和频道是自己 slack 团队中已经存在的,不然会出错。

这样,当程序中出现异常时,运维能在第一时间收到相关的通知信息,方便及时处理了。


如果觉得我的文章对你有用,请随意赞赏

你可能感兴趣的

DeniseDie · 2018年06月11日

Laravel 5.4 後移除了 $this->app->share ,需改成以下內容才不會報錯: PHP Fatal error: Call to undefined method IlluminateFoundationApplication::share() ...

vendor/maknz/slack/src/SlackServiceProviderLaravel5.php
vendor/maknz/slack-laravel/src/ServiceProviderLaravel5.php

public function register()
{

$this->mergeConfigFrom(__DIR__ . '/config/config.php', 'slack');

$this->app->singleton('maknz.slack', function ($app) {
    return new Client(
        $app['config']->get('slack.endpoint'),
        [
            'channel' => $app['config']->get('slack.channel'),
            'username' => $app['config']->get('slack.username'),
            'icon' => $app['config']->get('slack.icon'),
            'link_names' => $app['config']->get('slack.link_names'),
            'unfurl_links' => $app['config']->get('slack.unfurl_links'),
            'unfurl_media' => $app['config']->get('slack.unfurl_media'),
            'allow_markdown' => $app['config']->get('slack.allow_markdown'),
            'markdown_in_attachments' => $app['config']->get('slack.markdown_in_attachments'),
        ],
        new Guzzle
    );
});

$this->app->bind('Maknz\Slack\Client', 'maknz.slack');

}

回复

0

一年前写的了,当时还用着 5.2。不过还是非常感谢指出,另外现在自己改用 BearyChat 了,感觉更适合国内的网络情况……

田较瘦 作者 · 2018年06月11日
载入中...