菜单
开源

关于 Pyroscope 配置

您可以使用基于 YAML 的配置文件或 CLI(命令行界面)标志来配置 Grafana Pyroscope。应优先使用配置文件,而非 CLI 标志。配置文件中的每个参数都可以通过相应的 CLI 标志进行设置。如果同时指定 CLI 标志和配置参数,CLI 标志将优先于配置文件中的对应值。您可以使用 -config.file CLI 标志来指定配置文件。

要查看 Pyroscope 入门所需的 CLI 标志,请运行 pyroscope -help 命令。

要查看任何组件的当前配置状态,请使用 /api/v1/status/config HTTP API 端点。

操作注意事项

您应使用一个单一的配置文件,并将其传递给 Pyroscope 的所有副本(如果您运行多个单进程 Pyroscope 副本)或 Pyroscope 的所有组件(如果您将 Pyroscope 作为微服务运行)。如果您在 Kubernetes 上运行 Pyroscope,可以通过将配置文件存储在 ConfigMap 中并将其挂载到每个 Pyroscope 容器来实现这一点。

这有助于避免一个常见的配置陷阱:某些配置参数看起来可能只需要一种类型的组件,但实际上它们可能被多个组件使用。例如,-distributor.replication-factor CLI 标志不仅被 Ingester 需要,也被 Distributor 和 Querier 需要。

通过使用单一配置文件,您可以确保每个组件都能获得所需的全部配置,而无需追踪哪个参数属于哪个组件。将特定于一个组件(例如 Ingester)的配置传递给另一个组件(例如 Querier)不会有任何问题。在这种情况下,该配置会被忽略。

如有必要,您可以使用高级 CLI 标志来覆盖特定 Pyroscope 组件或副本上的特定值。这有助于在不重新启动所有其他组件的情况下更改特定于某个组件的参数。

CLI 标志最常见的用例是使用 -target 标志将 Pyroscope 作为微服务运行。通过设置 -target CLI 标志,所有 Pyroscope 组件共享同一个配置文件,但您可以通过指定命令行值(例如 -target=ingester-target=querier)使它们作为给定的组件运行。