buexplain/alarm

这个是一个基于hyperf的告警组件

v2.1.1 2021-11-18 10:20 UTC

This package is auto-updated.

Last update: 2021-11-18 10:30:20 UTC


README

这个是一个基于hyperf的告警组件。

支持发送告警到钉钉群机器人和企业微信群机器人。

大概的告警流程是:

  1. 创建自定义告警进程
  2. worker进程与task进程通过日志组件发送日志到告警进程,该日志包含告警组件的配置文件的handler信息
  3. 告警进程接收到日志后,解析其中的告警组件的handler信息,然后循环丢给每一个handler进行处理

安装

下载包 composer require buexplain/alarm

发布告警组件的配置 php bin/hyperf.php vendor:publish buexplain/alarm

NOTE: 告警机器人地址的获取,请前往相关网站了解,申请成功后,请手动修改此配置文件。 目前钉钉群机器人和企业微信群机器人的发送频率限制皆为每分钟20条。 为避免触发对方接口的限流警告,本组件限制为单个机器人每分钟18条,可以配置多个机器人,缓解大量发送的需求。

修改日志配置文件 config/autoload/logger.php

<?php

declare(strict_types=1);

use Monolog\Logger;
use Monolog\Formatter\LineFormatter;
use Monolog\Handler\RotatingFileHandler;

return [
    'default' => [
        'handlers'=>[
            //默认的文件日志处理器
            [
                'class' => RotatingFileHandler::class,
                'constructor' => [
                    'filename' => BASE_PATH . '/runtime/logs/hyperf.log',
                    'level'=>Logger::ERROR,
                ],
                'formatter' => [
                    'class' => LineFormatter::class,
                    'constructor' => [
                        'format' => null,
                        'dateFormat' => null,
                        'allowInlineLineBreaks' => true,
                    ],
                ],
            ],
            //告警日志处理器
            [
                'class' => \Alarm\Handler::class,
                'constructor' => [
                    //此处的handler对应的正是config/autoload/alarm.php配置的key值
                    'handlers'=>[
                        'dingTalk',
                        'weChat',
                    ],
                    //接收的日志级别
                    'level'=>\Monolog\Logger::ERROR,
                ],
            ],
        ],
    ],
];

NOTE:

  1. 如果配置文件logger.php存在,则直接在需要告警的日志渠道上添加告警日志处理器,否则请先安装日志组件
  2. 如果配置文件signal.php存在,则需要配置\Alarm\Signal\AlarmStopHandler::class => PHP_INT_MAX
  3. 必须在协程环境下使用
  4. 不支持协程风格的服务器

使用

$logger = \Hyperf\Utils\ApplicationContext::getContainer()->get(\Hyperf\Logger\LoggerFactory::class)->get();
//at群内用户需要提供手机号
$logger->error('at一个用户', ['@'=>'135xxxxxxx1']);
$logger->error('at两个用户', ['@'=>['135xxxxxxx1', '135xxxxxxx2']]);
$logger->error('at所有人', ['@'=>'all']);

License

Apache-2.0