대시보드를 Marketplace 제품에 포함
Foundry DevOps로 Quiver 대시보드를 Marketplace 제품에 포함하면 다른 환경에서 설치하여 재사용할 수 있습니다. 대시보드 버전의 템플릿화와 검증을 마친 뒤 제품에 추가합니다.
지원되는 구성
- Filter object set, 집합 연산과 연결 객체 집합 같은 객체 분석 카드
- 막대, 선과 히트 그리드 등 객체 기반 차트. 기반 transform table이 지원되는 Vega plot
- 이벤트 및 그룹 플롯을 포함한 시계열 차트와 플롯
- 대부분의 피벗 표 및 group by, join, filter 같은 변환을 가진 transform table
- 숫자, 문자열, 텍스트와 날짜/시각 카드
지원되는 카드라도 데이터에서 결정되는 열 이름이나 구형 시계열 기능 등 특정 설정에는 제한이 있습니다.
패키징용 버전 게시
- 대시보드 설정에서 Enable Marketplace templating을 켭니다.
- 머리글의 Run validation으로 호환성 문제를 확인합니다.
- 오류가 없으면 Publish 또는 Republish를 선택합니다. Marketplace에 사용할 수 있는 대시보드 버전도 함께 저장합니다.
- 그 버전을 새 제품 또는 기존 Marketplace 제품에 추가합니다.
검증 오류
| 오류 종류 | 의미와 대응 |
|---|---|
| Unsupported cards | 현재 Marketplace 템플릿화를 지원하지 않는 카드 |
| Unsupported configuration | 카드는 지원하지만 설정이 미지원. 오류가 지목한 옵션과 데이터 의존 설정 확인 |
| Unexpected errors | 앞선 문제를 해결한 뒤에도 남으면 Palantir Support에 문의 |
검증은 화면에 직접 보이는 카드만 검사하지 않습니다. 분석의 카드와 변환 논리 및 의존 관계도 고려하므로, 표시하지 않은 카드 때문에 실패할 수 있습니다. 오류가 지목한 카드의 전체 연결을 확인합니다.
분석 전체의 자동 검증
Global settings의 Enable Marketplace linting을 켜면 분석의 모든 대시보드를 템플릿화 대상으로 두고 작업 중 검증합니다. Save 옆 표시기에 상태와 오류 및 경고 수가 나타나며 선택하여 상세 내용을 볼 수 있습니다.
개별 대시보드에서는 해당 설정을 끌 수 있습니다.
설치할 환경에서 매핑할 입력
검증이 성공하면 View inputs가 나타납니다. 제품에 필요한 객체 유형, 객체 인스턴스, 함수와 링크 유형을 확인합니다. 객체 유형 입력 오른쪽의 Properties에 포인터를 놓으면 매핑할 속성 유형을 볼 수 있습니다.
Analysis History의 Dashboards 영역에서는 어떤 버전이 패키징 검증을 마쳤는지 확인합니다.
설치한 대시보드에서 새 분석 생성
기반 Quiver 분석 자체는 대시보드와 함께 패키징하지 않습니다. 설치된 대시보드에서 Create analysis from dashboard를 선택하면 새로운 분석을 만들 수 있습니다.
새 분석에는 대시보드 사본, 표시된 모든 카드와 그 상위 의존 관계가 들어갑니다. 이 분석과 그 대시보드들은 설치 리소스와 분리됩니다. 새 분석 수정은 설치한 대시보드를 바꾸지 않으며 설치한 대시보드 변경도 새 분석에 자동 반영되지 않습니다.
기능별 제한
시계열 Measures
대부분의 시계열 기능을 패키징할 수 있지만 이전 Measures 기능은 지원하지 않습니다.
- 시계열 기능과 변환에서 Measures 기능을 사용하지 않습니다.
- Transform table이나 객체 집합 보기에도 measure 열이 남아 있지 않아야 합니다. 표의 표시 설정에서 제거할 수 있습니다.
검증기가 measure 사용을 찾으면 해당 카드나 measure를 지목한 Unsupported configuration 오류를 표시합니다. 대신 센서 객체에서 시계열을 직접 가져오는 경로를 사용할 수 있습니다. Measures와 센서 객체의 관계를 확인합니다.
피벗 표
피벗 표 아래에 transform table이 있으면 열 이름과 행 연산의 호환 조건을 확인합니다.
- 입력 피벗 표에 column properties를 두지 않습니다. 이 속성들은 데이터에 따라 열이 생기게 합니다.
- 입력 피벗 표의 집계마다 고유하고 안정적인 레이블을 설정합니다.
피벗 표 아래에 Selected Object Set 카드가 있으면 패키징 전에 그 선택 데이터가 지워집니다.
Dataset 카드
Dataset 데이터형을 사용하는 카드도 패키징할 수 있지만 열 이름은 패키징과 설치 과정에서 바뀌지 않습니다. 다른 객체 유형으로 설치하면 dataset과 하위 카드가 열을 찾지 못해 로드에 실패할 수 있습니다.
Rename column names to API names를 켰다면 속성 유형의 API Name이, 끄면 기반 데이터셋의 열 이름이 원래 객체 유형에서 사용한 이름과 맞아야 합니다.