@hasna/logs

中文文档
0.5.1发布于 2026/10/16Apache-2.0TypeScriptES Module近 30 天下载 1.2万

日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测

中文使用文档
文档目录10 节
  1. 安装
  2. 全权证书和授权
  3. 环境
  4. CLI 使用量
  5. MCP 服务器
  6. HTTP 模式
  7. (原始内容存档于2013-10-12) (英语). REST API
  8. PostgreSQL 后端软件
  9. 数据目录
  10. 许可证

@hasna/ logs (中文(简体) )

日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测

npm License

安装

npm install -g @hasna/logs

全权证书和授权

每个主机表面——CLI、MCP服务器和 @hasna/logs/api (原始内容存档于2018-10-11) (英语). SDK - 通过共享解决其 API 密钥和 URL @hasna/contracts 客户端 解析器(hasna/apps#1720),每一次请求都新鲜:

级别证书权力
1. 明确的论点--api-key 编号 : credentials.apiKeybaseUrl 选项
2. 掩体指针HASNA_LOGS_API_KEY_OVERRIDE, (中文(简体) ), HASNA_PROFILE, (中文(简体) ), HASNA_LOGS_API_KEY_REF—— 说
3. macOS 键链hasna.credentials.logs.api-key (账户) HASNA_STATION,则 hostname -s,则 USER(中文(简体) )hasna.credentials.logs.api-url
4. 磁盘0400编号 :0600(中文(简体) )~/.hasna/logs/config/credentials (单位:千美元)HASNA_HOME 编号 : HASNA_CONFIG_HOME 移动根; XDG 从未被咨询)同一文件
5. 环境HASNA_LOGS_API_KEYHASNA_LOGS_API_URL

没有配置 URL 权限默认为车队网关 https://api.hasna.com/logs (客户端附件) /v1)——单是钥匙就是 完整配置 。 无前缀的遗产 LOGS_API_URL 编号 : LOGS_API_KEY 名字只能作为解析器的无声化名被接受 释放并永远不超越峡谷 HASNA_LOGS_* 双人 已退休投入 (单位:千美元)~/.hasna/fleet-env遗产 ~/.hasna cloud 编号 : config 点点, $XDG_CONFIG_HOME, (中文(简体) ), ~/.logs/config.json)从未读过,没有 *_MODE 编号 : *_STORAGE_MODE 变量选择任何东西.

