객체 매핑¶

객체 매핑은 뷰 변수의 보완 최적화 기능으로, 기본 객체, 리소스 카탈로그 등 객체 클래스 데이터에 한해 원본 필드를 가독성 높은 표시 이름으로 매핑할 수 있습니다. 매핑은 원본 데이터와 쿼리 로직을 변경하지 않으며, 프런트엔드 시각화 표시만 최적화합니다.

핵심 역할¶

• 가독성 향상: 의미 없는 원본 필드(예: container_id, host_id)를 업무 식별 가능한 이름으로 매핑합니다.

• 통일된 표시: 뷰 변수와 차트에 매핑된 이름을 동기화하여 대시보드 표시의 일관성을 보장합니다.

• 쿼리에 영향 없음: 프런트엔드 표시만 변경되며, 쿼리 시에는 여전히 원본 필드 값이 전달되므로 기존 쿼리문을 수정할 필요가 없습니다.

설정 전제 조건¶

1. 객체 클래스 데이터(기본 객체, 리소스 카탈로그)만 지원합니다. 메트릭, 로그, 이벤트 등 다른 데이터는 지원하지 않습니다.
2. 사용 전에 먼저 객체 클래스 필드를 기반으로 한 뷰 변수를 생성해야 합니다.
3. 동일한 객체 분류의 쿼리 필드는 중복 매핑을 지원하지 않으며, 이미 매핑된 필드는 드롭다운 목록에서 숨겨집니다.

구성 시작¶

1. 데이터 소스 선택(기본 객체 / 리소스 카탈로그)
2. 객체 분류 선택
3. 원본 쿼리 필드와 대상 매핑 필드 구성
4. 저장

예시: container_id를 container_name으로 매핑하여 표시합니다.

그러면 대시보드에서 뷰 변수 값은 container_name (container_id) 형식으로 표시되지만, 쿼리 시에는 여전히 container_id 값이 전달됩니다. 또한, 차트 설정에서 필드 매핑 기능을 활성화하면 차트의 범례에 매핑된 필드 값이 표시됩니다.

구성 관리¶

• 편집: 원본 필드와 매핑 필드의 대응 관계를 수정하며, 저장 후 즉시 적용됩니다.
• 삭제: 매핑 관계를 제거하면 프런트엔드에 원본 필드가 다시 표시됩니다.

사용 예시¶

객체 매핑은 두 가지 시나리오에 적용할 수 있습니다.

뷰 변수의 드롭다운 표시

차트의 표시

뷰 변수에 적용¶

변수 드롭다운 옵션이 "매핑 필드 (원본 필드)" 형식으로 표시되며, 선택 후 쿼리에는 여전히 원본 필드 값이 사용됩니다.

예시 설명:

1. 뷰 변수에 container_id 변수를 추가합니다.
2. 객체 매핑에서 container_id를 container_name으로 매핑하도록 설정합니다.
3. 그러면 뷰에서 변수가 container_name(container_id)로 표시됩니다.

차트에 적용¶

차트 고급 설정에서 필드 매핑 기능을 활성화하면 차트 범례와 데이터에 매핑된 이름이 표시됩니다.

예시 설명:

1. 객체 매핑에서 host를 name으로 매핑하도록 설정합니다.
2. 차트 > 고급 설정에서 필드 매핑을 활성화합니다.
3. 최종적으로 차트에 name(host) 형식으로 표시됩니다.