사용 통계
Offering: GitLab Self-Managed
GitLab Inc.는 다양한 작업을 수행하기 위해 인스턴스에 대한 정보를 주기적으로 수집합니다. 무료 GitLab Self-Managed 인스턴스의 경우 모든 사용 통계는 옵트아웃 방식입니다. Service Ping은 주간 페이로드를 수집하여 GitLab Inc.에 전송하는 프로세스입니다.
GitLab Inc.는 다양한 작업을 수행하기 위해 인스턴스에 대한 정보를 주기적으로 수집합니다.
무료 GitLab Self-Managed 인스턴스의 경우 모든 사용 통계는 옵트아웃 방식입니다.
Service Ping#
Service Ping은 주간 페이로드를 수집하여 GitLab Inc.에 전송하는 프로세스입니다. Service Ping이 활성화되면 GitLab이 다른 인스턴스에서 데이터를 수집하고 Service Ping에 의존하는 특정 인스턴스 수준 분석 기능을 활성화합니다.
Service Ping을 활성화하는 이유?#
Service Ping의 주요 목적은 더 나은 GitLab을 구축하는 것입니다. GitLab이 어떻게 사용되는지에 대한 데이터를 수집하여 기능 또는 Stage 채택 및 사용을 이해합니다. 이 데이터는 GitLab이 어떻게 가치를 추가하는지에 대한 통찰을 제공하고, 팀이 사람들이 GitLab을 사용하는 이유를 이해하는 데 도움을 주며, 이를 통해 더 나은 제품 결정을 내릴 수 있습니다.
Service Ping 활성화에는 몇 가지 다른 이점이 있습니다:
- 시간 경과에 따른 GitLab 설치의 사용자 활동을 분석합니다.
- 계획에서 모니터링까지 동시 DevOps의 인스턴스 전체 채택 개요를 제공하는 DevOps 점수.
- 수집된 데이터를 활용할 수 있는 고객 성공 매니저(CSM)를 통한 더 적극적인 지원.
- GitLab 투자에서 최대 가치를 얻는 방법에 대한 통찰 및 조언.
- 특정 조언 및 권장 사항과 함께 유사한 조직(익명화)과 비교를 보여주는 보고서.
- 무료 유료 기능을 받기 위한 Registration Features Program 참여.
Service Ping 설정#
GitLab은 Service Ping과 관련된 세 가지 설정을 제공합니다:
- Enable Service Ping: Service Ping 데이터를 GitLab에 전송할지 여부를 제어합니다.
- Enable Service Ping Generation: 인스턴스에서 Service Ping 데이터가 생성될지 여부를 제어합니다.
- Include optional data in Service Ping: Service Ping 데이터에 선택적 메트릭이 포함될지 여부를 제어합니다.
이 세 가지 설정은 다음과 같이 상호 작용합니다:
- Service Ping이 활성화되면 Service Ping Generation이 자동으로 활성화되고 비활성화할 수 없습니다.
- Service Ping이 비활성화되면 Service Ping Generation을 독립적으로 제어할 수 있습니다.
- Include optional data in Service Ping은 Service Ping 또는 Service Ping Generation 중 하나가 활성화된 경우에만 사용 가능합니다.
Registration Features Program#
GitLab 버전 14.1 이상에서 GitLab Enterprise Edition을 실행하는 GitLab Self-Managed 인스턴스를 가진 GitLab Free 고객은 등록 기능을 활성화하고 Service Ping을 통해 활동 데이터를 보내면 유료 기능을 받을 수 있습니다. 여기에 도입된 기능은 유료 티어에서 해당 기능을 제거하지 않습니다. 유료 티어의 인스턴스는 Cloud Licensing에서 관리하는 제품 사용 데이터 정책의 적용을 받습니다.
사용 가능한 기능#
다음 표에서 확인할 수 있습니다:
- Registration Features Program으로 사용 가능한 기능
- 기능을 사용할 수 있는 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 이상 |
| 서비스 수준 계약 카운트다운 타이머 | GitLab 16.6 이상 |
| 그룹의 프로젝트에 구성원 추가 방지 | GitLab 16.6 이상 |
| 사용자 및 권한 보고서 | GitLab 16.6 이상 |
| 고급 검색 | GitLab 16.6 이상 |
| DevOps 채택 | GitLab 16.6 이상 |
| 아티팩트 의존성이 있는 크로스 프로젝트 파이프라인 | GitLab 16.7 이상 |
| 기능 플래그 관련 이슈 | GitLab 16.7 이상 |
| Merged results 파이프라인 | GitLab 16.7 이상 |
| 외부 저장소용 CI/CD | GitLab 16.7 이상 |
| GitHub용 CI/CD | GitLab 16.7 이상 |
등록 기능 활성화#
- 관리자 액세스 권한이 있는 사용자로 로그인합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
- Usage statistics 섹션을 확장합니다.
- 활성화되어 있지 않은 경우 Enable Service Ping 체크박스를 선택합니다.
- Enable Registration Features 체크박스를 선택합니다.
- Save changes를 선택합니다.
버전 확인#
활성화된 경우 버전 확인은 새 버전이 사용 가능한지 여부와 상태를 통해 중요도를 알려줍니다. 상태는 모든 인증된 사용자의 도움말 페이지(/help)와 Admin 영역 페이지에 표시됩니다. 상태는 다음과 같습니다:
- 녹색: GitLab의 최신 버전을 실행 중입니다.
- 주황색: GitLab의 업데이트된 버전이 사용 가능합니다.
- 빨간색: 실행 중인 GitLab 버전이 취약합니다. 가능한 한 빨리 보안 수정이 포함된 최신 버전을 설치해야 합니다.

