> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickStack을 사용한 시각화 및 대시보드

> ClickStack을 사용한 시각화 및 대시보드

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

ClickStack는 이벤트 시각화를 지원하며, ClickStack UI(HyperDX)에서 차트를 기본적으로 만들 수 있습니다. 이러한 차트는 다른 사용자와 공유할 수 있도록 대시보드에 추가할 수 있습니다.

시각화는 트레이스, 메트릭, 로그 또는 사용자가 정의한 wide 이벤트 스키마에서 생성할 수 있습니다.

<div id="creating-visualizations">
  ## 시각화 만들기
</div>

HyperDX의 **Chart Explorer** 인터페이스를 사용하면 시간 흐름에 따른 메트릭, 트레이스, 로그를 시각화할 수 있어 데이터 분석용 시각화를 빠르게 만들 수 있습니다. 이 인터페이스는 대시보드를 만들 때도 재사용됩니다. 다음 섹션에서는 Chart Explorer를 사용해 시각화를 만드는 과정을 설명합니다.

각 시각화는 **데이터 소스(data source)** 선택으로 시작한 뒤 **메트릭**을 고르고, 필요에 따라 **필터 표현식(filter expressions)** 및 **group by** 필드를 지정하는 방식으로 구성됩니다. 개념적으로 HyperDX의 시각화는 내부적으로 SQL `GROUP BY` 쿼리에 대응합니다. 즉, 선택한 차원에 대해 집계할 메트릭을 정의합니다.

<Tip>
  **AI 기반 차트 생성**

  ClickStack은 [text-to-chart](/ko/clickstack/text-to-chart) 기능을 사용해 자연어 프롬프트로 차트를 생성하는 것도 지원합니다. 보고 싶은 내용을 설명하면 ClickStack이 시각화를 자동으로 생성합니다.
</Tip>

예를 들어, 서비스 이름별로 그룹화한 오류 수(`count()`)를 차트로 표시할 수 있습니다.

