ChrisLOG 是一个轻量级日志聚合与实时查看工具。它可以接收 HTTP、Syslog、GELF 等来源的日志，把日志保存到内置 SQLite 数据库中，并通过 Web 页面提供实时查看、搜索、筛选和清理能力。 它适合用来临时排查服务问题、集中查看多台设备或应用的日志、验证日志推送配置，以及在没有 Elasticsearch、Kafka、Loki 等复杂组件时快速搭建一个小型日志查看入口。 ## 主要功能 - 实时日志查看：新日志写入后会自动出现在 Web 页面中。 - 多来源接入：支持 HTTP JSON、Syslog UDP、Syslog TCP、GELF UDP。 - 搜索与筛选：支持关键词、正则、日志级别、来源、标签、时间范围筛选。 - 本地持久化：日志保存在 SQLite 数据库中，应用重启后不会丢失。 - 自动保留策略：默认保留 30 天日志，可通过环境变量调整。 ## 页面怎么用 进入 Web 页面后，可以看到日志列表和顶部工具栏。 常用操作： - 搜索框：输入关键词搜索日志内容。 - `search`：执行搜索。 - `pause`：暂停或恢复实时刷新。 - `clear`：清空当前数据库中的日志。 - `level`：按日志级别筛选，例如 `info`、`warning`、`error`。 - `source`：按来源筛选，例如 `http`、`syslog`、`gelf`。 - `tag`：按应用或组件标签筛选。 - `from` / `to`：按时间范围筛选。 点击某一行日志，可以展开查看原始日志内容和更多字段。 ## 通过 HTTP 推送日志 HTTP 是最容易接入的方式。向应用域名的 `/api/ingest` 发送 JSON 即可写入日志。 示例： ```bash curl -X POST https://你的应用域名/api/ingest \ -H "Content-Type: application/json" \ -d '{ "host": "web01", "level": "error", "tag": "nginx", "message": "upstream connection failed" }' ``` 常用字段： | 字段 | 必填 | 说明 | | --- | --- | --- | | `message` | 是 | 日志正文。也可使用 `msg` 或 `short_message`。 | | `host` | 否 | 日志来源主机。也可使用 `hostname`。 | | `level` | 否 | 日志级别，例如 `info`、`warning`、`error`。也可使用 `severity`。 | | `tag` | 否 | 应用、服务或组件名称。也可使用 `app`、`application`。 | | `facility` | 否 | Syslog facility。 | | `timestamp` | 否 | Unix 时间戳，支持秒或毫秒。为空时使用接收时间。 | 写入成功会返回： ```json {"ok":true} ``` ## 通过 Syslog 接入 ChrisLOG 支持 Syslog UDP 和 TCP，端口均为 `514`。 在 Linux/macOS 上可以用 `logger` 测试 UDP： ```bash logger -n 你的应用域名 -P 514 --udp "hello from syslog" ``` TCP 测试可以使用 `nc`： ```bash echo "<14>$(date '+%b %d %H:%M:%S') web01 app: hello from syslog tcp" \ | nc 你的应用域名 514 ``` 接入后，在页面中可以把 `source` 筛选为 `syslog` 查看相关日志。