테이블 차트화하기

테이블 차트화하기 (Chart any table)

Observations 테이블의 툴바에는 Table | Chart 토글이 있어요. Chart로 전환하면 필터링된 행들이 같은 쿼리 위에서 차트로 그려져요. Table로 돌아가면 같은 데이터를 다시 목록으로 보게 돼요. 두 뷰 사이에서 쿼리는 전혀 변하지 않아요: 같은 필터, 같은 시간 범위, 같은 데이터를 두 방식으로 보여줄 뿐이에요.

출처: 문서

본문

Observations 테이블의 툴바에는 Table | Chart 토글이 있어요. Chart로 전환하면 필터링된 행들이 같은 쿼리 위에서 차트로 그려져요. Table로 돌아가면 같은 데이터를 다시 목록으로 보게 돼요. 두 뷰 사이에서 쿼리는 전혀 변하지 않아요: 같은 필터, 같은 시간 범위, 같은 데이터를 두 방식으로 보여줄 뿐이에요.

현재 뷰는 차트의 유형·메트릭·집계·breakdown과 함께 URL에 저장돼요. 차트는 역방향(reversible)이고 공유 가능해요: 링크를 보내면 상대가 당신이 보고 있던 것과 같은 필터·같은 차트에 도착해요. 기본값에서 변경한 설정만 URL에 나타나므로, 평범한 차트 링크는 짧게 유지돼요.

전체 차트 대신 스파이크를 찾고 있나요? Pulse는 테이블을 대체하지 않고 그 위에 놓이는 컴팩트한 이상치 스트립이에요. 스파이크를 클릭하거나 드래그해 테이블을 그 창으로 좁힐 수 있어요.

차트 뷰는 Langfuse v4 데이터 모델에서 실행돼요. Langfuse Cloud에서는 Langfuse v4 preview를 켜야 사용할 수 있고, 셀프호스팅 배포에서는 Langfuse v4로 업그레이드한 후 사용할 수 있어요.

Visualize 패널 (The Visualize panel)

Chart로 전환하면 Visualize 패널이 필터링된 행이 어떻게 그려질지 정의해요. 차트는 네 가지 선택의 결합이며, 패널은 "Average latency by model over time" 같은 현재 선택의 한 줄 요약을 보여줘요.

차트 유형 (Chart type)

  • Line, Area, Bars는 시간 경과에 따른 값을 그려요.
  • Ranked는 상위 breakdown 값을 큰 것부터 가로 순위로 보여줘요.
  • Pie는 breakdown 값을 전체의 비율로 보여줘요.
  • Number는 전체 범위에 대해 단일 값을 보여주고 breakdown을 무시해요.

Ranked와 Pie는 범주형이며 breakdown의 상위 값을 보여줘요.

메트릭 (Metric)

그릴 값: Count of rows, Latency, Cost, Tokens. 기본값은 Count예요.

집계 (Aggregation)

각 시리즈·시간 버킷 내에서 메트릭이 어떻게 축소되는지를 나타내요. 사용 가능한 옵션은 메트릭에 따라 달라요:

  • Count는 항상 카운트돼요.
  • Latency는 Average, Median (p50), p95, p99, Max, Min을 지원해요.
  • Cost와 Tokens는 Sum, Average, p95, Max를 지원해요.

메트릭을 바꾸면 집계가 그 메트릭이 지원하는 것으로 리셋돼요.

Breakdown

차트를 나눌 차원이에요. breakdown의 각 값은 자체 시리즈가 돼요 (예: 자체 선 또는 조각). 옵션은 Total(breakdown 없음), Model, Name, Level, Type, Environment예요.

예를 들어 차트 유형 Line, 메트릭 Latency, 집계 p95, breakdown Model을 선택하면 "p95 latency by model over time"이 돼요. 메트릭을 Count로 바꾸면 정확히 같은 필터링된 행에 대해 "count of events by model over time"이 돼요.

시간 버킷은 선택한 시간 범위에서 자동으로 고르는데, 매우 짧은 범위는 차트에 충분한 버킷을 만들지 못해 Langfuse가 범위를 넓히라고 요청할 수 있어요.

차트가 적용할 수 없는 필터 (Filters the chart cannot apply)

차트는 테이블의 필터를 재사용해요. 대부분 그대로 전달돼요: environment, type, name, level, model, trace name, user, session, version, prompt name, tags, tool names, experiment 필드 모두 테이블에 적용되는 그대로 차트에도 적용돼요.

일부 필터는 집계된 시계열로 변환되지 않아요. 조용히 버리거나 차트를 숨기는 대신, Langfuse는 차트를 표시한 채 그 필터들을 제자리에서 비활성화해요: 일치하는 사이드바 패싯은 흐려지고, 일치하는 검색바 토큰은 흐려지고 취소선이 그어져요. 어느 쪽이든 호버하면 그 필터가 차트에는 쓸 수 없지만 테이블에는 여전히 적용된다고 설명해요. 항상 차트를 볼 수 있고, 활성 필터 중 어떤 것을 차트가 반영하는지 정확히 알 수 있어요.

차트가 적용할 수 없는 필터는:

  • 필터로 쓰이는 숫자 측정값 (latency, cost, token count로 필터링). 참고: latency, cost, tokens는 여전히 차트 메트릭으로 사용 가능해요. 값을 기준으로 행을 필터링하는 것만 차트에서 불가능해요.
  • Scores, metadata, comments 필터.
  • 전체 텍스트 검색과 필드 범위 텍스트 검색 (input:, output:).
  • 존재 여부 검사 (has:와 -has:).

이것들은 차트의 집계 쿼리가 오늘 표현할 수 있는 경우의 반영이지, 영구적인 제한은 아니에요.

대시보드에 추가 (Add to dashboard)

테이블에서 만든 차트가 거기에만 있어야 하는 건 아니에요. Add to dashboard는 현재 차트를 유형·메트릭·집계·breakdown·적용한 필터와 함께 커스텀 대시보드 중 하나에 위젯으로 저장해요. 대상 대시보드를 고르면 Langfuse가 위젯을 만들어 그 대시보드로 떨어뜨려 배치하게 해줘요. 저장된 위젯은 손으로 만든 것과 구별할 수 없는 일반 대시보드 위젯이며, 차트가 보여주던 것과 같은 숫자를 보여줘요.

차트의 시간 범위는 위젯과 함께 저장되지 않아요. 호스트 대시보드가 범위를 제공해요. 차트를 대시보드에 추가하려면 프로젝트에서 대시보드를 편집할 권한이 필요해요.

Filter Search Bar와 차트는 같은 쿼리에 대한 두 뷰예요. 검색바는 행을 좁히는 방법이고, 차트는 남은 것을 보는 한 가지 방법이에요. 타이핑으로 원하는 슬라이스로 필터링하고, Chart로 토글해 그 추세를 보고, 뷰를 유지할 가치가 있다면 Add to dashboard를 사용하세요.

GitHub Discussions

더 알아보기 (Learn more)