아래 예시에서는 [sql.clickhouse.com](https://sql.clickhouse.com)에서 제공하는 원격 데이터셋을 사용하며, 이에 대한 설명은 가이드 ["원격 데모 데이터세트"](/ko/clickstack/example-datasets/remote-demo-data)에 나와 있습니다. **또한 [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com)에 접속해 이 예시를 그대로 재현할 수도 있습니다.**

<Steps>
  <Step>
    ### Chart Explorer로 이동

    왼쪽 메뉴에서 `Chart Explorer`를 선택합니다.

    <Image img="https://mintlify.s3.us-west-1.amazonaws.com/private-7c7dfe99-mintlify-8c05c8a2/images/use-cases/observability/clickstack-visualization-1.png" alt="Chart Explorer" size="lg" />
  </Step>

  <Step>
    ### 시각화 만들기

    아래 예시에서는 서비스 이름별로 시간에 따른 평균 요청 지속 시간을 차트로 표시합니다. 이를 위해서는 메트릭, 컬럼(SQL 표현식일 수 있음), 집계 필드를 지정해야 합니다.

    상단 메뉴에서 `Line/Bar` 시각화 유형을 선택한 다음 `Traces` 데이터셋(`Demo Traces`는 [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com)을 사용하는 경우)을 선택합니다. 다음 값을 입력합니다:

    * Metric: `Average`
    * Column: `Duration/1000`
    * Where: `<empty>`
    * Group By: `ServiceName`
    * Alias: `Average Time`

    <Image img="https://mintlify.s3.us-west-1.amazonaws.com/private-7c7dfe99-mintlify-8c05c8a2/images/use-cases/observability/clickstack-visualization-2.png" alt="단순 시각화" size="lg" />

    이벤트는 SQL `WHERE` 절 또는 Lucene 구문으로 필터링할 수 있으며, 이벤트를 시각화할 시간 범위도 설정할 수 있습니다. 여러 시리즈도 지원됩니다.

    예를 들어, 필터 `ServiceName:"frontend"`를 추가해 `frontend` 서비스만 필터링할 수 있습니다. `Add Series`를 클릭해 별칭을 `Count`로 지정한 두 번째 시리즈를 추가하면 시간에 따른 이벤트 수도 함께 표시할 수 있습니다.

    <Image img="https://mintlify.s3.us-west-1.amazonaws.com/private-7c7dfe99-mintlify-8c05c8a2/images/use-cases/observability/clickstack-visualization-3.png" alt="단순 시각화 2" size="lg" />

    기존 시리즈와 비슷한 시리즈를 만들려면 처음부터 새로 만드는 대신 복제할 수 있습니다. 시리즈 행의 복사 아이콘(`Duplicate series`)을 클릭하면 바로 아래에 복사본이 삽입됩니다. 복사본은 메트릭, 컬럼, 필터 등 원본 시리즈의 설정을 유지합니다. 이후 달라지는 필드만 변경하고(예: 집계) 복사본에 별도의 별칭을 지정하면 됩니다. 복제 기능은 여러 시리즈를 지원하는 모든 곳에서 사용할 수 있습니다. `Number`, `Pie`, `Heatmap`처럼 하나의 시리즈만 허용하는 시각화 유형에서는 이 기능이 표시되지 않습니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-duplicate-series.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=a05175b4a73d78ea4f07f3a9a615796e" alt="차트 시리즈 행의 Duplicate series 복사 아이콘과 해당 툴팁" size="lg" width="3348" height="322" data-path="images/use-cases/observability/clickstack-duplicate-series.png" />

    기존 시리즈와 비슷한 시리즈를 만들려면 처음부터 새로 만드는 대신 복제할 수 있습니다. 시리즈 행의 복사 아이콘(`Duplicate series`)을 클릭하면 바로 아래에 복사본이 삽입됩니다. 복사본은 메트릭, 컬럼, 필터 등 원본 시리즈의 설정을 유지합니다. 이후 달라지는 필드만 변경하고(예: 집계) 복사본에 별도의 별칭을 지정하면 됩니다. 복제 기능은 여러 시리즈를 지원하는 모든 곳에서 사용할 수 있습니다. `Number`, `Pie`, `Heatmap`처럼 하나의 시리즈만 허용하는 시각화 유형에서는 이 기능이 표시되지 않습니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-duplicate-series.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=a05175b4a73d78ea4f07f3a9a615796e" alt="차트 시리즈 행의 Duplicate series 복사 아이콘과 해당 툴팁" size="lg" width="3348" height="322" data-path="images/use-cases/observability/clickstack-duplicate-series.png" />

    <Note>
      시각화는 메트릭, 트레이스, 로그 등 모든 데이터 소스에서 만들 수 있습니다. ClickStack은 이 모두를 wide events로 처리합니다. 모든 **numeric column**은 시간에 따라 차트로 표시할 수 있으며, **string**, **date**, **numeric** 컬럼은 그룹화에 사용할 수 있습니다.

      이 통합된 접근 방식을 통해 telemetry 타입 전반에서 일관되고 유연한 모델로 대시보드를 구축할 수 있습니다.
    </Note>
  </Step>
</Steps>

<div id="creating-dashboards">
  ## 대시보드 만들기
</div>

대시보드를 사용하면 관련된 시각화를 그룹으로 묶어 메트릭을 비교하고 패턴을 나란히 살펴보면서 시스템의 잠재적인 근본 원인을 파악할 수 있습니다. 이러한 대시보드는 임시 조사를 위해 사용할 수도 있고, 지속적인 모니터링을 위해 저장할 수도 있습니다.

전역 필터는 대시보드 수준에서 적용할 수 있으며, 해당 대시보드의 모든 시각화에 자동으로 전파됩니다. 이를 통해 차트 전반에서 일관된 드릴다운이 가능해지고, 서비스와 텔레메트리 타입 전반의 이벤트 상관관계를 더 쉽게 분석할 수 있습니다.

아래에서는 로그 및 트레이스 데이터 소스를 사용해 2개의 시각화가 포함된 대시보드를 만듭니다. 이 단계는 [play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com)에서 재현할 수 있으며, 가이드 ["원격 데모 데이터세트"](/ko/clickstack/example-datasets/remote-demo-data)에 설명된 대로 [sql.clickhouse.com](https://sql.clickhouse.com)에서 호스팅되는 데이터셋에 연결해 로컬에서도 재현할 수 있습니다.

<Steps>
  <Step>
    ### 대시보드로 이동

    왼쪽 메뉴에서 `Dashboards`를 선택합니다. 그런 다음 `New Dashboard`를 클릭하여 임시 대시보드 또는 저장된 대시보드를 만듭니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-1.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=8aa8063a544674eaea79c867ac2edc09" alt="대시보드 생성" size="lg" width="1467" height="595" data-path="images/use-cases/observability/hyperdx-dashboard-1.png" />
  </Step>

  <Step>
    ### 시각화 생성 – 서비스별 평균 요청 시간

    시각화 생성 패널을 열려면 `Add New Tile`을 선택합니다.

    상단 메뉴에서 `Line/Bar` 시각화 유형을 선택한 다음 `Traces` 데이터셋([play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com)을 사용하는 경우 `Demo Traces`)을 선택합니다. 다음 값을 입력하여 시간 경과에 따른 서비스 이름별 평균 요청 시간을 보여주는 차트를 생성합니다.

    * 차트 이름: `Average duration by service`
    * 메트릭: `Average`
    * 컬럼: `Duration/1000`
    * Where: `<empty>`
    * 그룹화 기준: `ServiceName`
    * 별칭: `Average Time`

    `Save`를 클릭하기 전에 **실행** 버튼을 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-2.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=07d9d20e4400f2383a24b9d277391a50" alt="대시보드 시각화 생성" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-2.png" />

    시각화가 대시보드 전체 너비를 차지하도록 크기를 조정합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-3.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=969fa623a75cd9ccce3430b214fe31be" alt="시각화가 있는 대시보드" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-3.png" />
  </Step>

  <Step>
    ### 시각화 만들기 – 시간에 따른 서비스별 이벤트 수

    시각화 생성 패널을 열려면 `Add New Tile`을 선택합니다.

    상단 메뉴에서 `Line/Bar` 시각화 유형을 선택한 다음 `Logs` 데이터셋([play-clickstack.clickhouse.com](https://play-clickstack.clickhouse.com)을 사용하는 경우 `Demo Logs`)을 선택합니다. 서비스 이름별로 시간에 따른 이벤트 수를 보여주는 차트를 만들려면 다음 값을 입력합니다.

    * 차트 이름: `Event count by service`
    * 메트릭: `Count of Events`
    * 조건: `<empty>`
    * 그룹화 기준: `ServiceName`
    * 별칭: `Count of events`

    `Save`를 클릭하기 전에 **실행** 버튼을 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-4.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=5e6759d0325f69f9bceb5c2a95adf218" alt="대시보드 시각화 2" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-4.png" />

    시각화 크기를 조정해 대시보드 전체 너비를 차지하도록 합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-5.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=02c718a3b03702dc3c2e19fa24a74e2f" alt="시각 자료가 있는 대시보드 2" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-5.png" />
  </Step>

  <Step>
    ### 스팬 지속 시간용 히트맵 타일 추가

    히트맵 타일은 각 (시간, 값) 버킷에 속하는 이벤트 수를 색상 격자로 표시합니다. 평균이나 단일 백분위수만 보는 것이 아니라, 시간에 따라 분포의 **형태**가 어떻게 달라지는지 보고 싶을 때 히트맵을 사용하십시오. 지연 시간 히트맵은 Line 차트에서는 평균값에 가려질 수 있는 이중 봉우리 지속 시간 패턴, 느린 구간의 군집, 또는 갑작스러운 확산을 보여 줍니다.

    히트맵 타일을 추가하려면 다음과 같이 하십시오.

    1. `Add New Tile`을 선택합니다.
    2. 상단 메뉴에서 `Heatmap` 시각화 유형을 선택합니다. 데이터 소스 드롭다운에는 [소스 유형이 `Traces`인](/ko/clickstack/managing/config#traces) 소스만 표시됩니다. 히트맵에는 traces 소스에서만 제공되는 스팬 지속 시간 컬럼이 필요하므로 logs, metrics, session 소스는 제외됩니다.
    3. traces 소스 중 하나를 이름으로 선택합니다. 이름 자체는 임의이며, 중요한 것은 유형뿐입니다.

    소스를 선택하면 히트맵에 다음 값이 미리 채워집니다.

    * **Value**: 소스의 `Duration Expression`이며, 현재 표시 단위에 맞게 조정됩니다(예: 각 이벤트의 스팬 지속 시간을 나노초에서 밀리초로 변환하는 `(Duration)/1e6`)
    * **Count**: `count()`

    4. 차트 이름을 설정하고, `Where`를 사용해 성능을 관찰하려는 특정 서비스나 작업 집합으로 히트맵 범위를 제한합니다.
    5. 관심 있는 기간에 맞게 시간 범위를 조정합니다. 더 넓은 범위를 사용하면 짧은 구간에서는 보이지 않을 수 있는 분포 변화와 이중 봉우리 지연 시간 패턴을 확인할 수 있습니다.

    아래 예시는 24시간 구간 동안 단일 서비스를 보여 주며, 해당 서비스의 스팬 지속 시간에서 빠른 경로와 느린 경로가 두 개의 수평 밴드로 뚜렷하게 분리되어 있습니다.

    히트맵을 더 세부적으로 사용자 지정하려면 **Display Settings**를 클릭하여 **Scale**(Log 또는 Linear), **Value**, **Count** 표현식을 설정하는 드로어를 엽니다. 전체 옵션 목록은 Event Deltas 페이지의 [히트맵 사용자 지정](/ko/clickstack/features/event-deltas#customize)에 설명되어 있습니다. 동일한 드로어가 재사용됩니다.

    `Run`을 클릭해 차트를 미리 확인한 다음 `Save`를 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/heatmap-tile-editor.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=9e85b314113af257839354e496125ac6" alt="스팬 지속 시간 기본값이 미리 채워지고 ServiceName payment 필터와 Display Settings 버튼이 표시된 히트맵 타일 편집기" size="lg" width="1600" height="900" data-path="images/clickstack/dashboards/heatmap-tile-editor.png" />

    저장된 타일은 대시보드에 히트맵으로 표시됩니다. 셀 위에 마우스를 올리면 버킷 경계와 이벤트 수를 확인할 수 있습니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/heatmap-tile-rendered.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=f215a95e2b3a5129450a022c25322856" alt="24시간 동안 payment 서비스의 스팬 지속 시간 분포를 보여 주는 히트맵 대시보드 타일" size="lg" width="1600" height="900" data-path="images/clickstack/dashboards/heatmap-tile-rendered.png" />

    <Tip>
      **히트맵당 두 개의 ClickHouse 쿼리**

      히트맵은 순차적으로 두 개의 쿼리를 실행합니다. 먼저 값 범위를 계산하는 작은 **경계 쿼리**를 실행한 다음, 버킷별 이벤트 수를 집계하는 **히트맵 쿼리**를 실행합니다. 두 쿼리 모두 편집기의 **생성된 SQL** 아래에서 확인할 수 있으므로, 필요하면 검토하거나 복사할 수 있습니다.
    </Tip>

    #### Event Deltas로 드릴다운

    렌더링된 히트맵 타일의 셀을 클릭하면 **View in Event Deltas** 작업이 열립니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/heatmap-tile-drilldown.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=11774eb80f29f93a0ff9407a60cb455c" alt="View in Event Deltas 작업이 표시되는 히트맵 셀 클릭" size="lg" width="1600" height="900" data-path="images/clickstack/dashboards/heatmap-tile-drilldown.png" />

    이 작업을 선택하면 타일의 데이터 소스, `Where` 절, 시간 범위가 그대로 유지된 상태로 [Event Deltas](/ko/clickstack/features/event-deltas) 화면이 열립니다. 여기에서 동일한 분포를 대화형으로 살펴보고, 속성별로 나누어 느린 스팬이 빠른 스팬과 무엇이 다른지 확인할 수 있으며, 쿼리를 수동으로 다시 작성하지 않고도 각 셀에 해당하는 개별 스팬을 조사할 수 있습니다.
  </Step>

  <Step>
    ### 대시보드 필터

    시간 범위와 함께 Lucene 또는 SQL 필터를 대시보드 수준에서 적용할 수 있으며, 이 설정은 모든 시각화에 자동으로 반영됩니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-filter.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=6ecae6397e9cf3c0b836ea7e80454ac0" alt="필터링이 적용된 대시보드" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-filter.png" />

    예를 들어, Lucene 필터 `ServiceName:"frontend"`를 대시보드에 적용하고 시간 윈도우를 최근 3시간으로 변경하십시오. 이제 시각화에 `frontend` 서비스의 데이터만 반영되는 것을 확인할 수 있습니다.

    대시보드는 자동으로 저장됩니다. 대시보드 이름을 설정하려면 제목을 선택해 수정한 뒤 `Save Name`을 클릭하십시오.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-save.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=bf1f98c977c0c079ed61b9c3a548e7f5" alt="대시보드 저장" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-save.png" />
  </Step>
</Steps>

<div id="dashboards-editing-visualizations">
  ## 대시보드 - 시각화 편집
</div>

시각화를 삭제, 편집하거나 복제하려면 해당 항목 위에 마우스를 올린 다음 해당 작업 버튼을 사용하십시오.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-edit.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=445ad4e238e2212d2a45ae8de8a2699b" alt="대시보드 편집" size="lg" width="3120" height="848" data-path="images/use-cases/observability/hyperdx-dashboard-edit.png" />

<div id="dashboard-listing-search">
  ## 대시보드 - 목록 및 검색
</div>

대시보드는 Dashboards 페이지에서 확인할 수 있습니다. 태그별로 정리되어 있으며, 기본 제공 검색 및 필터링 기능으로 특정 대시보드를 빠르게 찾을 수 있습니다.

대시보드는 사이드바와 목록 페이지 상단에서 빠르게 접근할 수 있도록 즐겨찾기에 추가할 수 있습니다. 즐겨찾기는 사용자별로 개별 관리됩니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-search.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=8a1f170a9cc8ac5737327798e786540b" alt="대시보드 검색" size="lg" width="1466" height="878" data-path="images/use-cases/observability/hyperdx-dashboard-search.png" />

<div id="tagging">
  ## 대시보드 - 태그 지정
</div>

대시보드와 저장된 검색에 태그를 추가해 더 쉽게 정리할 수 있습니다.
태그를 사용하면 필요에 따라 항목을 유연하게 분류하고 필터링할 수 있습니다.

<div id="how-tags-work">
  #### 태그 작동 방식
</div>

* **구성**: 태그는 왼쪽 사이드바에 표시되며, 여기서 대시보드와 저장된 검색이 할당된 태그별로 그룹화됩니다
* **여러 태그**: 더 세분화해 분류할 수 있도록 하나의 항목에 하나 이상의 태그를 추가할 수 있습니다
* **자동 생성**: 아직 존재하지 않는 태그를 할당하면 해당 태그가 자동으로 생성됩니다
* **간편한 관리**: 구성 체계를 조정할 수 있도록 언제든지 태그를 추가하거나 제거할 수 있습니다

이 기능을 사용하면 항목이 늘어나도 관련 항목을 쉽게 찾고 워크스페이스를 체계적으로 유지할 수 있습니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-tags-search.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=de4939b1a5e424b97ce950fe39a6587f" alt="저장된 검색의 태그" size="md" border width="743" height="230" data-path="images/use-cases/observability/clickstack-tags-search.png" />

여러 태그를 선택해 서로 다른 범주의 항목을 필터링하여 볼 수도 있습니다:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/brNmKxVjpyGdH7Ao/images/use-cases/observability/clickstack-tags-dashboard.png?fit=max&auto=format&n=brNmKxVjpyGdH7Ao&q=85&s=e028f0222150880f753ba65d4bdfc326" alt="대시보드에서 여러 태그 선택" size="md" border width="529" height="252" data-path="images/use-cases/observability/clickstack-tags-dashboard.png" />

<div id="custom-filters">
  ## 사용자 지정 필터
</div>

모든 대시보드에서 사용할 수 있는 [자유 텍스트 필터](#filter-dashboards) 외에도, 저장된 대시보드에서는 ClickHouse에서 쿼리한 데이터로 채워지는 사용자 지정 드롭다운 필터를 지원합니다. 이를 통해 재사용 가능한 클릭형 필터 컨트롤을 제공하므로, 대시보드 사용자는 표현식을 직접 작성하지 않고도 필터링할 수 있습니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/filter-dropdown.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=12a756f29196f6e2d7c8f8e5ce1b410b" alt="사용 가능한 서비스 이름을 보여주는 서비스 드롭다운 필터" size="lg" width="3812" height="1910" data-path="images/clickstack/dashboards/filter-dropdown.png" />

다음 단계에서는 ["대시보드 만들기"](#creating-dashboards) 섹션에서 만든 대시보드에 사용자 지정 필터를 추가하는 방법을 설명합니다.

<Steps>
  <Step>
    ### 필터 편집 대화상자 열기

    저장된 대시보드를 열고 도구 모음에서 **Edit Filters**를 선택합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/edit-filters.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=1c46691cd6c817e24ed98c6a9d028513" alt="대시보드 도구 모음의 Edit Filters 버튼" size="lg" width="3814" height="1908" data-path="images/clickstack/dashboards/edit-filters.png" />
  </Step>

  <Step>
    ### 새 필터 추가

    **Add new filter**를 클릭합니다. **Name**을 입력하고, **Data source**를 선택하고, **Filter expression**(드롭다운을 채울 고유값을 가져오는 SQL 컬럼 또는 표현식)을 입력해 필터를 구성합니다. 그런 다음 **Save filter**를 클릭합니다.

    예를 들어, trace 데이터용 서비스 필터를 추가하려면 `Traces` 데이터 소스에서 `ServiceName`을 필터 표현식으로 사용합니다. "Dropdown values filter"는 선택 사항이며, 드롭다운에 표시할 값을 제한할 때 사용할 수 있습니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/add-filter.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=07ea0821f13932817996e50bd7fdf3b5" alt="Name, Data source, Filter expression 필드가 있는 필터 추가 대화상자" size="md" width="436" height="454" data-path="images/clickstack/dashboards/add-filter.png" />

    Filters 모달에는 대시보드에 구성된 모든 필터가 표시됩니다. 여기에서 기존 필터를 편집하거나 삭제하고, 추가 필터를 더 만들 수 있습니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/saved-filters.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=ac7011a8fac6dc1a9aad779fcddc3326" alt="구성된 Services 필터를 보여주는 Filters 모달" size="md" width="764" height="452" data-path="images/clickstack/dashboards/saved-filters.png" />
  </Step>

  <Step>
    ### 필터 사용

    Filters 모달을 닫습니다. 새 드롭다운 필터가 검색창 아래에 표시됩니다. 이를 클릭해 사용 가능한 값을 확인한 다음 하나를 선택하면 대시보드의 모든 시각화에 필터가 적용됩니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/filtered-dashboard.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=17672ba4e01a5bf9fa10fe237eb1a923" alt="frontend 서비스로 필터링된 대시보드" size="lg" width="3812" height="1910" data-path="images/clickstack/dashboards/filtered-dashboard.png" />
  </Step>

  <Step>
    ### (선택 사항) 필터 값을 기본값으로 저장

    필터 선택을 대시보드 기본값으로 유지하려면 대시보드 메뉴에서 **Save Query & Filters as Default**를 선택합니다. 그러면 이후 대시보드는 선택한 필터가 적용된 상태로 항상 열립니다. 재설정하려면 같은 메뉴에서 **Remove Default Query & Filters**를 선택합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/save-filter-values.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=d3a3407b665acfce5e7aa4fec0333d50" alt="Save Query and Filters as Default 옵션을 보여주는 대시보드 메뉴" size="lg" width="3812" height="1936" data-path="images/clickstack/dashboards/save-filter-values.png" />
  </Step>
</Steps>

<Note>
  사용자 지정 드롭다운 필터는 저장된 대시보드에서 사용할 수 있습니다. 이 방식이 실제로 적용된 예시는 [Kubernetes 대시보드](#kubernetes-dashboard)를 참조하십시오. 이 대시보드에는 파드, 배포, 노드 이름, 네임스페이스, 클러스터용 기본 드롭다운 필터가 제공됩니다.
</Note>

<div id="drilldown-to-search">
  ## Search로 드릴다운
</div>

대시보드 타일은 Search 페이지로 드릴다운하는 기능을 지원합니다. 시각화에서 데이터 포인트를 클릭하면 다음 옵션이 포함된 컨텍스트 메뉴가 열립니다:

* **모든 이벤트 보기** — 선택한 시간 범위의 모든 이벤트를 표시하는 Search 페이지로 이동합니다.
* **그룹으로 필터링** — 특정 시리즈로 필터링된 Search 페이지로 이동합니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/GaEHa-fd8w_5w7tQ/images/clickstack/dashboards/drilldown.png?fit=max&auto=format&n=GaEHa-fd8w_5w7tQ&q=85&s=28ae791945535db4f173756ae0802fa7" alt="모든 이벤트 보기 및 그룹으로 필터링 옵션이 표시된 드릴다운 컨텍스트 메뉴" size="lg" width="3812" height="1910" data-path="images/clickstack/dashboards/drilldown.png" />

이 기능은 대시보드에서 발견한 특정 급증이나 이상 징후를 조사할 때 유용합니다. 집계된 보기에서 해당 개별 이벤트로 빠르게 전환할 수 있습니다.

<div id="presets">
  ## 프리셋
</div>

HyperDX는 기본 제공 대시보드와 함께 배포됩니다.

<div id="clickhouse-dashboard">
  ### ClickHouse 대시보드
</div>

이 대시보드는 ClickHouse 모니터링을 위한 시각화를 제공합니다. 이 대시보드로 이동하려면 왼쪽 메뉴에서 선택하십시오.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-clickhouse.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=e5e7c1cf0d8eddf824aa1c8c567ab419" alt="ClickHouse 대시보드" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-clickhouse.png" />

이 대시보드는 탭을 사용해 **Selects**, **Inserts**, **ClickHouse Infrastructure** 모니터링을 구분합니다.

<Info>
  **필수 시스템 테이블 액세스**

  이 대시보드는 주요 메트릭을 표시하기 위해 ClickHouse [시스템 테이블](/ko/reference/system-tables/index)을 조회합니다. 다음 권한이 필요합니다.

  `GRANT SHOW COLUMNS, SELECT(CurrentMetric_MemoryTracking, CurrentMetric_S3Requests, ProfileEvent_OSCPUVirtualTimeMicroseconds, ProfileEvent_OSReadChars, ProfileEvent_OSWriteChars, ProfileEvent_S3GetObject, ProfileEvent_S3ListObjects, ProfileEvent_S3PutObject, ProfileEvent_S3UploadPart, event_time) ON system.metric_log`

  `GRANT SHOW COLUMNS, SELECT(active, database, partition, rows, table) ON system.parts`

  `GRANT SHOW COLUMNS, SELECT(event_date, event_time, memory_usage, normalized_query_hash, query, query_duration_ms, query_kind, read_rows, tables, type, written_bytes, written_rows) ON system.query_log`

  `GRANT SHOW COLUMNS, SELECT(event_date, event_time, hostname, metric, value) ON system.transposed_metric_log`
</Info>

<div id="services-dashboard">
  ### 서비스 대시보드
</div>

서비스 대시보드는 트레이스 데이터를 기반으로 현재 활성화된 서비스를 표시합니다. 이 대시보드를 사용하려면 트레이스를 수집하고 유효한 Traces 데이터 소스를 구성해야 합니다.

서비스 이름은 트레이스 데이터에서 자동으로 감지되며, 기본 제공 시각화가 HTTP Services, Database, Errors의 3개 탭으로 구성되어 있습니다.

시각화는 Lucene 또는 SQL 구문을 사용해 필터링할 수 있으며, 시간 범위도 원하는 분석에 맞게 조정할 수 있습니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-services.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=8481a2815899a2c686b5c421944038c2" alt="ClickHouse 서비스" size="lg" width="3600" height="1930" data-path="images/use-cases/observability/hyperdx-dashboard-services.png" />

<div id="kubernetes-dashboard">
  ### Kubernetes 대시보드
</div>

이 대시보드에서는 OpenTelemetry를 통해 수집된 Kubernetes 이벤트를 탐색할 수 있습니다. 고급 필터링 옵션이 포함되어 있어 Kubernetes 파드, 배포, 노드 이름, 네임스페이스, 클러스터를 기준으로 필터링할 수 있으며, 자유 텍스트로 검색할 수도 있습니다.

Kubernetes 데이터는 쉽게 탐색할 수 있도록 Pods, Nodes, Namespaces의 세 탭으로 구성되어 있습니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-dashboard-kubernetes.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=3f867fecbe9a3759447d241b7eac7f52" alt="ClickHouse kubernetes" size="lg" width="3022" height="1576" data-path="images/use-cases/observability/hyperdx-dashboard-kubernetes.png" />