@hasna/ logs (中文(简体) )
日志汇总 + 浏览器脚本 + 无头页扫描仪 + AI 代理的性能监测
安装
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.apiKey | baseUrl 选项 |
| 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_KEY | HASNA_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_KEY | CLI / MCP / 国家 @hasna/logs/api | 车队 API 密钥( 证书链的env级) |
HASNA_LOGS_API_URL | CLI / MCP / 国家 @hasna/logs/api | 服务权限; 默认为 https://api.hasna.com/logs |
HASNA_LOGS_API_KEY_OVERRIDE 编号 : HASNA_LOGS_API_KEY_REF 编号 : HASNA_PROFILE | CLI / MCP / SDK | 故意证书指针(第2级) |
HASNA_STATION | CLI / MCP / SDK | macOS 密钥链账户选择器 |
HASNA_HOME 编号 : HASNA_CONFIG_HOME | CLI / 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-serve | API 令牌 /api/* 请求 |
HASNA_LOGS_API_SIGNING_KEY | logs-serve | 为主机签名秘密 /v1 API 密钥 |
HASNA_LOGS_SECRET_KEY (单位:千美元)LOGS_SECRET_KEY(中文(简体) ) | logs-serve | 在休息时加密页面扫描证书 |
HASNA_LOGS_S3_BUCKET | logs-serve | S3 文物上传桶 |
LOGS_PORT 编号 : PORT | logs-serve | 听取端口( 默认3460) |
CLI 使用量
logs --help
logs listlogs taillogs summarylogs pushlogs eventslogs test-reportslogs scanlogs 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 - 见 自由主义