zt-zlp-cli 0.0.2

ZLP CLI

zt-zlp-cli

ZLP 日志管理平台 命令行工具，用于登录并查询实例、库、表结构与 SQL 结果。

环境要求

• Python >=3.10
• 可用浏览器（首次登录会自动打开）

安装

开发安装（源码）

pip install -e .

打包发布

python -m pip install --upgrade build twine
python -m build
twine upload dist/*

快速开始

1) 登录并缓存 Cookie

首次运行会打开浏览器，请完成登录。成功后会缓存 Cookie 到本地。

zt-zlp-cli login

2) 获取系统列表

zt-zlp-cli discover systems

3) 获取服务列表

zt-zlp-cli discover services --system LMS --log-type json

4) 获取表结构

zt-zlp-cli discover fields \
  --log-type json \
  --system LMS \
  --service fbu-lms-tracking-outgoing-pro-json \
  --start-time "2026-04-14 20:18:22" \
  --end-time "2026-04-14 20:33:22" \
  --query-statement ""

5) 日志搜索

zt-zlp-cli discover logs \
  --system LMS \
  --service fbu-lms-labelservice-pro-json \
  --log-type json \
  --custom-sql "select topic,ClientIp,PrintMethod from \$table limit 10" \
  --query-statement "SiteName = 'CN'" \
  --start-time "2026-04-12 00:00:00" \
  --end-time "2026-04-14 23:59:59"

全局参数

• -o, --output：输出格式，支持：
  • json（默认）
  • human（表格）

示例：

zt-zlp-cli -o human sql instances

配置说明

默认配置目录：~/.zt-zlp-cli

• Cookie 缓存：~/.zt-zlp-cli/cookies.json
• 配置文件：~/.zt-zlp-cli/config.yaml

环境变量（可选）

支持通过环境变量自动填充登录页账号密码（如 SSO 页面字段可用）：

• ZT_SSO_USERNAME
• ZT_SSO_PASSWORD

未设置时可在浏览器中手动完成登录。