Red Hat Summit8장. 빌드 컨트롤러 관찰 기능
OpenShift 빌드에서는 빌드 리소스의 성능 및 기능을 모니터링하는 데 도움이 되는 여러 메트릭을 노출합니다. 빌드 컨트롤러 메트릭은 포트 8383 에 노출됩니다.
OpenShift 빌드에서는 빌드 컨트롤러에서 pprof 모드를 활성화하는 프로파일링 기능도 제공합니다.
8.1. 빌드 컨트롤러 메트릭
모니터링 목적으로 다음 빌드 컨트롤러 메트릭을 확인할 수 있습니다.
| 이름 | 유형 | 설명 | 라벨 | 상태 |
|---|---|---|---|---|
|
| 카운터 | 전체 등록된 빌드 수입니다. |
| 실험적 |
|
| 카운터 | 전체 완료된 빌드 실행 수입니다. |
| 실험적 |
|
| 히스토그램 | 빌드 실행 시 지속 시간을 초 단위로 설정합니다. |
| 실험적 |
|
| 히스토그램 | 빌드 실행 완료 기간(초)입니다. |
| 실험적 |
|
| 히스토그램 | 빌드는 초 단위의 ramp-up 기간을 실행합니다. |
| 실험적 |
|
| 히스토그램 | 작업 실행에 대한 빌드 실행 기간(초)입니다. |
| 실험적 |
|
| 히스토그램 | 작업 실행 Pod의 빌드 실행 시간(초)입니다. |
| 실험적 |
8.1.1. 히스토그램 메트릭
빌드 컨트롤러에 사용자 정의 버킷을 사용하려면 특정 히스토그램 지표에 대한 환경 변수를 설정해야 합니다. 다음 표에서는 모든 히스토그램 메트릭에 대한 환경 변수를 보여줍니다.
| 메트릭 | 환경 변수 | Default |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8.1.2. 히스토그램 버킷 구성
빌드 컨트롤러의 경우 환경 변수 값을 설정하여 히스토그램 버킷을 구성할 수 있습니다. 빌드 컨트롤러를 로컬에서 실행할 때 환경 변수 값을 시작하기 직전에 설정합니다.
OpenShift Container Platform 클러스터에 빌드 컨트롤러를 배포할 때 controller.yaml 배포 파일에 환경 변수를 추가해야 합니다. 환경 변수 값은 쉼표로 구분된 숫자 목록이어야 합니다.
프로세스
다음 예와 같이
controller.yaml배포 파일의spec.containers[0].spec.env섹션에 환경 변수의 항목을 추가합니다.# ... env: - name: PROMETHEUS_BR_COMP_DUR_BUCKETS value: "30,60,90,120,180,240,300,360,420,480" # ...# ... env: - name: PROMETHEUS_BR_COMP_DUR_BUCKETS value: "30,60,90,120,180,240,300,360,420,480" # ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow
8.1.3. 메트릭 라벨 구성
PROMETHEUS_ENABLED_LABELS 환경 변수를 구성하여 사용할 메트릭 레이블을 활성화할 수 있습니다. 지원되는 지표 라벨은 다음과 같습니다.
-
buildstrategy -
네임스페이스 -
Build -
buildrun
OpenShift Container Platform 클러스터에 빌드 컨트롤러를 배포할 때 controller.yaml 배포 파일에 환경 변수를 추가해야 합니다. 쉼표로 구분된 값 목록을 사용하여 mutiple 메트릭 레이블을 활성화할 수도 있습니다.
프로세스
단일 메트릭 레이블을 활성화하려면
controller.yaml배포 파일의spec.containers[0].spec.env섹션에 다음 항목을 추가합니다.# ... env: - name: PROMETHEUS_ENABLED_LABELS value: namespace # ...# ... env: - name: PROMETHEUS_ENABLED_LABELS value: namespace # ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow 여러 메트릭 레이블을 활성화하려면
controller.yaml배포 파일의spec.containers[0].spec.env섹션에 다음 항목을 추가합니다.# ... env: - name: PROMETHEUS_ENABLED_LABELS value: buildstrategy,namespace,build # ...# ... env: - name: PROMETHEUS_ENABLED_LABELS value: buildstrategy,namespace,build # ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}