README

用于将日志条目发送到 AWS CloudWatch Logs 服务的 PHP 日志库 Monolog 处理器。

在使用此库之前，建议您了解 AWS CloudWatch 服务的 定价。

如果您觉得这个库很有用，请按 ★ 星星 按钮，如果您愿意，也可以 捐赠。

特性

• 最多发送 10000 批量日志，以避免 Rate exceeded 错误
• 使用标签创建日志组
• AWS CloudWatch Logs 人员懒加载
• 适用于Web应用程序以及长期运行的CLI守护程序和工作者
• 兼容PHP 5.6 / 7.0 / 7.1

安装

使用 Composer 安装最新版本

$ composer require maxbanton/cwh:^1.0

升级

修改您的 composer.json

{
  "require": {
    "maxbanton/cwh": "^0.0.3"
  }
}

到

{
  "require": {
    "maxbanton/cwh": "^1.0"
  }
}

然后运行

$ composer update

并更改您的代码

<?php
// Instantiate handler
$handler = new CloudWatch($client, $logGroupName, $logStreamName, $daysToRetention);

到

<?php
// Instantiate handler (tags are optional)
$handler = new CloudWatch($client, $groupName, $streamName, $retentionDays, 10000, ['my-awesome-tag' => 'tag-value']);

基本用法

<?php

use Aws\CloudWatchLogs\CloudWatchLogsClient;
use Maxbanton\Cwh\Handler\CloudWatch;
use Monolog\Logger;

$sdkParams = [
    'region' => 'eu-west-1',
    'version' => 'latest',
    'credentials' => [
        'key' => 'your AWS key',
        'secret' => 'your AWS secret',
        'token' => 'your AWS session token', // token is optional
    ]
];

// Instantiate AWS SDK CloudWatch Logs Client
$client = new CloudWatchLogsClient($sdkParams);

// Log group name, will be created if none
$groupName = 'php-logtest';

// Log stream name, will be created if none
$streamName = 'ec2-instance-1';

// Days to keep logs, 14 by default
$retentionDays = 30;

// Instantiate handler (tags are optional)
$handler = new CloudWatch($client, $groupName, $streamName, $retentionDays, 10000, ['my-awesome-tag' => 'tag-value']);

// Create a log channel
$log = new Logger('name');

// Set handler
$log->pushHandler($handler);

// Add records to the log
$log->debug('Foo');
$log->warning('Bar');
$log->error('Baz');

框架集成

• Silex
• Symfony (示例)
• Lumen
• Laravel

以及其他许多

问题

您可以自由地 报告任何问题

贡献

请查看 此文档

捐赠

如果您愿意，可以将任意数量的BTC发送到钱包 12d3VXfvPiQ5bFMfPppGqpwnNSkZwigBVt