README

Laravel服务器与应用健康监控和通知器

这个分支为主包添加了哪些功能？

这个主包的分支添加了使用带有bearer令牌的http路由的能力。在你的Http.yml或Https.yml文件中，使用以下约定

targets:
  - default:
      urls:
        - '{{ config("app.url") }}'
        - http://google.com
        - http://some-route.with/v2/bearer/token/needed {token}

就这样。

安装

composer require majidalaeinia/health:dev-master

将以下行添加到config/app.php文件的providers数组中

/*
 * Package Service Providers...
 */
MajidAlaeinia\Health\ServiceProvider::class,

此包检查应用程序资源是否按预期运行，并创建一个服务状态面板。它具有以下主要特点

• 高度可扩展和可配置：您可以非常容易地创建新的检查器和通知器，并且可以几乎更改它的一切。
• 易于配置：使用YAML作为配置文件
• 弹性资源检查器：如果框架正在运行并且至少有一个通知渠道，您应该会收到通知消息。
• 内置通知系统：通过邮件、Slack、Telegram或其他任何您需要的任何方式接收通知。
• 路由：面板、JSON结果、字符串结果和资源。
• 可配置面板设计。
• 缓存。
• 安排检查，以便在服务失败时自动接收通知。
• 在面板中直接查看应用程序错误消息。
• 对于如Envoyer等服务，错误时返回HTTP响应代码200和500，以跟踪您的应用程序健康状况。

内置资源

Health为以下服务预先配置了资源检查器

• AppKey
• 广播
• 缓存
• 配置缓存
• 数据库
• 调试模式
• 目录权限
• 磁盘空间
• DocuSign
• ElasticsearchConnectable
• EnvExists
• 文件系统
• 框架
• Horizon
• Http
• Https
• LaravelServices
• 延迟
• 本地存储
• 邮件
• MailgunConnectable
• MemcachedConnectable
• 迁移已更新
• MySql
• MySqlConnectable
• NewrelicDeamon
• NginxServer
• 包已更新
• Php
• PostgreSqlConnectable
• PostgreSqlServer
• 队列
• 队列工作者
• 需要重启
• Redis
• RedisConnectable
• RedisServer
• 路由缓存
• S3
• 安全检查器
• 服务器负载
• 服务器运行时间
• Sshd
• Supervisor

但是，您可以添加任何其他您需要的，您只需找到正确的检查器来使用或为您的资源创建一个新的检查器。

易于配置

创建新的资源监控很容易，只需在应用程序的config/health文件夹中创建一个新的YAML文件即可。以下是一些示例

Amazon S3

name: S3
abbreviation: s3
checker: PragmaRX\Health\Checkers\CloudStorageChecker
notify: true
driver: s3
file: pragmarx-health-s3-testfile.txt
contents: {{ str_random(32) }}
error_message: 'Amazon S3 connection is failing.'
column_size: 4

Nginx

name: NginxServer
abbreviation: ngnxsrvr
checker: PragmaRX\Health\Checkers\ProcessChecker
command: 'pgrep %s'
method: process_count
process_name: nginx
instances:
    minimum:
        count: 4
        message: 'Process "%s" has not enough instances running: it has %s, when should have at least %s'
    maximum:
        count: 8
        message: 'Process "%s" exceeded the maximum number of running instances: it has %s, when should have at most %s'
notify: true
pid_file_missing_error_message: 'Process ID file is missing: %s.'
pid_file_missing_not_locked: 'Process ID file is not being used by any process: %s.'
column_size: 4

屏幕截图

面板

面板的替代设计

如果您有很多服务要检查，您可以更改默认的面板设计以节省空间

4列布局的面板

错误消息

将鼠标悬停在失败的资源上，即可立即访问错误消息

单击资源按钮，您将收到一个显示错误消息的警报

Slack通知

以下是通过Slack发送的通知示例

Artisan控制台命令

health:panel

使用命令health:panel在控制台中查看服务的状态。

health:check

使用命令health:check检查所有资源，并在失败时发送通知。

路由

安装后，您将有权访问以下路由

/health/panel

主要面板路由。

/health/check

返回包含包了解您服务的所有内容的JSON。

/health/string

返回所有服务的状态字符串，在与其他监控服务配合使用时非常有用

hlthFAIL-dbFAIL-filesystemOK-frmwrkOK-httpOK-httpsOK-mailOK

/health/resource/{name}

