stern-logs

用途：面向智能体/非交互环境，用 stern 读取、过滤和搜索 Kubernetes 多 Pod、多容器日志。核心铁律：每次调用都必须带 --no-follow，否则 stern 会持续流式输出、永不退出，导致工具调用阻塞直到超时，部分输出还可能被丢弃；仅当用户明确要求实时观看且以带停止条件的后台命令运行时例外。还需限制输出量：默认 --since 48h、--tail -1 会乘以所有匹配 Pod，应至少缩小 --tail 或 --since 之一。默认命令形状：stern <query> -n <namespace> --no-follow --tail 50 --since 1h --color never --only-log-lines。选择读取范围：位置参数为 Pod 名正则，或 <resource>/<name> 精确查找（如 deploy/nginx、svc/api），支持 pod、rc、svc、ds、deploy、rs、sts、job 等；可用 -c、-E、--exclude-pod、-l、--field-selector、--node、-n、-A、--container-state terminated、--init-containers=false 等收窄。行过滤用 --include/-i 与 --exclude/-e，它们在格式化前应用，但不会降低读取量。结果解读：空输出不是错误，匹配不到 Pod 时退出码为 0；不同 Pod 的行按到达顺序交错；-t 会把时间戳前缀进 .Message，可能破坏 parseJSON 模板和 -o raw | jq。机器可读输出可用 -o json，管道读取需 set -o pipefail 并配合 --only-log-lines。限制与注意：--no-follow 与 --tail=0 不可同用；崩溃循环 Pod 默认已覆盖，先查 --since/--tail；容器无 ID 会被跳过；宽查询慢多为 client-go 限流（默认 QPS 5、突发 10），可加 --qps=-1 或 --qps 50 --burst 100；日志可能含密钥，应选择性引用；集群上下文与权限需先确认。缺失信息：该技能未提供具体价格、平台支持矩阵或完整安装包说明。