> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 仪表盘模板

> 在 ClickStack 中导入预置的仪表盘模板

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

ClickStack 包含一个预置的仪表盘模板库，可让您立即了解常见的基础设施和应用程序指标。

<div id="browsing-templates">
  ## 浏览可用模板
</div>

要浏览内置模板库，请进入 **仪表盘**，然后点击 **浏览仪表盘模板**。

<Image img="https://mintcdn.com/private-7c7dfe99/0q34g_AjISMsyr4Q/images/use-cases/observability/browse-dashboard-template.webp?fit=max&auto=format&n=0q34g_AjISMsyr4Q&q=85&s=a979efc63c67dfbb58eef59862898ccd" alt="浏览仪表盘模板按钮" size="lg" width="1462" height="489" data-path="images/use-cases/observability/browse-dashboard-template.webp" />

这会打开模板库，模板按类别分类显示。点击 **Import** 即可开始导入该模板。

<Image img="https://mintcdn.com/private-7c7dfe99/0q34g_AjISMsyr4Q/images/use-cases/observability/dashboard-template-gallery.webp?fit=max&auto=format&n=0q34g_AjISMsyr4Q&q=85&s=ffb7c80946bda2ef1cfe6947befd721d" alt="仪表盘模板库" size="lg" width="1209" height="600" data-path="images/use-cases/observability/dashboard-template-gallery.webp" />

<div id="importing-a-template">
  ## 导入模板
</div>

要导入模板，必须为仪表盘中的每个可视化项设置数据源。请在每个可视化项的下拉菜单中选择一个数据源，然后点击 `Finish Import`。

<Image img="https://mintcdn.com/private-7c7dfe99/xE8TEsdF6028Tf3x/images/use-cases/observability/import-dashboard-template.webp?fit=max&auto=format&n=xE8TEsdF6028Tf3x&q=85&s=1f57f2d2599eec404d252972ebf02126" alt="仪表盘模板导入" size="lg" width="1210" height="892" data-path="images/use-cases/observability/import-dashboard-template.webp" />

<div id="pre-built-templates">
  ## 预置模板
</div>

<div id="otel-runtime-metrics">
  ### OTel 运行时指标
</div>

内置的 OTel Runtime Metrics 模板专为已接入 [OpenTelemetry 运行时指标](https://opentelemetry.io/docs/specs/semconv/runtime/) 的应用设计。

| 模板                          | 说明                                     |
| --------------------------- | -------------------------------------- |
| **.NET Runtime Metrics**    | .NET 应用的 GC 回收、堆大小、线程池使用情况和程序集数量       |
| **Go Runtime Metrics**      | Go 应用的 Goroutine 数量、GC 暂停时间、堆使用情况和内存统计 |
| **JVM Runtime Metrics**     | 基于 JVM 的应用的堆内存与非堆内存、GC 耗时、线程数量和类加载情况   |
| **Node.js Runtime Metrics** | Node.js 应用的事件循环延迟、堆使用情况、CPU 利用率和 V8 内存 |

说明：

* 每个模板都配置了一个[自定义过滤器](/docs/zh/clickstack/features/dashboards/overview#custom-filters)，用于筛选 [`telemetry.sdk.language`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/telemetry/#telemetry-sdk-language) 资源属性与仪表盘运行时相匹配的服务。
  * 如果环境使用了自定义的 ClickHouse 指标表 schema，可能需要调整此过滤器，以查询正确的 Service Name 和 Resource Attributes 列。
  * 对于高吞吐环境，可通过对 `ResourceAttributes['telemetry.sdk.language']` 列进行[物化](/docs/zh/clickstack/managing/performance-tuning#materialize-frequently-queried-attributes)来缩短过滤器加载时间。
* 模板在发布时会引用最新的 OTel Semantic Conventions，并会随着 OTel Spec 的更新定期同步更新。对于使用较旧的 OTel SDKs 进行埋点的服务，可能需要[编辑](/docs/zh/clickstack/features/dashboards/overview#dashboards-editing-visualizations) 可视化内容，以引用旧版指标名称。