Hosted 模式失败 . 一个没有可解决证书的数据平面命令 以一行可操作线退出非零线 — 没有 SQLite 倒置, 没有本地倒置 活动。 深思熟虑的、不能遵守的等级HASNA_PROFILE 名称 a 没有密钥的配置文件,或 a HASNA_LOGS_API_KEY_REF 保险库指针此进程 ——而且 logs-mcp 启动时拒绝 : initialize 在stdio上回答,和 在可流- HTTP 收听器之前(--http约束其港口。 纸箱 SQLite 仓库(~/.hasna/logs/logs.db只能通过明确 选入 :

export HASNA_LOGS_LOCAL=1   # alias: LOGS_LOCAL=1

...一跑在地面上印出一个 local 线条在stderr上——它永远不会 默然无声. 检查哪个运输和源头能解决:

logs transport          # e.g. transport: http, source: default, api_key_tier: keychain
logs transport --json

服务logs-serve)遵循同一规则: HASNA_LOGS_DATABASE_URL 选择 PostgreSQL 支持的机队 API( 由 * 销售的储存工具箱, HASNA_LOGS_LOCAL=1 选择框上的 SQLite 收集器(带有 local 线条在 stderr 上,没有配置 无 SQLite 启动的非零.

环境

变量表面目的
HASNA_LOGS_API_KEYCLI / MCP / 国家 @hasna/logs/api车队 API 密钥( 证书链的env级)
HASNA_LOGS_API_URLCLI / MCP / 国家 @hasna/logs/api服务权限; 默认为 https://api.hasna.com/logs
HASNA_LOGS_API_KEY_OVERRIDE 编号 : HASNA_LOGS_API_KEY_REF 编号 : HASNA_PROFILECLI / MCP / SDK故意证书指针(第2级)
HASNA_STATIONCLI / MCP / SDKmacOS 密钥链账户选择器
HASNA_HOME 编号 : HASNA_CONFIG_HOMECLI / MCP / SDK移动磁盘证书/配置根
HASNA_LOGS_LOCAL (单位:千美元)LOGS_LOCAL(中文(简体) )CLI / MCP / 国家 logs-serve明确选入盒式 SQLite 商店/收藏器
HASNA_LOGS_DATABASE_URL (单位:千美元)LOGS_DATABASE_URL(中文(简体) )logs-serve, (中文(简体) ), logs db migrate/status主机服务 PostgreSQL 连接 URL
HASNA_LOGS_DATA_DIR 编号 : HASNA_LOGS_DB_PATH本地存储装入框的 SQLite 位置( 默认) $HASNA_HOME/logs/logs.db,也就是说. ~/.hasna/logs/logs.db· ; HASNA_HOME 用配置移动数据)
HASNA_LOGS_API_TOKEN (单位:千美元)LOGS_API_TOKEN(中文(简体) )logs-serveAPI 令牌 /api/* 请求
HASNA_LOGS_API_SIGNING_KEYlogs-serve为主机签名秘密 /v1 API 密钥
HASNA_LOGS_SECRET_KEY (单位:千美元)LOGS_SECRET_KEY(中文(简体) )logs-serve在休息时加密页面扫描证书
HASNA_LOGS_S3_BUCKETlogs-serveS3 文物上传桶
LOGS_PORT 编号 : PORTlogs-serve听取端口( 默认3460)

CLI 使用量

logs --help
  • logs list
  • logs tail
  • logs summary
  • logs push
  • logs events
  • logs test-reports
  • logs scan
  • logs diagnose

logs list 默认为有边框的紧凑身份预览: 25行、 信件和 服务预览,可逆的 JSON- 字符串- 逃避日志ID logs get <id>, (中文(简体) ), 和32KB输出上限。 当更多的行还剩,页脚报告a 暂存 next_offset; 递回来 --offset启用 --limit 财务报告和审定财务报表 --max-bytes 调谐紧凑 页 次, --format table 用于遗留的终端列,或 --format json 页:1 明确完整的记录。 多层次主机过滤器扫描限定的服务器页面 --offset 总是数到匹配行, 继续页脚保留 真实的,即使不匹配的行 在下一场比赛之前.

实例:

logs list
logs list --text timeout --limit 25
logs list --offset 25 --max-bytes 32768
logs get <id>
logs list --format json --limit 25

MCP 服务器

logs-mcp

包括日志搜索、原始事件搜索/观察/导出、预测测试报告搜索/获取、存储同步、扫描、发行和性能工具.

HTTP 模式

运行一个共享的可流式HTTP MCP服务器( 只127. 0.0.1 个) :

logs-mcp --http               # default port 8864
logs-mcp --http --port 8864
MCP_HTTP=1 logs-mcp
  • 卫生: GET http://127.0.0.1:8864/health
  • 磁共振: POST http://127.0.0.1:8864/mcp

没有时, Stdio 仍然是默认 --http 国旗通过.

(原始内容存档于2013-10-12) (英语). REST API

HASNA_LOGS_DATABASE_URL=postgres://… logs-serve     # PostgreSQL-backed fleet API
HASNA_LOGS_LOCAL=1 logs-serve --local-open          # on-box SQLite collector (says "local" on stderr)

默认情况下, API 被锁定, 除非配置或信任 API 令牌 循环模式被明确启用 :

HASNA_LOGS_API_TOKEN="$(openssl rand -hex 32)" logs-serve
# or, for local-only development:
HASNA_LOGS_LOCAL=1 logs-serve --local-open

使用 Authorization: Bearer <token> 或者说 X-Logs-Token: <token> 页:1 /api/* 请求。 浏览器 ingest 令牌仍然为浏览器设定范围只写令牌 抓取并且不批准一般API访问.

在休息时用本地生成的页扫描仪证书加密 page-auth.key 在日志数据目录下。 需要部署人员 管理机密, 设置 HASNA_LOGS_SECRET_KEY 或者说 LOGS_SECRET_KEY数字 :

export HASNA_LOGS_SECRET_KEY="$(openssl rand -hex 32)"

PostgreSQL 后端软件

主机服务直接读写PostgreSQL(包括AWS RDS). 配置 HASNA_LOGS_DATABASE_URL (或 LOGS_DATABASE_URL 然后 应用计划并检查:

logs db migrate            # apply cloud migrations (schema + api_keys)
logs db status

MCP 服务器在 HTTP 传输上曝光同一事件/日志数据平面 当证书解析时——任何客户端上都没有DSN,也没有存储 在数据平面中同步 .

LOGS_DATABASE_URL 被接受为一个非哈斯纳倒置数据库 URL 释放.

数据目录

本地模式数据( E)logs.db、原始事件段和持久性 agent-registry.db 当地 logs-mcp)存储于 ~/.hasna/logs/ —— 说 $HASNA_HOME/logs/ 何时 HASNA_HOME 替换 ~/.hasna 根,或 HASNA_LOGS_DATA_DIR 当设置。 它只是根据明令创造的 HASNA_LOGS_LOCAL=1 选入: 主机 logs 编号 : logs-mcp 编号 : @hasna/logs/sdk 进程未打开 SQLite 文件( 主机) logs-mcp 保持其代理登记册 内存,每个过程,及其工具描述都这么说).

许可证

Apache-2.0 - 见 自由主义

版本与发布记录

@hasna/logs 共发布 48 个版本,首次发布于 2026/03/17;过去 12 个月发布了 48 个版本。

版本发布日期距今
0.5.1latest2026/10/161 个月前
0.5.02026/09/072 个月前
0.4.82026/08/212 个月前
0.4.52026/07/243 个月前
0.4.42026/07/094 个月前
0.4.32026/07/084 个月前

关于 @hasna/logs 的常见问题

@hasna/logs 是什么?

日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测

如何安装 @hasna/logs?

在项目目录运行 npm install @hasna/logs,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 logs、logs-mcp、logs-serve,可以用 npx logs 直接运行。

@hasna/logs 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@hasna/logs 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@hasna/logs 可以商用吗?

@hasna/logs 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@hasna/logs 的下载量有多少?

根据 npm 官方下载统计,@hasna/logs 在 2026/10/18 – 2026/11/16 这 30 天内被下载 12,037 次,日均约 401 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@hasna/logs 还在维护吗?

最新版本 0.5.1 发布于 2026/10/16(1 个月前);至今共发布 48 个版本,其中过去 12 个月发布了 48 个;首次发布于 2026/03/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。