极其简单的集中式日志。

v0.3.4 2024-03-05 07:33 UTC

This package is not auto-updated.

Last update: 2024-09-17 10:09:11 UTC


README

Pile

极其简单的集中式日志。

安装

您可以使用 composer 安装 Pile。

php composer.phar create-project bloatless/pile [my-pile-instance-name]
  • 将您的虚拟主机文档根目录指向 public 目录,并将 ald 请求重写为 index.php 文件。
  • 确保 logs 文件夹可写。
  • 使用 db_stucture.sql 文件创建一个新的 MySQL 数据库。
  • 调整 config/config.php 文件中的数据库配置、API 密钥和用户帐户。

文档

日志消息结构

要发送到 Pile API 的日志消息的一般结构应如下所示

¹ = 字段是必需的

日志级别

有效的日志级别代码如下

将日志发送到您的 Pile 实例

使用 HTTP REST API

您可以使用简单的 POST 请求将日志消息发送到您的 Pile 实例

POST https://pile.yourdomain.com/api/v1/log
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
X-API-Key: 123123123

{
    "data": {
        "type": "log",
        "attributes": {
            "source": "MyProjectName",
            "message": "Some error occoured",
            "context": {
                "exception": {
                    "class": "My\\Fancy\\Classname",
                    "message": "Invalid value",
                    "code": "42",
                    "file": "\/framework\/src\/Foo\/Bar\/Classname.php:1337"
                }
            },
            "level": 400,
            "level_name": "ERROR",
            "channel": "dev",
            "datetime": "2019-11-05 17:44:26",
            "extra": []
        }
    }
} 

请确保在请求头中包含 API 密钥。

使用 Monolog 处理器

如果您在项目中使用 Monolog,您还可以使用 MonoPile 包,它为 Monolog 提供了一个处理程序和格式化程序,以便轻松将错误日志发送到您的 Pile 实例。

许可证

MIT