> ## 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.

# 대시보드 Template

> ClickStack에서 사전 구축된 대시보드 Template 가져오기

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에는 일반적인 인프라 및 애플리케이션 메트릭을 즉시 파악할 수 있는 사전 구축된 대시보드 Template 라이브러리가 포함되어 있습니다.

<div id="browsing-templates">
  ## 사용 가능한 Template 찾아보기
</div>

기본 제공 Template 라이브러리를 찾아보려면 **대시보드**로 이동한 후 **대시보드 Template 찾아보기**를 클릭합니다.

<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="대시보드 Template 찾아보기 버튼" size="lg" width="1462" height="489" data-path="images/use-cases/observability/browse-dashboard-template.webp" />

그러면 Template 갤러리가 열리며, Template이 카테고리별로 정리되어 있습니다. 해당 Template의 가져오기를 시작하려면 **가져오기**를 클릭합니다.

<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="대시보드 Template 갤러리" size="lg" width="1209" height="600" data-path="images/use-cases/observability/dashboard-template-gallery.webp" />

<div id="importing-a-template">
  ## Template 가져오기
</div>

Template을 가져오려면 각 대시보드 시각화마다 데이터 소스를 설정해야 합니다. 각 시각화의 드롭다운에서 데이터 소스를 선택한 다음 `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="대시보드 Template 가져오기" size="lg" width="1210" height="892" data-path="images/use-cases/observability/import-dashboard-template.webp" />

<div id="pre-built-templates">
  ## 사전 구축된 Template
</div>

<div id="otel-runtime-metrics">
  ### OTel 런타임 메트릭
</div>

기본 제공되는 OTel Runtime Metrics Template은 [OpenTelemetry 런타임 메트릭](https://opentelemetry.io/docs/specs/semconv/runtime/)으로 계측된 애플리케이션용으로 설계되었습니다.

| Template                    | Description                                        |
| --------------------------- | -------------------------------------------------- |
| **.NET Runtime Metrics**    | .NET 애플리케이션의 GC 횟수, 힙 크기, 스레드 풀 사용량, 어셈블리 수        |
| **Go Runtime Metrics**      | Go 애플리케이션의 고루틴 수, GC 일시 중지 시간, 힙 사용량, 메모리 통계       |
| **JVM Runtime Metrics**     | JVM 기반 애플리케이션의 힙 및 비힙 메모리, GC 소요 시간, 스레드 수, 클래스 로딩 |
| **Node.js Runtime Metrics** | Node.js 애플리케이션의 이벤트 루프 지연, 힙 사용량, CPU 사용률, V8 메모리  |

참고:

* 각 Template에는 대시보드의 런타임과 일치하는 [`telemetry.sdk.language`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/telemetry/#telemetry-sdk-language) 리소스 속성을 가진 서비스에 대한 [사용자 지정 필터](/docs/ko/clickstack/features/dashboards/overview#custom-filters)가 구성되어 있습니다.
  * 사용자 지정 ClickHouse 메트릭 테이블 스키마를 사용하는 환경에서는 올바른 Service Name 및 리소스 속성 컬럼을 쿼리하도록 이 필터를 조정해야 할 수 있습니다.
  * 대용량 환경에서는 `ResourceAttributes['telemetry.sdk.language']` 컬럼을 [구체화](/docs/ko/clickstack/managing/performance-tuning#materialize-frequently-queried-attributes)하여 필터 로드 시간을 줄일 수 있습니다.
* Template은 게시 시점의 최신 OTel Semantic Conventions를 참조하며, OTel Spec이 업데이트되면 이에 맞춰 주기적으로 업데이트됩니다. 이전 OTel SDK로 계측된 서비스의 경우 이전 메트릭 이름을 참조하도록 시각화를 [편집](/docs/ko/clickstack/features/dashboards/overview#dashboards-editing-visualizations)해야 할 수 있습니다.
