연관 뷰 설정 설명¶
telemetry는 엔터티 상세 페이지의 연관 뷰(예: 로그, 이벤트, 트레이스, 대시보드)를 구성하는 데 사용됩니다. 각 설정 항목은 표시 가능한 뷰 카드를 나타냅니다.
기본 구조¶
telemetry:
- name: "오류 로그"
type: explorer
viewName: logs
query: "service='{{metadata.service}}'"
- name: "메트릭"
type: dashboard
timerange: "30m"
viewName: "서비스 개요"
설명:
name,viewName은 국제화가 필요한 경우zh-CN,en-US로 분할할 수 있습니다.- 국제화가 필요하지 않은 경우 문자열을 직접 입력하면 됩니다.
필드 설명¶
name¶
상세 페이지에 표시되는 뷰 이름입니다.
예시:
type¶
연관 뷰 유형으로, 현재 두 가지를 지원합니다:
dashboard: 대시보드explorer: 탐색기
explorer 유형 설정¶
explorer는 로그, 이벤트, 트레이스, 컨테이너, Pod 등 탐색기를 연관 짓는 데 사용됩니다.
viewName¶
탐색기 유형으로, 현재 지원하는 항목:
logs: 로그 탐색기event: 이벤트 탐색기trace: 트레이스 탐색기container: 컨테이너 탐색기pod: Pod 탐색기
query¶
필터 조건으로, DQL 쿼리 구문을 사용합니다.
변수를 통해 현재 엔터티 속성을 참조할 수 있습니다:
예시:
더 복잡한 조건도 작성할 수 있습니다:
explorer 예시¶
- name: "오류 로그"
type: explorer
viewName: logs
query: "service='{{metadata.service}}' AND df_status NOT IN ['ok','info']"
- name: "트레이스"
type: explorer
viewName: trace
query: "service='{{metadata.service}}'"
- name: "이벤트"
type: explorer
viewName: event
query: "service='{{metadata.service}}'"
dashboard 유형 설정¶
dashboard는 상세 페이지에 대시보드를 표시하는 데 사용됩니다.
timerange¶
대시보드 쿼리의 시간 범위입니다. 예시:
keys¶
특정 엔터티 조건을 만족할 때만 해당 대시보드를 표시합니다.
예시:
이는 현재 엔터티의 database_type이 MySQL인 경우에만 해당 대시보드를 표시함을 의미합니다.
viewName¶
대시보드 이름입니다.
- 반드시 내장 뷰에 있는 dashboard 이름을 입력해야 합니다.
- 이름이 시스템 내장 대시보드와 일치해야 하며, 그렇지 않으면 정상적으로 열리지 않습니다.
dashboard 예시¶
- name: "메트릭"
type: dashboard
timerange: "30m"
viewName: "서비스 개요"
- name: "메트릭"
type: dashboard
keys: { database_type: "MySQL" }
timerange: "1h"
viewName: "인프라 MySQL 모니터링 뷰"
- name: "메트릭"
type: dashboard
keys: { database_type: "Oracle" }
timerange: "1h"
viewName: "인프라 Oracle 모니터링 뷰"
전체 예시¶
telemetry:
- name: "오류 로그"
type: explorer
viewName: logs
query: "service='{{metadata.service}}' AND df_status NOT IN ['ok','info']"
- name: "트레이스"
type: explorer
viewName: trace
query: "service='{{metadata.service}}'"
- name: "이벤트"
type: explorer
viewName: event
query: "service='{{metadata.service}}'"
- name: "메트릭"
type: dashboard
timerange: "30m"
viewName: "서비스 개요"
- name: "메트릭"
type: dashboard
keys: { database_type: "MySQL" }
timerange: "1h"
viewName: "인프라 MySQL 모니터링 뷰"
- name: "메트릭"
type: dashboard
keys: { database_type: "Oracle" }
timerange: "1h"
viewName: "인프라 Oracle 모니터링 뷰"
설정 권장 사항¶
- 국제화가 필요한 경우
name과viewName에zh-CN,en-US를 사용할 수 있습니다. explorer.query에서 참조하는{{metadata.field}}는 엔터티에 실제로 존재하는 속성이어야 합니다.dashboard.viewName은 시스템 내장 dashboard를 가리켜야 합니다.keys는 엔터티 속성 값에 따라 다른 대시보드를 표시할 때 적합합니다.- 하나의 엔터티에 여러 연관 뷰를 구성할 수 있으며,
telemetry아래에 직접 추가하면 됩니다.