dneey / laravel-cloudwatch

快速将云监控日志添加到您的 Laravel 应用程序中。

v1.1.0 2022-01-21 19:46 UTC

This package is auto-updated.

Last update: 2024-09-22 01:16:28 UTC


README

在 Laravel 中实现 maxbanton AWS handler for monolog

要求

  • PHP ^7.2.0
  • Laravel ^6.0

功能

  • 每个日志记录中都包含传入的请求参数。
  • 每个日志记录中都包含一个 requestId,以缩小搜索结果到特定请求的生命周期。

安装

使用 Composer 安装最新版本,运行

$ composer require dneey/laravel-cloudwatch

基本用法

将以下内容添加到应用程序的 .env 文件中,并使用您正确的 AWS 凭据。

LOG_CHANNEL=cloudwatch

AWS_ACCESS_KEY_ID=aws-key
AWS_SECRET_ACCESS_KEY=aws-secret
AWS_DEFAULT_REGION=aws-region

就这么简单!

Log::info('You are now logging to cloudwatch');

额外配置

  • 您可以在 .env 文件中配置您的云监控 log group namestream name。如果未设置,则使用 APP_NAME 的值作为日志组名称,使用 APP_NAMEAPP_ENV 的值作为日志流名称。
AWS_CLOUD_WATCH_GROUP_NAME=project-name
AWS_CLOUD_WATCH_STREAM_NAME=project-name-env
  • 设置日志级别,例如 INFO、CRITICAL、DEBUG、API 等。
AWS_CLOUD_WATCH_LEVEL=INFO
  • 设置云监控的日志保留期(以天为单位)。默认为 14 天。
AWS_CLOUD_WATCH_RETENTION_DAYS=14
  • 默认情况下,所有请求参数都将记录,除了密码和密码确认。要更改此设置,请在 .env 文件中将 LOG_REQUEST_PARAMS 设置为 false。
LOG_REQUEST_PARAMS=false
  • 您可以通过在 .env 文件中添加 LOG_REQUESTS_EXCEPT 条目来忽略任何请求参数。值应包含逗号分隔的应从日志中排除的字段字符串。
LOG_REQUESTS_EXCEPT="password, password_confirmation, image"

示例

Log::info('Awesome! You are now logging to cloudwatch from Laravel.');

AWS

有关 AWS IAM 和策略示例,请访问 maxbanton AWS handler for monolog。