文档 Grafana Alloy 参考 命令行界面 tools

tools 命令

tools 命令包含按 Alloy 组件分组的命令行工具。

子命令

prometheus.remote_write sample-stats

shell 复制

alloy tools prometheus.remote_write sample-stats [<FLAG> ...] <WAL_DIRECTORY>

替换以下内容

• <FLAG>：一个或多个定义命令输入和输出的标志。
• <WAL_DIRECTORY>：WAL 目录。

sample-stats 命令读取由 <WAL_DIRECTORY> 指定的预写日志 (WAL)，并收集其中的指标样本信息。

对于每个发现的指标，sample-stats 会输出：

• 该指标收到的最旧样本的时间戳。
• 该指标收到的最新样本的时间戳。
• 该指标发现的样本总数。

默认情况下，sample-stats 返回 WAL 中所有指标的信息。您可以传递 --selector 标志来过滤报告的指标，只显示一部分。

支持以下标志：

• --selector：用于过滤数据的 PromQL 标签选择器。（默认为 {}）

prometheus.remote_write target-stats

shell 复制

alloy tools prometheus.remote_write target-stats --job JOB --instance INSTANCE WAL_DIRECTORY

target-stats 命令读取由 WAL_DIRECTORY 指定的预写日志 (WAL)，并收集特定目标的指标基数信息。

对于由 --job 和 --instance 标志指定的目标，会打印该目标的唯一指标名称以及具有该指标名称的系列数。

支持以下标志：

• --job：目标的 job 标签。
• --instance：目标的 instance 标签。

--job 和 --instance 标签是必需的。

prometheus.remote_write wal-stats

shell 复制

alloy tools prometheus.remote_write wal-stats <WAL_DIRECTORY>

替换以下内容

• <WAL_DIRECTORY>：WAL 目录。

wal-stats 命令读取由 <WAL_DIRECTORY> 指定的预写日志 (WAL)，并收集其一般信息。

报告以下信息：

• WAL 中最旧样本的时间戳。
• WAL 中最新样本的时间戳。
• WAL 中定义的唯一系列总数。
• WAL 中的样本总数。
• 检测到的哈希冲突数量（如有）。
• WAL 中无效记录的总数（如有）。
• 最近的 WAL checkpoint 段号。
• WAL 中最旧的段号。
• WAL 中最新的段号。

此外，wal-stats 会报告每个目标的信息，其中目标被定义为 job 和 instance 标签值的唯一组合。对于每个目标，wal-stats 会报告与该目标关联的系列数和指标样本数。

wal-stats 命令不支持任何标志。