2026-03-27 14:10:58 网络安全文章来源：ZONE.CI 全球网 0 阅读模式

文章总结： 本文介绍开源工具HiClawLogSearch，专为企业级AIAgent协作平台设计，旨在解决微服务架构下多组件日志排查效率低下的问题。该工具提供WebUI界面，支持12加组件日志的一站式查询、级别过滤、关键词搜索及自动刷新。后端基于Node.js零依赖实现，前端采用TailwindCSS，部署简便且提供RESTAPI。文章给出了详细的部署配置步骤，适合运维与开发人员用于提升日志分析与故障定位效率。 综合评分： 74 文章分类： 安全工具,安全运营,解决方案,产品介绍

cover_image

HiClaw Log Search: 一站式系统日志查询利器

Nil Nil

爱唠叨的Nil

2026年3月24日 23:04 江苏

HiClaw Log Search: 一站式系统日志查询利器

在复杂的微服务架构中，日志排查是开发和运维工作中最耗时的环节之一。当系统出现异常，我们需要在多个组件、多个日志文件之间来回切换，效率极低。

今天给大家介绍一个开源工具——HiClaw Log Search，专为 HiClaw 系统设计的日志查询服务，让你轻松掌控 12+ 组件的日志流。

项目背景

HiClaw 是一个企业级 AI Agent 协作平台，由 Manager 容器和多个 Worker 容器构成。系统运行时会产生大量分散的日志：

• Higress 网关日志

• Matrix 服务器日志

• MinIO 存储日志

• Manager Agent 日志

• 各类 Worker 日志

传统的日志查看方式需要 SSH 到服务器，手动 tail -f 多个文件，既繁琐又低效。

HiClaw Log Search 应运而生——一个轻量级的 Web UI，让日志查询变得简单高效。

核心功能

🔍 多组件日志查询

支持 12+ 个系统组件，一站式查看所有日志：

🎨 日志级别过滤

快速定位问题，支持按级别筛选：

• ERROR – 错误日志，优先排查

• WARN – 警告日志，潜在问题

• INFO – 信息日志，运行状态

• DEBUG – 调试日志，详细信息

🔎 关键词搜索

实时搜索日志内容，快速定位关键信息：

• 搜索错误关键词：timeout、failed、exception

• 搜索请求 ID：追踪完整请求链路

• 搜索时间戳：定位特定时间段的日志

🔄 自动刷新

3 秒自动刷新，实时监控日志流，无需手动刷新页面。

🌙 深色主题

专为开发者设计的深色 UI，长时间查看不伤眼。

技术亮点

零依赖后端

后端使用 Node.js 原生 HTTP 模块，无需安装任何 npm 依赖：

// 启动服务 node server.js

启动速度快，资源占用低，适合在生产环境长期运行。

响应式前端

前端使用 HTML + Tailwind CSS 构建：

• 响应式布局，适配各种屏幕

• 深色主题，护眼设计

• 流畅的交互体验

网关集成

支持 Nginx 和 Higress 网关路由：

http://:18080/log-search/

可无缝集成到现有的 HiClaw 管理界面。

快速部署

1. 克隆项目

git clone https://github.com/nillikechatchat/hiclaw-log-search.git cd hiclaw-log-search

2. 安装服务

./scripts/install.sh /opt/log-search

3. 配置 Nginx

cp skill/nginx.conf /etc/nginx/conf.d/log-search.conf nginx -s reload

4. 配置 Higress 路由（可选）

./scripts/setup-higress.sh

5. 访问界面

打开浏览器访问：

http://:18080/log-search/

REST API

除了 Web UI，还提供 REST API 供程序调用：

健康检查

GET /log-search/api/health

响应: {“status”: “ok”, “time”: “2024-03-24T14:00:00.000Z”}

获取组件列表

GET /log-search/api/components

响应: {“components”: […]}

查询日志

GET /log-search/api/logs?component=higress-gateway&lines=200&level=ERROR&search=timeout

参数说明：

• component – 组件 ID（必填）

• lines – 返回行数（默认 200，最大 1000）

• level – 日志级别过滤

• search – 关键词搜索

自定义配置

日志文件路径可在 skill/server.js 中修改：

const COMPONENTS = { “higress-gateway”: { name: “Higress Gateway”, file: “/var/log/hiclaw/higress-gateway.log” }, // 添加你的自定义组件… };

开源信息

• GitHub : https://github.com/nillikechatchat/hiclaw-log-search

• License : MIT

• 技术栈 : Node.js + HTML + Tailwind CSS

总结

HiClaw Log Search 是一个轻量、实用的日志查询工具，主要特点：

✅ 支持 12+ 组件日志查询 ✅ 日志级别快速过滤 ✅ 关键词实时搜索 ✅ 3 秒自动刷新 ✅ 深色主题护眼 UI ✅ 零依赖，启动快

如果你也在使用 HiClaw 或类似的微服务架构，不妨试试这个工具，让日志排查变得更高效！

欢迎 Star ⭐ 和 PR！

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：爱唠叨的Nil Nil Nil《HiClaw Log Search: 一站式系统日志查询利器》