volcengine-tls-logcollector

用途

本技能用于火山引擎 TLS LogCollector 的日志采集任务，覆盖从设计、验证、部署到变更和排查的完整流程。它把 volcengine-tls 作为通用 CLI 操作模型，把本技能作为 LogCollector 专用工作流。

技能首先要求对请求分类，常见路径包括：

如果用户只要求计划或命令，不应改动远端资源；如果用户要求执行，应先展示解析后的目标和计划写入，验证后再执行已授权的变更。

技能采用契约优先工作流：

运行 volclog --profile <profile> doctor，仅在需要实时连通性检查时加 --online。
用 volclog tool list <group> 发现确切动作。
用 volclog tool describe <group.action> --view full 读取每个选定契约。
在持久化非平凡解析器、路径提取、时间戳、索引分隔符或处理器配置前，阅读 references/config-validation.md 并验证代表性样本。
需要变更 Project、Topic、主机组、采集规则、索引或绑定时，阅读 references/tls-resources.md。
写操作先加 --dry-run；dry-run 只验证本地请求形态，不证明服务端会接受或解析语义正确。
执行一次已授权写入；写入结果不明确时，用读操作核对，不要盲目重试。
安装场景按环境阅读对应参考：references/linux-host.md、references/kubernetes-daemonset.md、references/kubernetes-controller.md。
阅读 references/verification.md，验证进程或工作负载健康、机器心跳、规则绑定和 Topic 写入。

命令示例保留上游原生 volclog ... 形式，实际运行时改为 ve volclog ...（需要 ve >= 1.1.11），后续参数保持不变。

以当前 tool describe 输出为准，确定动作 ID、字段、枚举值和必填属性；参考中的示例只是起点，不是冻结的 API 契约。
主机文件输入只用于主机路径，容器 stdout 输入只用于 stdout/stderr，容器文件输入只用于容器内文件；不要混用不兼容的 Paths 与 ContainerRule 形态。
选择最窄的稳定路径和 Kubernetes 过滤条件；绝不创建可能意外采集整个集群的空容器过滤。
除非用户或现有部署明确要求 IP 匹配，否则使用 Label 主机组；安装的标签与主机组的 HostIdentifier 必须一致；同一 agent 上不要同时配置标签和 IP 身份。
仅在按精确名称或精确 ID 核对后复用现有资源；多个候选匹配时停止并请用户选择。
不要为分片数、保留期、索引设置、资源名称、路径、正则、时区或解析键编造生产值。
不要自动采集 LogCollector 自身日志；仅当用户明确要求临时端到端测试并接受反馈循环风险时，才允许自日志 POC，并定义清理步骤、观察两个短窗口。
安装成功不等于采集成功；进程或 Pod 健康、机器心跳、规则绑定和真实 Topic 写入是相互独立的验收关卡。

适用于在 Linux 主机或 Kubernetes 上规划、部署和运维火山引擎 TLS LogCollector 采集，包括资源与规则配置、DaemonSet 或 Controller/CRD 安装、以及心跳、绑定、解析和写入问题的排查。

出现以下情况应停止并报告确切阶段：

报告应包含：选定的运行时、目标环境和资源 ID 或精确名称；采集来源与解析策略；运行的验证动作及结果；计划与已完成的写入（区分 dry-run 与真实执行）；部署命令及每条命令的运行位置；进程或 Pod 健康、心跳、绑定和 Topic 写入的验证证据；任何临时 POC 资源的清理步骤。

不要在聊天中请求或回显凭据值；不要把 AK/SK 放入技能文件、仓库、生成的清单或 shell 历史。