버전 확인 활성화 또는 비활성화#
사전 요구 사항:
- 관리자 액세스.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
- Usage statistics를 확장합니다.
- Enable version check 체크박스를 선택하거나 지웁니다.
- Save changes를 선택합니다.
요청 흐름 예시#
다음 예시는 인스턴스와 GitLab Version Application 간의 기본 요청/응답 흐름을 보여줍니다:
소스 코드 보기
%%{init: { "fontFamily": "GitLab Sans" }}%%
sequenceDiagram
accTitle: Version check process
accDescr: The GitLab instance queries the version application for updates and receives a status response as an image file.
participant GitLab instance
participant Version application
GitLab instance->>Version application: Is there a version update?
Version application->>GitLab instance: Response (PNG/SVG)</code></pre></details></div>
네트워크 구성#
GitLab Inc.에 사용 통계를 전송하려면 GitLab 인스턴스에서 포트 443의 version.gitlab.com 호스트로 네트워크 트래픽을 허용해야 합니다.
GitLab 인스턴스가 프록시 뒤에 있는 경우 적절한
프록시 구성 변수를 설정합니다.
Service Ping 활성화 또는 비활성화#
Note
Service Ping을 완전히 비활성화할 수 있는지 여부는 인스턴스의 티어와 특정 라이선스에 따라 다릅니다.
Service Ping 설정은 데이터가 GitLab과 공유되는지 또는 인스턴스의 내부 사용에만 제한되는지를 제어합니다.
Service Ping을 비활성화하더라도 gitlab_service_ping_worker 백그라운드 job은 여전히 주기적으로 인스턴스의 Service Ping 페이로드를 생성합니다.
페이로드는 Metrics and profiling 관리 섹션에서 사용할 수 있습니다.
UI를 통해#
사전 요구 사항:
- 관리자 액세스.
Service Ping을 활성화하거나 비활성화하려면:
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
- Usage statistics를 확장합니다.
- Enable Service Ping 체크박스를 선택하거나 지웁니다.
- Save changes를 선택합니다.
구성 파일을 통해#
Admin 영역을 통해 Service Ping을 비활성화하고 향후 구성되지 않도록 하려면:
-
/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
Service Ping Generation 활성화 또는 비활성화#
Service Ping Generation은 인스턴스에서 Service Ping 데이터가 자동으로 생성되는지 여부를 제어합니다. 활성화되면 GitLab은 주기적으로 사용 통계가 포함된 Service Ping 페이로드를 생성합니다. 이 설정은 데이터가 GitLab과 공유되는지 여부와 독립적으로 작동합니다.
UI를 통해#
사전 요구 사항:
- 관리자 액세스.
Service Ping Generation을 활성화하거나 비활성화하려면:
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling을 선택합니다.
- Usage statistics를 확장합니다.
- Enable Service Ping Generation 체크박스를 선택하거나 지웁니다.
- Enable Service Ping이 선택된 경우 이 설정은 자동으로 활성화되고 상호 작용에서 비활성화됩니다.
- Enable Service Ping이 지워진 경우 이 설정을 독립적으로 제어할 수 있습니다.
- Save changes를 선택합니다.
구성 파일을 통해#
구성을 통해 Service Ping Generation을 제어하려면:
-
/etc/gitlab/gitlab.rb를 편집합니다:
gitlab_rails['usage_ping_enabled'] = false
gitlab_rails['usage_ping_generation_enabled'] = false
-
GitLab 재설정:
sudo gitlab-ctl reconfigure
-
/home/git/gitlab/config/gitlab.yml을 편집합니다:
production: &base
# ...
gitlab:
# ...
usage_ping_enabled: false
usage_ping_generation_enabled: false
-
GitLab 재시작:
sudo service gitlab restart
Service Ping의 선택적 데이터 활성화 또는 비활성화#
GitLab은 운영 및 선택적 수집 데이터를 구분합니다.
Note
Include optional data in Service Ping 옵션은 Enable Service Ping 또는 Enable Service Ping Generation 중 하나가 활성화된 경우에만 사용 가능합니다. 두 설정이 모두 비활성화되면 이 옵션도 자동으로 비활성화됩니다.
UI를 통해#
사전 요구 사항:
- 관리자 액세스.
Service Ping의 선택적 데이터를 활성화하거나 비활성화하려면:
- 오른쪽 상단에서 Admin을 선택합니다.
- Settings > Metrics and Profiling으로 이동합니다.
- Usage Statistics 섹션을 확장합니다.
- Enable Service Ping 또는 Enable Service Ping Generation 체크박스가 선택되어 있는지 확인합니다.
- 선택적 데이터를 활성화하려면 Include optional data in Service Ping 체크박스를 선택합니다. 비활성화하려면 체크박스를 지웁니다.
- Save Changes를 선택합니다.
구성 파일을 통해#
-
/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
Service Ping 페이로드 액세스#
Admin 영역이나 API를 통해 GitLab Inc.에 전송되는 정확한 JSON 페이로드에 액세스할 수 있습니다.
UI에서#
- 관리자 액세스 권한이 있는 사용자로 로그인합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling > Usage statistics를 선택합니다.
- Preview payload를 선택합니다.
API를 통해#
service ping API 문서를 참조하세요.
Service Ping 페이로드 수동 업로드#
인스턴스에 인터넷 액세스가 없거나 Service Ping 크론 job이 활성화되지 않은 경우에도 Service Ping 페이로드를 GitLab에 업로드할 수 있습니다.
페이로드를 수동으로 업로드하려면:
- 관리자 액세스 권한이 있는 사용자로 로그인합니다.
- 오른쪽 상단에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Metrics and profiling > Usage statistics를 선택합니다.
- Download payload를 선택합니다.
- JSON 파일을 저장합니다.
- Service usage data center를 방문합니다.
- Choose file을 선택한 다음 다운로드된 페이로드가 포함된 JSON 파일을 선택합니다.
- Upload를 선택합니다.
업로드된 파일은 암호화되어 안전한 HTTPS 프로토콜을 사용하여 전송됩니다. HTTPS는 웹 브라우저와 서버 간의 안전한 통신 채널을 만들고 전송된 데이터를 중간자 공격으로부터 보호합니다.
수동 업로드에 문제가 있는 경우:
- version app 프로젝트의 보안 포크에서 기밀 이슈를 엽니다.
- 가능하면 JSON 페이로드를 첨부합니다.
- 이슈를 분류할
@gitlab-org/analytics-section/analytics-instrumentation을 태그합니다.
