配置 Grafana Pyroscope 数据源
Pyroscope 数据源设置了 Grafana 如何连接到您的 Pyroscope 数据库。
您可以使用 Grafana 中的数据源界面或使用配置文件来配置数据源。本页介绍如何使用 Grafana 设置和启用数据源功能。
如果您进行了任何更改,请选择 Save & test(保存并测试)以保留这些更改。
如果您使用的是自己的 Grafana 安装,则可以使用 YAML 配置文件来供应 Pyroscope 数据源。有关供应和可用配置选项的更多信息,请参阅供应 Grafana。
开始之前
要配置 Pyroscope 数据源,您需要拥有 Grafana 实例的管理权限,以及配置为向 Grafana 发送数据的 Pyroscope 实例。
如果您正在供应 Pyroscope 数据源,那么您还需要托管 Grafana 实例的服务器上的管理权限。
添加或修改数据源
您可以使用这些步骤来配置新的 Pyroscope 数据源或编辑现有数据源。
创建新的数据源
要配置数据源的基本设置,请完成以下步骤
- 在主菜单中选择 Connections(连接)。
- 在搜索栏中输入
Grafana Pyroscope
。 - 选择 Grafana Pyroscope。
- 在页面右上角选择 Add new data source(添加新的数据源)。
- 在 Settings(设置)选项卡上,填写 Name(名称)、Connection(连接)和 Authentication(身份验证)部分。
- 使用 Name(名称)字段指定在面板、查询和 Explore 中使用的数据源名称。切换 Default(默认)开关,使数据源在新面板中预先选择。
- 在 Connection(连接)下,输入 Pyroscope 实例的 URL。例如,
https://example.com:4100
。有关更多信息,请参阅连接 URL。 - 填写Authentication(身份验证)部分。
- 可选:使用 Additional settings(其他设置)配置其他选项。
- 选择 Save & test(保存并测试)。
更新现有数据源
要修改现有的 Pyroscope 数据源
- 在主菜单中选择 Connections(连接)。
- 选择 Data sources(数据源)以查看已配置的数据源列表。
- 选择您希望修改的 Pyroscope 数据源。
- 可选:使用 Additional settings(其他设置)配置或修改其他选项。
- 完成更新后,选择 Save & test(保存并测试)。
连接 URL
数据源连接 URL 应指向正在运行的 Pyroscope 后端的地址。
Grafana Cloud 剖析
您的 Grafana Cloud 实例自动包含一个完全供应的数据源。
如果您正在运行自助管理的 Grafana 实例或需要配置指向 Grafana Cloud 剖析的额外 Pyroscope 数据源,您可以在组织对应的 Manage your stack(管理您的技术栈)部分找到 Pyroscope URL。
自助管理 Pyroscope 后端
自助管理 Pyroscope 后端的连接 URL 取决于 Pyroscope 的部署方式。有关如何配置数据源的更多信息,请参阅在 Grafana 中查询剖析数据 下的步骤。
如果您计划使用剖析钻取 应用,并且您正在微服务模式下运行自助管理 Pyroscope 后端,则数据源连接 URL 应指向将请求路由到相应 Pyroscope 服务的网关或代理。有关具体的路由要求,请参阅Helm ingress 配置。
身份验证
使用此部分选择访问数据源的身份验证方法。
注意
与 Pyroscope 协作时,请使用传输层安全 (TLS) 来增加一层安全性。有关使用 Pyroscope 设置 TLS 加密的更多信息,请参阅Pyroscope 配置。
设置身份验证
从下拉列表中选择一种身份验证方法
- Basic authentication(基本认证):使用用户名和密码验证您的数据源
- Forward OAuth identity(转发 OAuth 身份):将查询用户的 OAuth 访问令牌和 OIDC ID 令牌(如果可用)转发给数据源
- No authentication(无认证):访问数据源无需身份验证
仅针对 Basic authentication(基本认证):输入 User(用户)和 Password(密码)。
可选:填写 TLS settings(TLS 设置)以配置其他安全方法。
- TLS 客户端身份验证
- 开启以使用客户端身份验证。启用后,会添加 Server name(服务器名称)、Client cert(客户端证书)和 Client key(客户端密钥)字段。客户端提供服务器用于验证客户端可信身份的证书。客户端密钥加密客户端和服务器之间的数据。这些详细信息会被加密并存储在 Grafana 数据库中。
- 添加自签名证书
- 启用此选项以使用自签名 TLS 证书。您可以在证书颁发机构生成的证书之上添加自己的证书颁发机构 (CA) 证书,以增强安全性。
- 跳过 TLS 证书验证
- 启用后,将绕过 TLS 证书验证。不建议这样做,除非测试绝对必要。
可选:添加 HTTP Headers(HTTP 头部)。您可以传递有关请求和响应的额外上下文和元数据。选择 Add header(添加头部)以添加 Header(头部)和 Value(值)字段。
选择 Save & test(保存并测试)以保留您的更改。
其他设置
使用向下箭头展开 Additional settings(其他设置)部分以查看这些选项。
高级 HTTP 设置
Grafana 代理会删除转发的 cookie。使用 Allowed cookies(允许的 cookie)字段按名称指定应转发到数据源的 cookie。
Timeout(超时)字段设置 HTTP 请求的超时时间(秒)。
查询
Minimum step(最小步长)用于返回时间序列数据的查询。默认值为 15 秒。
调整此选项有助于防止在放大剖析数据时出现空白。
私有数据源连接
注意
此功能仅在 Grafana Cloud 中可用。
使用私有数据源连接 (PDC) 连接并查询安全网络内的数据,而无需向 Grafana Cloud 开放该网络以接收入站流量。
有关 PDC 工作原理的更多信息,请参阅私有数据源连接;有关设置 PDC 连接的步骤,请参阅配置 Grafana 私有数据源连接 (PDC)。
使用下拉列表选择已配置的私有数据源。如果您进行了更改,请选择 Test & save(测试并保存)以保留更改。
使用 Manage private data source connect(管理私有数据源连接)配置和管理您已配置的任何私有数据源。