datalust/seqcli

Seq CLI 镜像文档

镜像概述

该镜像包含Seq命令行客户端（seqcli），用于与Seq日志聚合服务器进行交互。Seq是一款功能强大的日志聚合与分析工具，本镜像提供了轻量级的命令行界面，支持通过容器环境便捷地执行日志记录、查询、服务器管理等操作，简化与Seq服务器的集成流程。

核心功能与特性

• 日志记录：通过命令行向Seq服务器发送日志事件，支持自定义消息、属性和级别
• 日志查询：查询Seq服务器中存储的日志数据，支持过滤、排序和格式化输出
• 服务器管理：执行Seq服务器的基本管理操作，如查看状态、管理用户和配置
• 容器化集成：适合在Docker环境中使用，可轻松集成到CI/CD流程或自动化脚本

支持的标签

• latest：最新发布的镜像版本，包含最新功能更新和问题修复

使用场景

• 容器应用日志：在Docker化应用中，通过命令行将应用日志发送至Seq服务器
• 自动化运维：在Shell脚本或自动化工具中，查询Seq日志进行问题诊断和监控
• 服务器管理：通过命令行远程管理Seq服务器，执行配置调整和状态检查

使用方法与示例

基本使用格式

bash
docker run [选项] datalust/seqcli:latest [seqcli命令] [命令参数]

连接Seq服务器

容器需能够访问目标Seq服务器，可通过以下方式配置网络：

• 使用主机网络（适用于本地Seq服务器）：--net host
• 指定自定义网络：--network <网络名称>并通过容器名或IP访问服务器

示例：记录日志事件到本地Seq服务器

向运行在localhost:5341的Seq服务器发送一条日志事件：

bash
docker run --rm --net host docker.xuanyuan.run/datalust/seqcli:latest log -m "Hello from seqcli" -s http://localhost:5341

参数说明：

• --rm：容器执行完成后自动删除，避免残留容器
• --net host：使用主机网络栈，确保容器能访问本地Seq服务器
• log：seqcli核心命令，用于记录日志事件
• -m "Hello from seqcli"：指定日志事件的消息内容
• -s http://localhost:5341：指定Seq服务器的访问地址（需替换为实际服务器地址）

其他常用命令

• 查询日志：docker run --rm --net host datalust/seqcli:latest query "select * from stream limit 10" -s http://localhost:5341
• 查看服务器状态：docker run --rm --net host datalust/seqcli:latest server status -s http://localhost:5341

认证配置

若Seq服务器启用认证，需通过-a或--api-key参数提供API密钥：

bash
docker run --rm --net host docker.xuanyuan.run/datalust/seqcli:latest log -m "Authenticated log" -s http://localhost:5341 -a <your-api-key>