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

# 데모 데이 - 2026-07-31

> 2026-07-31 ClickStack 데모 데이

<div id="exponential-histogram-metrics">
  ## 지수 히스토그램 메트릭
</div>

*[@pulpdrew](https://github.com/pulpdrew)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/w45v3IMcXTY" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

OpenTelemetry 지수 히스토그램 메트릭에 원본 쿼리 지원이 추가되었습니다. 이전에도 이러한 메트릭을 소스에 등록할 수 있었지만 쿼리할 방법은 없었습니다. 이제 쿼리 빌더에서 개수와 분위수를 사용할 수 있습니다.

지수 히스토그램은 명시적 버킷 히스토그램과 유사하지만, 각 버킷의 경계를 저장하는 대신 2의 거듭제곱을 사용해 버킷 경계를 계산합니다. 스케일은 사용할 2의 거듭제곱을 제어합니다. 스케일이 높을수록 버킷이 작아지며, 오프셋은 경계를 더 높거나 낮은 배수 쪽으로 이동합니다. 각 버킷의 개수는 해당 범위에 속하는 관측값 수를 기록합니다.

max, min, sum, avg는 기존 명시적 히스토그램 구현과 마찬가지로 계속 지원되지 않습니다. 이러한 필드는 OpenTelemetry 데이터 모델에서 선택 사항이므로 존재한다고 가정하지 않습니다.

데모에서 볼 수 있듯이 생성된 SQL은 길고 그다지 깔끔하지 않습니다. 성능은 무난하고 메모리 부족도 발생하지 않지만, 이는 초기 기능 지원에 불과합니다. 다음 작업은 성능 개선이며, 이러한 쿼리를 훨씬 빠르게 만들 수 있는 업데이트된 스키마도 이미 작업 중입니다.

현재는 시계열 표시 유형만 올바르게 렌더링됩니다. 이는 기존 히스토그램 메트릭 유형과 동일합니다.

**관련 PR:** [#2687](https://github.com/hyperdxio/hyperdx/pull/2687) feat: 메트릭 이름 드롭다운에 지수 히스토그램 메트릭 표시, [#2697](https://github.com/hyperdxio/hyperdx/pull/2697) feat: 지수 히스토그램 메트릭에 분위수+합계 구현, [#2705](https://github.com/hyperdxio/hyperdx/pull/2705) feat: MCP에서 지수 히스토그램 지원, [#2707](https://github.com/hyperdxio/hyperdx/pull/2707) fix: 속성(Attribute)이 아닌 컬럼에 대한 히스토그램 분위수 집계 그룹화 지원

<div id="validation-for-raw-sql-charts">
  ## Raw SQL 차트 검증
</div>

*[@pulpdrew](https://github.com/pulpdrew)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/zfZsehTqeCQ" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

이제 Raw SQL 차트에서 필요한 매크로가 누락되면 경고가 표시됩니다. 이는 다수의 Raw SQL 차트를 만들던 사용자가 계속 혼란스러운 결과를 얻었던 지원 사례에서 비롯되었습니다.

대시보드 쿼리에는 filters 및 source table 매크로가 포함되어야 합니다. 시계열 차트에는 time range 및 interval 매크로도 포함되어야 합니다. 이전에는 타일에 알림이 연결된 후에만 이러한 검사가 실행되었습니다. 이제 모든 Raw SQL 차트에서 검사가 실행되므로 매크로를 제거하면 나중에 이해하기 어려운 차트가 생성되는 대신 Editor에 경고가 표시됩니다.

검증에서는 각 매크로의 의존성도 고려합니다. Raw SQL 차트에는 그 밖에는 source가 필요하지 않더라도 source table 및 filters 매크로를 사용하려면 source를 선택해야 합니다. 따라서 source를 선택하지 않은 채 두 매크로 중 하나를 사용하면 경고가 아닌 오류가 표시됩니다.

작은 변경이지만 지원팀에 문의하지 않고도 Raw SQL 문제를 더 쉽게 찾을 수 있게 됩니다.

**관련 PR:** [#2742](https://github.com/hyperdxio/hyperdx/pull/2742) feat: SQL Editor에서 누락된 params/macros 경고

<div id="link-to-sources-by-name-not-id">
  ## ID 대신 이름으로 소스 연결하기
</div>

*[@pulpdrew](https://github.com/pulpdrew)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/r2uNmcJXGSM" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

LogHouse 팀은 소스에 연결할 수 있는 더 안정적인 방식을 요청했습니다. 이 팀은 ClickHouse Cloud의 로깅 환경을 운영하며, 코드형 인프라를 통해 프로그래밍 방식으로 소스를 프로비저닝합니다. 소스를 다시 생성하면 소스 ID가 변경되고 개발, 스테이징, 프로덕션 환경마다 ID가 다르므로 ID 기반 링크는 안정적이지 않습니다. 알림 시스템과 Grafana에서 ClickStack으로 연결하기 때문에 환경별 소스 ID 집합을 별도로 관리하는 것은 실용적이지 않았습니다.

이제 `source` URL 매개변수는 ID뿐 아니라 소스 이름도 허용합니다. 이름은 소스 프로비저닝 시 지정되므로 동일한 링크를 모든 환경에서 사용할 수 있습니다. 처음에는 검색 페이지에 지원이 추가되었습니다. 후속 PR에서는 차트 탐색기, 서비스 맵, 세션, 서비스 대시보드, Kubernetes 대시보드 등 소스 매개변수가 있는 모든 페이지로 지원 범위를 확장합니다.

후속 논의는 주로 발견 가능성에 집중되었습니다. 이는 사실상 URL API이므로 우연히 발견하기는 어렵습니다. 기본적으로 ID 대신 이름을 사용하는 방안도 있지만, 이름 충돌 가능성 때문에 안전하지 않습니다. 그 밖에 공유 버튼을 통해 링크를 제공하는 방안, 에이전트가 MCP를 통해 링크를 생성하도록 하는 방안, URL API를 제대로 문서화하는 방안 등이 제안되었습니다. 상대 시간 범위도 같은 문서화의 혜택을 받을 수 있습니다.

이름 기반 참조는 대시보드에도 확장할 수 있습니다. 그러면 코드형 인프라 워크플로에서 소스를 프로비저닝하고 대시보드를 가져온 후 모든 항목을 자동으로 연결할 수 있습니다. UI를 통한 대시보드 가져오기는 이미 이름을 기준으로 소스를 일치시키므로, 남은 차이는 대부분 프로그래밍 방식 워크플로에 있습니다.

**관련 PR:** [#2746](https://github.com/hyperdxio/hyperdx/pull/2746) feat: URL 매개변수에서 ID 외에 소스 이름 허용, [#2758](https://github.com/hyperdxio/hyperdx/pull/2758) feat: 추가 페이지에서 소스 이름 딥링크 지원

<div id="chart-display-settings-redesign">
  ## 차트 표시 설정 재설계
</div>

*[@elizabetdev](https://github.com/elizabetdev)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/tO5yFKR-MLQ" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

차트 표시 설정의 위치를 정하는 작업이 진행 중입니다. 처음 변경에서는 별도의 드로어를 열지 않고 타일 편집기 오른쪽에 설정을 인라인으로 배치했습니다. 이전에는 타일 편집기가 모달이었고, 표시 설정은 그 위에 열린 드로어에 표시되었습니다. Escape를 한 번 누르면 둘 다 닫혔으며, 모달 위에 드로어를 띄우는 방식도 어색했습니다.

시리즈 설정도 그 위에 쌓아야 하면서 PR이 더 복잡해지자, 한 걸음 물러나 페이지 전반을 더 폭넓게 검토하기 시작했습니다. 작업은 아직 와이어프레임 단계입니다. 현재 디자인에서는 설정을 도킹 패널에 배치하고 변경 사항을 자동으로 적용하므로 Apply 버튼을 누르지 않아도 결과를 실시간으로 확인할 수 있습니다.

기존 PR에 다시 반영하기 전에 재설계를 완료할 계획입니다. 현재 구현된 내용은 프로토타입으로 취급하고 있으며, 특히 새 디자인이 대시보드 페이지의 일부도 변경하기 때문입니다.

**관련 PR:** [#2721](https://github.com/hyperdxio/hyperdx/pull/2721) feat(dashboards): 도킹된 설정 패널이 있는 드로어로 타일 편집기 이동

<div id="new-explore-page">
  ## 새로운 Explore 페이지
</div>

*[@elizabetdev](https://github.com/elizabetdev)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/E1vEjJBw1gs" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

이는 향후 검색, 저장된 검색, Chart Explorer를 단일 진입점으로 대체할 수 있는 통합 Explore 페이지를 위한 초기 구상입니다.

이 롤아웃은 트레이스 뷰어 재설계 과정에서 얻은 교훈을 바탕으로 합니다. 모든 사용자의 경험을 한 번에 변경하는 대신, 새 페이지는 소수의 사용자를 대상으로 기능 플래그 뒤에서 출시됩니다. 이 기간에 문제를 찾아 수정한 후 더 폭넓게 롤아웃합니다. 이 아이디어가 효과적이지 않다면 실험으로 남고 출시되지 않습니다. 이 역시 충분히 좋은 결과입니다.

페이지는 신호 유형을 선택하는 것으로 시작합니다. 트레이스, 로그 또는 메트릭을 선택하면 이후의 경험이 그에 맞게 바뀝니다. 예를 들어 로그를 선택하면 현재 Chart Explorer에서 제공되는 목록 보기, 이벤트 패턴, 시계열 및 기타 시각화가 표시됩니다.

페이지를 전환하지 않고도 조사를 계속할 수 있어야 합니다. 목록으로 시작해 숫자 또는 그룹화된 테이블로 이동하고, 결과를 대시보드에 추가한 뒤, 더 많은 제어가 필요하면 사용자 지정 쿼리를 작성할 수 있습니다.

대부분 사용자 피드백에서 비롯된 몇 가지 작은 아이디어도 포함되어 있습니다. 쿼리 편집기는 SQL Editor와 더 유사하게 작동하여 현재 자동 완성 동작의 차이를 없앱니다. 오류와 경고는 쿼리가 실행될 때까지 기다리지 않고 편집하는 동안 표시됩니다.

컬럼에는 전용 선택기가 제공됩니다. 적어도 한 명의 사용자는 `SELECT` 절을 변경하면 테이블에 표시되는 컬럼을 제어할 수 있다는 사실을 알지 못했습니다. 선택기에서 필드를 클릭하면 SQL이 업데이트되고 해당 필드를 기준으로 정렬할 수 있습니다. 고급 사용자를 위해 `SELECT` 절은 계속 제공됩니다.

저장된 뷰도 페이지에서 사용할 수 있으므로 저장하지 않고 탐색한 다음 현재 뷰를 그 자리에서 저장할 수 있습니다. 생성된 SQL은 인라인으로 표시됩니다.

현재 Chart Explorer에서 사용할 수 있는 일부 시각화를 비롯해 아직 빠진 부분이 상당히 많습니다. 이러한 요소가 추가됨에 따라 디자인은 계속 변경될 것입니다.

**관련 PR:** 아직 없음. 이는 출시된 기능이 아닌 초기 구상입니다.

<div id="dashboard-filter-linking">
  ## 대시보드 필터 연결
</div>

*[@teeohhem](https://github.com/teeohhem)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/IQ4WtnNYS5s" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

대시보드 필터 연결 기능이 머지되었습니다. 몇 달 전 초안에서 처음 선보인 후 성능 영향을 검토하기 위해 잠시 보류했습니다. 연결 기능은 대시보드 쿼리의 형태를 바꾸며 materialized view를 항상 최적으로 활용하지는 않으므로, 기본값이 아닌 선택적 토글로 제공됩니다.

연결을 활성화하면 한 필터에서 값을 선택할 때 다른 필터에서 선택할 수 있는 값의 범위가 좁혀집니다. 서비스를 선택하면 해당 서비스에서 발견된 심각도 값만 남습니다. 트레이스 ID를 선택하면 관련된 상위 트레이스 ID만 남습니다. 이를 통해 데이터가 반환되지 않는 조합을 선택하는 일을 방지합니다.

후속 PR에서는 연결 기능이 소스를 인식하도록 개선했습니다. 필터는 소스별로 그룹화되며, 서로 값을 좁힐 수 있는 인접 필터 사이에는 체인 아이콘이 표시됩니다. 로그 필터 2개와 트레이스 필터 2개가 있는 대시보드에서는 어떤 필터끼리 상호작용하는지 명확히 알 수 있습니다.

원래 사용 사례는 Kubernetes 대시보드였습니다. 파드를 선택하면 해당 파드를 포함하는 배포와 노드만 남아야 합니다. 좁혀진 값은 드롭다운을 열 때 지연 조회하므로 추가 lookup 비용을 제한합니다.

논의에서는 두 가지 미해결 사항이 남았습니다. 이 설정은 현재 브라우저 스토리지에 사용자별로 저장됩니다. 논의 결과, 궁극적으로는 대시보드 수준에서 저장하기를 원할 것으로 예상됩니다. 그렇다면 사용자 수준의 기본 설정은 나중에 대시보드 수준 동작과 충돌하지 않도록 임시로 유지하는 편이 더 나을 수 있습니다.

다른 질문은 값이 로드되는 동안 종속 필터가 어떻게 동작하는지입니다. 현재는 값을 선택하면 종속 드롭다운을 차단하는 대신 그 안에 로딩 상태가 표시되지만, 두 번째 종속 필터에서의 동작은 아직 검증이 필요합니다. 값 범위가 좁혀지는 동안에도 필터를 사용할 수 있게 하고 목록 업데이트가 아직 완료되지 않았음을 표시하는 방향이 선호되었습니다. 원하는 값을 이미 알고 있는 사용자는 metadata를 기다릴 필요가 없어야 합니다.

**관련 PR:** [#2423](https://github.com/hyperdxio/hyperdx/pull/2423) feat(dashboards): 계단식(패싯) 필터 값, [#2760](https://github.com/hyperdxio/hyperdx/pull/2760) feat(dashboards): 필터 연결 토글 유지 및 동일 소스 내 연결 명확화

<div id="remember-the-last-side-panel-tab">
  ## 마지막으로 사용한 사이드 패널 탭 기억하기
</div>

*[@MikeShi42](https://github.com/MikeShi42)의 데모*

<iframe width="768" height="432" src="https://www.youtube.com/embed/FlDWN7sGHMo" title="YouTube 동영상 플레이어" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

이번 주의 가장 작은 PR도 해결할 만한 불편함의 좋은 예입니다.

행 사이드 패널은 항상 OpenTelemetry 로그 필드를 중심으로 설계된 Overview 탭에서 열렸습니다. OTel 형식이 아닌 로그의 경우 이 탭에는 유용한 정보가 거의 표시되지 않습니다. 따라서 행을 열 때마다 Column Values 탭으로 전환해야 했습니다.

이제 패널은 마지막으로 사용한 탭을 기억하고 다음에 열 때도 해당 탭을 표시합니다. 별도로 구성할 것은 없습니다. Column Values로 전환한 비-OTel 사용자는 해당 탭이 유지되며, Overview를 사용하는 사용자는 기존 동작이 그대로 유지됩니다.

**관련 PR:** [#2752](https://github.com/hyperdxio/hyperdx/pull/2752) feat(app): 패널을 다시 열어도 마지막으로 사용한 사이드 패널 탭 기억