- 서비스 핑
- 등록 기능 프로그램
- 버전 확인
- 네트워크 구성
- 서비스 핑 활성화 또는 비활성화
- 서비스 핑에서 선택적 데이터 활성화 또는 비활성화
- 서비스 핑 페이로드 보기
- 서비스 핑 페이로드 매뉴얼으로 업로드
사용 통계
GitLab Inc.은 주기적으로 여러 작업을 수행하기 위해 인스턴스에 대한 정보를 수집합니다.
무료 Self-Managed형 인스턴스의 경우 모든 사용 통계는 opt-out 상태입니다. 다른 티어에 대한 정보는 고객 제품 사용 정보를 참조하세요.
서비스 핑
서비스 핑은 GitLab Inc.에 주간 데이터를 수집하고 전송하는 프로세스입니다. 자세한 내용은 서비스 핑 가이드를 참조하세요. 서비스 핑이 활성화되면 GitLab은 다른 인스턴스로부터 데이터를 수집하고 서비스 핑에 의존하는 특정 인스턴스 수준의 분석 기능을 활성화합니다.
서비스 핑 활성화의 이유
서비스 핑의 주요 목적은 더 나은 GitLab을 구축하는 것입니다. GitLab의 사용 방법에 대한 데이터를 수집하여 기능 또는 단계의 채택 및 사용을 이해합니다. 이러한 데이터는 GitLab이 어떻게 가치를 창출하며, 사람들이 GitLab을 사용하는 이유를 이해하는 데 도움이 되며, 이러한 지식을 바탕으로 더 나은 제품 결정을 내릴 수 있습니다.
서비스 핑을 활성화하는 것에는 몇 가지 추가 혜택이 있습니다:
- GitLab 설치의 사용자 활동을 시간별로 분석합니다.
- DevOps 점수를 통해 계획부터 모니터링까지의 전체 인스턴스의 동시적인 DevOps 채택 개요를 제공합니다.
- 더 적극적인 지원(저희 고객 성공 담당자 (CSM) 및 지원 조직이 데이터를 활용하여 추가 가치를 제공한다고 가정).
- GitLab에 대한 투자에서 가장 많은 가치를 얻는 방법에 대한 통찰과 조언을 제공합니다.
- 특정 조직과 비교하여 성능이 어떻게 되는지(익명화된 상태) 보여주는 보고서를 통해 DevOps 프로세스를 개선하는 데 대한 구체적인 조언과 권장 사항을 제공합니다.
- 무료 유료 기능을 받으려면 등록 기능 프로그램에 참여합니다.
등록 기능 프로그램
GitLab 14.1 버전 이후, GitLab Free 고객은 GitLab Enterprise Edition을 실행하는 Self-Managed형 인스턴스로 등록하고 서비스 핑을 통해 활동 데이터를 보내면 유료 기능을 받을 수 있습니다. 여기서 소개된 기능은 유료 티어의 기능을 제거하지 않습니다. 유료 티어의 인스턴스는 제품 사용 데이터 정책의 적용을 받으며 클라우드 라이선싱에서 관리됩니다.
사용 가능한 기능
다음 표에서 확인할 수 있습니다:
- 등록 기능 프로그램으로 제공되는 기능
- 해당 기능의 GitLab 버전
기능 | 사용 가능 버전 |
---|---|
GitLab에서 이메일 | GitLab 14.1 이후 |
리포지터리 크기 제한 | GitLab 14.4 이후 |
IP 주소에 의한 그룹 액세스 제한 | GitLab 14.4 이후 |
설명 변경 기록 보기 | GitLab 16.0 이후 |
유지 관리 모드 | GitLab 16.0 이후 |
구성 가능한 이슈 보드 | GitLab 16.0 이후 |
커버리지 유도 퍼징 테스트 | GitLab 16.0 이후 |
암호 복잡성 요구 사항 | GitLab 16.0 이후 |
그룹 위키 | GitLab 16.5 이후 |
이슈 분석 | GitLab 16.5 이후 |
이메일의 사용자 지정 추가 텍스트 | GitLab 16.5 이후 |
기여 분석 | GitLab 16.5 이후 |
그룹 파일 템플릿 | GitLab 16.6 이후 |
그룹 웹훅 | GitLab 16.6 이후 |
SLA 카운트 다운 타이머 | GitLab 16.6 이후 |
프로젝트 멤버십 잠금 | GitLab 16.6 이후 |
사용자 및 권한 보고서 | GitLab 16.6 이후 |
고급 검색 | GitLab 16.6 이후 |
DevOps 채택 | GitLab 16.6 이후 |
Artifact 의존성을 가진 프로젝트 간 파이프라인 | GitLab 16.7 이후 |
피처 플래그 관련 이슈 | GitLab 16.7 이후 |
Merge된 결과 파이프라인 | GitLab 16.7 이후 |
외부 리포지터리를 위한 CI/CD | GitLab 16.7 이후 |
GitHub를 위한 CI/CD | GitLab 16.7 이후 |
등록 기능 활성화
- 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
- 왼쪽 사이드바에서 Admin Area를 선택합니다.
- Settings > Metrics and profiling를 선택합니다.
- Usage statistics 섹션을 확장합니다.
- 활성화되지 않은 경우 Enable Service Ping 확인란을 선택합니다.
- Enable Registration Features 확인란을 선택합니다.
- Save changes를 선택합니다.
버전 확인
활성화된 경우 버전 확인은 새 버전의 유무와 중요성을 상태를 통해 알려줍니다. 상태는 모든 인증된 사용자를 위해 도움링크(/help
) 페이지 및 Admin Area 페이지에 표시됩니다. 상태는 다음과 같습니다:
- 녹색: 최신 버전의 GitLab을 실행 중입니다.
- 오렌지: GitLab의 업데이트된 버전이 사용 가능합니다.
- 빨강: 실행 중인 GitLab 버전이 취약합니다. 보안 문제를 수정한 최신 버전을 가능한 빨리 설치해야 합니다.
버전 확인 활성화 또는 비활성화
- 왼쪽 사이드바에서 Admin Area를 선택합니다.
- Settings > Metrics and profiling를 선택합니다.
- Usage statistics 섹션을 확장합니다.
- Enable version check 확인란을 선택 또는 선택 해제합니다.
- Save changes를 선택합니다.
요청 흐름 예제
다음 예제는 Self-Managed형 GitLab 인스턴스와 GitLab 버전 애플리케이션 간의 기본 요청/응답 흐름을 보여줍니다:
네트워크 구성
GitLab Inc.에 사용 통계를 보내려면 GitLab 인스턴스에서 호스트 version.gitlab.com
의 포트 443
로부터의 네트워크 트래픽을 허용해야 합니다.
만약 GitLab 인스턴스가 프록시 뒤에 있다면, 적절한 프록시 구성 변수를 설정하세요.
서비스 핑 활성화 또는 비활성화
gitlab_service_ping_worker
백그라운드 작업은 주기적으로 인스턴스용 서비스 핑 페이로드를 생성합니다.
이 페이로드는 메트릭 및 프로파일링 관리자 섹션에서 사용할 수 있습니다.UI를 통해
서비스 핑을 활성화 또는 비활성화하려면:
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 설정 > 메트릭 및 프로파일링을 선택합니다.
- 사용 통계를 확장합니다.
- 서비스 핑 활성화 확인란을 선택하거나 선택 해제합니다.
- 변경 사항 저장을 선택합니다.
구성 파일을 통해
서비스 핑을 비활성화하고 향후 관리 영역을 통해 구성하는 것을 방지하려면
-
/etc/gitlab/gitlab.rb
파일을 편집합니다:gitlab_rails['usage_ping_enabled'] = false
-
GitLab을 다시 구성합니다:
sudo gitlab-ctl reconfigure
-
/home/git/gitlab/config/gitlab.yml
파일을 편집합니다:production: &base # ... gitlab: # ... usage_ping_enabled: false
-
GitLab을 다시 시작합니다:
sudo service gitlab restart
서비스 핑에서 선택적 데이터 활성화 또는 비활성화
GitLab은 운영 및 선택적 수집 데이터를 구분합니다. 자세한 정보는 고객 제품 사용 정보를 참조하세요.
UI를 통해
서비스 핑에서 선택적 데이터를 활성화 또는 비활성화하려면:
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 설정 > 메트릭 및 프로파일링으로 이동합니다.
- 사용 통계 섹션을 확장합니다.
- 선택적 데이터를 활성화하려면 서비스 핑에서 선택적 데이터 포함 확인란을 선택하세요. 비활성화하려면 선택을 해제하세요.
- 변경 사항 저장을 선택합니다.
구성 파일을 통해
-
/etc/gitlab/gitlab.rb
파일을 편집합니다:gitlab_rails['include_optional_metrics_in_service_ping'] = false
-
GitLab을 다시 구성합니다:
sudo gitlab-ctl reconfigure
-
/home/git/gitlab/config/gitlab.yml
파일을 편집합니다:production: &base # ... gitlab: # ... include_optional_metrics_in_service_ping: false
-
GitLab을 다시 시작합니다:
sudo service gitlab restart
서비스 핑 페이로드 보기
GitLab Inc.에 전송된 정확한 JSON 페이로드를 관리자 영역에서 확인할 수 있습니다. 페이로드를 보려면:
- 관리자 권한이 있는 사용자로서 로그인합니다.
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 설정 > 메트릭 및 프로파일링 > 사용 통계를 선택합니다.
- 페이로드 미리 보기를 선택합니다.
예시 페이로드는 예시 서비스 핑 페이로드를 참조하세요.
서비스 핑 페이로드 매뉴얼으로 업로드
인스턴스가 인터넷 액세스 권한이 없거나 서비스 핑 cron job이 활성화되지 않은 경우에도 서비스 핑 페이로드를 GitLab에 업로드할 수 있습니다.
페이로드를 매뉴얼으로 업로드하려면:
- 관리자 권한이 있는 사용자로서 로그인합니다.
- 왼쪽 사이드바에서 가장 아래에서 관리 영역을 선택합니다.
- 설정 > 메트릭 및 프로파일링 > 사용 통계를 선택합니다.
- 페이로드 다운로드를 선택합니다.
- JSON 파일을 저장합니다.
- 서비스 사용 데이터 센터로 이동합니다.
- 파일 선택을 선택한 후 다운로드한 페이로드를 포함하는 JSON 파일을 선택합니다.
- 업로드를 선택합니다.
업로드된 파일은 암호화되어 안전한 HTTPS 프로토콜을 통해 전송됩니다. HTTPS는 웹 브라우저와 서버 간의 안전한 통신 채널을 생성하고 중간자 공격에 대비하여 전송된 데이터를 보호합니다.
매뉴얼 업로드에 문제가 있는 경우:
- 버전 앱 프로젝트의 보안 포크에서 기밀 문제를 엽니다.
- 가능한 경우 JSON 페이로드를 첨부합니다.
- 문제를 진단할
@gitlab-org/analytics-section/analytics-instrumentation
을 태그합니다.