返回关于特定服务的json信息

要求

• PHP 7.1+
• Laravel 5.6+

安装

使用Composer进行安装

composer require majidalaeinia/health:dev-master

在Laravel上安装

将服务提供者添加到你的 config/app.php

MajidAlaeinia\Health\ServiceProvider::class,

发布配置和视图

php artisan vendor:publish --provider="MajidAlaeinia\Health\ServiceProvider"

点击健康面板

http://yourdomain.com/health/panel

配置所有功能

本包中几乎所有功能都易于配置

• 面板名称
• 标题和消息
• 资源检查器
• Slack图标
• 通知渠道
• 模板位置
• 路由和前缀
• 邮件服务器
• 缓存
• 调度器

配置二进制文件

一些检查器需要你配置正确的二进制路径，以便检查器能够正常工作

'services' => [
    'ping' => [
        'bin' => env('HEALTH_PING_BIN', '/sbin/ping'),
    ],

    'composer' => [
        'bin' => env('HEALTH_COMPOSER_BIN', 'composer'),
    ],
],

允许Slack通知

要通过Slack接收通知，你必须设置入站Webhooks并将此方法添加到你的用户模型中，并包含你的webhook

/**
 * Route notifications for the Slack channel.
 *
 * @return string
 */
public function routeNotificationForSlack()
{
    return config('services.slack.webhook_url');
}

缓存

当健康结果被缓存时，你可以通过在URL中添加?flush=true来刷新缓存，使其再次处理所有资源

http://yourdomain.com/health/panel?flush=true

事件

如果你更喜欢构建自己的通知系统，你可以禁用它并监听以下事件

PragmaRX\Health\Events\RaiseHealthIssue::class

广播检查器

广播检查器通过ping和pong系统完成。广播检查器将ping你的服务，它必须pong回。基本上你需要做的就是调用一个包含数据的URL

Redis + Socket.io

var request = require('request');
var server = require('http').Server();
var io = require('socket.io')(server);
var Redis = require('ioredis');
var redis = new Redis();

redis.subscribe('pragmarx-health-broadcasting-channel');

redis.on('message', function (channel, message) {
    message = JSON.parse(message);

    if (message.event == 'PragmaRX\\Health\\Events\\HealthPing') {
        request.get(message.data.callbackUrl + '?data=' + JSON.stringify(message.data));
    }
});

server.listen(3000);

Pusher

<!DOCTYPE html>
<html>
    <head>
        <title>Pusher Test</title>
        <script src="https://js.pusher.com/3.2/pusher.min.js"></script>
        <script>
            var pusher = new Pusher('YOUR-PUSHER-KEY', {
                encrypted: true
            });

            var channel = pusher.subscribe('pragmarx-health-broadcasting-channel');

            channel.bind('PragmaRX\\Health\\Events\\HealthPing', function(data) {
                var request = (new XMLHttpRequest());

                request.open("GET", data.callbackUrl + '?data=' + JSON.stringify(data));

                request.send();
            });
        </script>
    </head>

    <body>
        Pusher waiting for events...
    </body>
</html>

程序化检查资源

$generalHealthState = app('pragmarx.health')->checkResources();

// or 

$databaseHealthy = app('pragmarx.health')->checkResource('database')->isHealthy();

在 artisan 命令示例中检查

Artisan::command('database:health', function () {
    app('pragmarx.health')->checkResource('database')->isHealthy()
        ? $this->info('database is healthy')
        : $this->info('database is in trouble')
    ;
})->describe('Check database health');

Lumen

要在Lumen上使用它，你可能需要在你的 bootstrap/app.php 中做一些类似以下的事情

$app->instance('path.config', app()->basePath() . DIRECTORY_SEPARATOR . 'config');
$app->instance('path.storage', app()->basePath() . DIRECTORY_SEPARATOR . 'storage');

$app->withFacades();

$app->singleton('Illuminate\Contracts\Routing\ResponseFactory', function ($app) {
    return new \Illuminate\Routing\ResponseFactory(
        $app['Illuminate\Contracts\View\Factory'],
        $app['Illuminate\Routing\Redirector']
    );
});

$app->register(PragmaRX\Health\ServiceProvider::class);

测试

$ composer test

作者

Antonio Carlos Ribeiro

许可证

Health是在BSD 3-Clause许可证下授权的 - 有关详细信息，请参阅LICENSE文件

贡献

欢迎提交拉取请求和问题。