[TOC] **`thanos sidecar` 命令运行一个与 Prometheus 实例一起部署的组件**。这允许 Sidecar 有选择地将指标上传到对象存储，并允许查询者使用通用、高效的 StoreAPI 查询 Prometheus 数据。 详细说明： - 它在 Prometheus 的远程读取 API 之上实现了 Thanos 的 Store API。这允许查询者将 Prometheus 服务器视为时间序列数据的另一个来源，而无需直接与其 API 对话。 - 可选地，边车将 TSDB 块上传到对象存储桶，因为 Prometheus 每 2 小时生成一次。这允许 Prometheus 服务器以相对较低的保留率运行，同时它们的历史数据通过对象存储变得持久和可查询。 > 注意：这仍然不意味着 Prometheus 可以完全无状态，因为如果它崩溃并重新启动，您将丢失大约 2 小时的指标，因此强烈建议 Prometheus 使用永久性磁盘。您可以获得的最接近无状态的是使用远程写入（Thanos 支持，请参阅 Receiver。远程写入还有其他风险和后果，如果崩溃，您仍然会丢失几秒钟的指标数据，因此在所有情况下都建议使用永久性磁盘。 - 可选的，Thanos sidecar 能够监视 Prometheus 规则和配置，如果需要，解压缩和替换环境变量，并 ping Prometheus 以重新加载它们。 通过 sidecar 连接到 Thanos 集群的 Prometheus 服务器受到一些安全操作的限制和建议： - 推荐的 Prometheus 版本为 2.2.1 或更高版本（包括最新版本）。这是由于 Prometheus 在以前的版本中不稳定以及缺少标志端点。 - (!) Prometheus 配置文件的 Prometheus external_labels 部分在整个 Thanos 系统中具有唯一的标签。这些外部标签将被边车使用，然后在许多地方被thanos使用。 - 启用 --web.enable-admin-api 标志以支持 sidecar 从 Prometheus 获取元数据，如外部标签。 - 如果要使用边车重载功能（--reload.* 标志），则启用 --web.enable-lifecycle 标志。 ## 下载thanos ```shell wget https://github.com/thanos-io/thanos/releases/download/v0.28.1/thanos-0.28.1.linux-amd64.tar.gz -O /opt/thanos-0.28.1.linux-amd64.tar.gz cd /opt && tar xf thanos-0.28.1.linux-amd64.tar.gz cp /opt/thanos-0.28.1.linux-amd64/thanos /usr/local/bin ``` ## 创建systemd服务 ```shell cat <<-EOF | sudo tee /usr/lib/systemd/system/thanos-sidecar.service > /dev/null [Unit] Description=thanos-sidecar Documentation=https://thanos.io/ Requires=network.target prometheus.service [Service] Type=simple User=ops Group=ops ExecStart=/usr/local/bin/thanos sidecar \\ --grpc-address=0.0.0.0:10901 --http-address=127.0.0.1:10902 \\ --prometheus.url=http://127.0.0.1:9090 \\ --tsdb.path=/data/prometheus/data --log.format=json ExecReload=/usr/bin/kill -HUP TimeoutStartSec=20s Restart=always [Install] WantedBy=multi-user.target EOF ``` ## 启动服务 ```shell systemctl daemon-reload systemctl enable thanos-sidecar.service --now systemctl is-active thanos-sidecar.service ``` ## 验证 ```shell $ curl localhost:10902/-/healthy && echo OK ``` ## 参考文档 thanos sidecar官方文档：https://thanos.io/tip/components/sidecar.md/