README

AWS Cloudwatch Logs的Yii2日志目标。

安装和配置

通过composer安装包

composer require codemonauts/yii2-cloudwatch-logs

然后将其添加到应用程序配置中

<?php
return [
    // ...
    'components' => [
        // ...
        'log' => [
            'targets' => [
                [
                    'class' => \codemonauts\cloudwatchlogs\Target::class,
                    'region' => 'eu-west-1',
                    'logGroup' => '/webserver/production/my-craft',
                    'logStream' => 'instance-1', // omit for automatic instance ID
                    'levels' => ['error', 'warning', 'info', 'trace', 'profile'],
                    'logVars' => ['_GET', '_POST', '_FILES', '_COOKIE', '_SESSION', '_SERVER'],
                    'key' => 'your-key', // omit for instance role
                    'launch' => 'go', // skip to not start
                    'secret' => 'your-secret', // omit for instance role
                ],
                // ...
            ],
        ],

配置选项

• (string) $region (必需) AWS区域的名称，例如eu-west-1
• (string) $logGroup (必需) 日志组的名称。
• (string) $launch (必需) 指定是否启动。
• (string) $logStream (可选) 日志流的名称。如果省略，它将尝试确定运行在上的EC2实例的ID。
• (array) $levels (可选) 日志级别。默认为Yii2：['error', 'warning', 'info', 'trace', 'profile']
• (array) $logVars (可选) 要记录的变量。默认为Yii2：['_GET', '_POST', '_FILES', '_COOKIE', '_SESSION', '_SERVER']
• (string) $key (可选) 您的AWS访问密钥。
• (string) $secret (可选) 您的AWS密钥。

速率限制

Cloudwatch Logs API需要发送一个序列令牌与消息到日志流的。此令牌在将消息传输到日志流后返回，用于下一次传输。对于多进程系统，这很困难处理。

因此，AWS Cloudwatch Logs不支持同时向同一日志流写入多个进程。他们的官方方法是为每个实例上的每个进程创建一个单独的日志流。但是，考虑到PHP-FPM在多个实例上的动态子进程。这会导致一段时间后在日志组中留下数千个废弃的日志流。空日志流不会被自动删除并保留在日志组中。它们不收费，但使日志组非常混乱。

我们的方法是每个实例只创建一个日志流。为了能够同时从多个进程发送日志流，必须在每次传输之前查询日志流的当前序列令牌。但是，AWS Cloudwatch Log API对此类请求的速率限制为每秒60个请求。

为了避免遇到此速率限制，强烈建议只将那些很少发生且重要的事件直接发送到Cloudwatch Logs。例如警告和错误。

在大型基础设施中，有许多同时运行的进程且日志负载很高的情况下，仍然最好使用文件日志和Cloudwatch Log代理，因为这仅是一个单进程。

也许将来会有所改变。

Cloudwatch Logs Insights

如果您想使用Insights解析日志，可以这样做

fields @timestamp, @message
| sort @timestamp desc
| limit 20
| parse '[*][*][*][*][*] *' as ip, userId, sessionId, logLevel, category, message