파이프라인 실행 패싯

문서 > 지속적 통합 가시성 > Continuous Integration Visibility Explorer > 파이프라인 실행 패싯

개요

패싯은 파이프라인의 사용자 정의 태그 및 속성입니다. 이는 정성적 및 정량적 데이터 분석 모두에 유용합니다. 패싯을 사용하면 CI 파이프라인 모니터링과 대시보드 및 노트북에 표시되는 검색 쿼리에서 파이프라인을 조작할 수 있습니다.

파이프라인 실행 검색에는 패싯 생성이 필요하지 않습니다. 자동 완성 기능은 기존 패싯을 사용하지만 들어오는 파이프라인 실행과 일치하는 모든 입력에도 적용됩니다.

일반 패싯

Software Delivery > CI Visibility > Executions로 이동하여 파이프라인 실행 목록의 왼쪽 패싯 목록에 액세스합니다.

CI Visibility Explorer에는 다음과 같은 기본 패싯이 포함되어 있습니다.

패싯	설명
CI 제공업체	CI 제공업체 이름(GitHub, GitLab 등).
파이프라인 이름	CI 파이프라인 이름
노드 이름	파이프라인, 단계 또는 작업을 실행한 CI 노드의 이름.
노드 라벨	파이프라인, 단계 또는 작업을 실행한 CI 노드와 연결된 라벨
파이프라인 URL	파이프라인 실행을 위한 공급자 URL
파이프라인 ID	파이프라인 ID
파이프라인 번호	CI 제공자가 제공하는 CI 파이프라인의 실행 번호. 파이프라인을 부분적으로 재시도하면 증가합니다.
작업 URL	작업 실행을 위한 제공자 URL
단계 이름	CI 단계 이름
작업 이름	CI 작업 이름
Kubernetes 네임스페이스	Kubernetes Pod가 실행 중인 네임스페이스
Kubernetes 파드 이름	Kubernetes 파드 이름
이미지 태그	Kubernetes 컨테이너 이미지 태그
컨테이너 이름	Kubernetes 컨테이너 이름 태그
이미지 이름	Kubernetes 컨테이너 이미지 이름 태그
컨테이너 ID	Kubernetes 컨테이너 ID
Kubernetes 컨테이너 이름	Kubernetes 컨테이너 이름
Kubernetes 배포	파드가 속한 Kubernetes 배포
Kubernetes 스테이트풀셋	파드가 속한 Kubernetes 스테이트풀셋
리포지토리 URL	Git 리포지토리 URL
리포지토리 ID	Git 리포지토리를 고유하게 식별하는 ID
커밋 SHA	Git Commit SHA
Branch	Git Branch.
태그	Git 태그
작성자 이메일	Git 작성자 이메일
커미터 이메일	Git 커미터 이메일
커미터 날짜	Git 커미터 날짜
작성자 날짜	Git 작성자 날짜
Env	CI 파이프라인이 실행되는 환경
리소스	CI 파이프라인에서 활용하는 리소스
오퍼레이션 이름	CI 파이프라인 내에서 수행되는 작업
오류 유형	CI 실행 중에 발생한 오류 유형
유형	CI 실행 또는 엔터티의 유형
완전한 트레이스	CI 파이프라인 실행의 전체 트레이스
기간	실행 시간(초)
버전	사용된 CI 파이프라인 또는 도구의 버전
Is Default Branch	Git 리포지토리의 기본 브랜치에서 실행이 실행되었는지 여부를 나타냄

CI Visibility Explore에서 패싯을 사용하여 다음을 수행할 수 있습니다.

파이프라인 실행 검색 및 필터링
파이프라인 분석 수행
파이프라인 완료 후 트러블슈팅 시작

정성적 패싯

다음의 경우 정성적 패싯을 사용하세요.

값의 상대적 인사이트 얻기
고유 값 개수 세기
특정 값에 대해 파이프라인 실행을 자주 필터링하세요.예를 들어 환경 태그에 패싯을 생성하여 트러블슈팅 범위를 개발, 스테이징 또는 프로덕션 환경까지 확장할 수 있습니다.

