文档 Grafana Pyroscope 查看和分析配置文件数据 配置文件和跟踪 跟踪到配置文件

跟踪到配置文件

使用跟踪到配置文件，您可以通过添加跟踪和配置文件之间链接的功能来利用Grafana关联不同信号的能力。

跟踪到配置文件使您可以将Grafana Pyroscope数据源链接到跟踪数据。配置后，此连接允许您使用探索从跟踪跨度运行查询到配置文件数据。每个跨度都链接到您的查询。单击链接将在拆分面板中运行查询。如果配置了标记，Grafana将动态地将跨度属性值插入到查询中。查询将在（跨度开始时间-60）到（跨度结束时间+60秒）的时间范围内运行。

嵌入式火焰图也插入到具有链接配置文件的每个跨度详细信息部分。这使得您可以在火焰图可视化中查看每个跨度的资源消耗，而无需离开当前视图。

配置跟踪到配置文件功能有两种方法

• 使用基本配置和默认查询，或者
• 配置自定义查询，您可以在其中使用模板语言来从跟踪或跨度中插值变量。

开始之前

跟踪到配置文件需要配置了跟踪到配置文件的 Tempo 数据源和一个 Grafana Pyroscope 数据源。

与跟踪一样，您的应用程序需要被检测以发出配置文件数据。有关更多信息，请参阅 将跟踪和配置文件与跨度配置文件链接。

使用基本配置

要使用基本配置，请按照以下步骤操作

1. 在左侧菜单中，选择 连接 > 数据源。

2. 从 数据源 列表中选择您配置的 Tempo 数据源。

3. 滚动到 跟踪到配置文件 部分。

4. 在 数据源 下拉列表中选择 Pyroscope 数据源。

5. 可选：添加一个或多个用于查询的标签。如果留空，则使用默认值 service.name 和 service.namespace。

   您配置的标签必须存在于跟踪到配置文件跨度的属性或资源中，以便出现跟踪到配置文件的跨度链接。

   您还可以配置标签的新名称。如果标签名称中包含点，并且目标数据源不允许在标签中使用点，则此操作非常有用。在这种情况下，可以将 service.name 重映射到 service_name。

6. 选择用于查询的一个或多个配置文件类型。从下拉列表中选择并从菜单中选择选项。

   必须选择配置文件类型或应用程序，查询才有效。如果查询运行时未选择配置文件类型或应用程序，Grafana 不会显示任何数据。

7. 选择 保存并测试。

如果您已配置 Pyroscope 数据源，但没有配置文件数据可用，或者“此跨度的配置文件”按钮和嵌入的火焰图不可见，请验证是否存在您的跨度标签中的 pyroscope.profile.id 键值对。

配置自定义查询

要使用配置的自定义查询，请按照以下步骤操作

1. 在左侧菜单中，选择 连接 > 数据源。

2. 从 数据源 列表中选择配置的 Tempo 数据源。

3. 滚动到 跟踪到配置文件 部分。

4. 在 数据源 下拉列表中选择 Pyroscope 数据源。

5. 可选：选择用于查询的任何标签。如果留空，则使用默认值 service.name 和 service.namespace。

   这些标签可以用 ${__tags} 变量在自定义查询中使用。此变量将映射的标签作为列表以适当的数据源语法插入。仅包括跨度的标签。未出现的标签将被省略。

   您还可以配置标签的名称。标签名称在标签名称中包含点且目标数据源不允许在标签中使用点时很有用。例如，可以将 service.name 重映射到 service_name。如果您在此处不映射任何标签，您仍然可以在查询中使用任何标签，例如：method="${__span.tags.method}"。有关更多信息，请参阅 自定义查询变量。

6. 选择用于查询的一个或多个配置文件类型。从下拉列表中选择并从菜单中选择选项。

7. 启用 使用自定义查询 以输入自定义查询。

8. 指定用于查询配置文件数据的自定义查询。您可以使用各种变量使该查询与当前跨度相关。仅当所有变量都使用非空值插值时，链接才会显示，以防止创建无效查询。您可以使用 $__tags 关键字插值配置的标签。

9. 选择 保存并测试。

配置选项

以下表格描述了配置您的 跟踪到配置文件 设置的选项