참고: 태그 필터링에는 패싯이 필요하지 않지만 조사 중에 자주 사용하는 태그에 대한 패싯을 정의하면 해결 시간을 줄이는 데 도움이 될 수 있습니다.

정량적 측정값

다음의 경우 정량적 측정을 사용하세요.

여러 파이프라인 실행의 값을 집계.
파이프라인 실행의 필터링 범위를 설정.
해당 값에 따라 파이프라인 실행을 정렬.

유형

측정값은 동등한 기능에 대해 긴 정수 또는 이중 값을 갖습니다.

단위

측정값은 쿼리 시간 및 표시 시간에서 자릿수를 처리하기 위한 단위(초 단위의 시간 또는 바이트 단위의 크기)를 지원합니다. 단위는 필드가 아닌 측정값 자체의 속성입니다.

예를 들어, 나노초 단위의 duration 측정값을 고려해보세요. service:A의 파이프라인 실행이 duration:10000000(10 milliseconds)라고 가정하고 service:B의 파이프라인 실행이 duration:5000000(5 milliseconds)라고 가정해 봅니다. duration:>2ms를 사용하여 두 서비스의 파이프라인 실행 태그를 한 번에 일관되게 쿼리할 수 있습니다. 검색 쿼리에 대한 자세한 내용은 검색 구문을 참조하세요.

패싯 패널

검색창은 데이터를 필터링하고 그룹화하기 위한 가장 포괄적인 상호 작용 세트를 제공합니다. 그러나 대부분의 경우 패싯 패널은 데이터를 탐색하는 간단한 방법입니다. 현재 쿼리 범위에 대한 콘텐츠 요약을 보려면 패싯을 엽니다.

검색 창과 URL은 패싯 패널의 선택 사항을 자동으로 반영합니다.

**패싯(정성적)**에는 고유한 값의 상위 목록과 각 값과 일치하는 파이프라인 실행 수가 함께 제공됩니다.
**측정값(정량적)**에는 최소값과 최대값을 나타내는 슬라이더가 함께 제공됩니다. 슬라이더를 사용하거나 숫자 값을 입력하여 검색 쿼리 범위를 다른 범위로 지정하세요.

패싯 그룹화

패싯은 패싯 목록에서 의미 있는 테마로 그룹화됩니다. 패싯에 대한 그룹을 할당하거나 재할당하면 패싯 목록에만 영향을 미치며 검색이나 분석에는 영향을 미치지 않습니다.

패싯 필터링

패싯 패널의 검색 패싯 상자를 사용하여 전체 패싯 목록의 범위를 지정하고 상호 작용해야 하는 패싯으로 이동합니다. 검색 패싯은 패싯 표시 이름과 필드 이름을 사용하여 결과 범위를 지정합니다.

패싯 생성

파이프라인 실행 검색을 위해 반드시 파이프라인 실행 속성/태그에 패싯을 생성해야 하는 것은 아닙니다. 특정 파이프라인 실행 속성에 의미 있는 설명을 추가하고 싶거나 패싯 목록에 속성 값을 표시하고 싶은 경우에 패싯을 사용하면 유용합니다.

파이프라인 실행 사이드 패널에서 패싯 생성

파이프라인 생성 사이드 패널에서 패싯을 추가하면 대부분의 패싯 세부정보가 미리 채워져 쉽게 패싯을 생성할 수 있습니다.

패싯을 생성할 필드가 포함된 CI Visibility Explorer에서 관심 있는 파이프라인 실행으로 이동합니다.
목록에서 파이프라인 실행을 선택하여 파이프라인 실행 사이드 패널을 엽니다.
원하는 필드(파이프라인 실행 스팬의 경우 정보 탭)를 클릭하고 다음과 같이 패싯을 생성합니다.
- 필드에 숫자 값이 있는 경우 패싯 또는 측정값을 생성할 수 있습니다.
- 필드에 문자열 값이 있는 경우 패싯 생성만 사용할 수 있습니다.