사용 통계

Tier: Free, Premium, Ultimate Offering: Self-Managed

GitLab Inc.은 정기적으로 인스턴스에 관한 정보를 수집하여 다양한 작업을 수행합니다.

무료 자체 관리 인스턴스의 경우 옵트 아웃으로 모든 사용 통계가 수집됩니다. 다른 티어에 대한 정보는 고객 제품 사용 정보를 참조하십시오.

서비스 핑

서비스 핑은 매주 GitLab Inc.에 페이로드를 수집하여 보내는 프로세스입니다. 자세한 정보는 서비스 핑 가이드를 참조하십시오. 서비스 핑이 활성화되면 GitLab은 다른 인스턴스에서 데이터를 수집하고 서비스 핑에 의존하는 일부 인스턴스 수준의 분석 기능을 활성화합니다.

서비스 핑 활성화하는 이유

서비스 핑의 주요 목적은 더 나은 GitLab을 구축하는 것입니다. GitLab의 사용 방법에 대한 데이터를 수집하여 기능 또는 단계의 채택 및 사용을 이해합니다. 이러한 데이터는 GitLab이 어떻게 가치를 추가하고 사람들이 GitLab을 사용하는 이유를 이해하는 통찰을 제공하며 이러한 지식을 바탕으로 더 나은 제품 결정을 내릴 수 있습니다.

서비스 핑을 활성화하는 것에는 몇 가지 기타 이점이 있습니다.

  • 귀하의 GitLab 설치의 사용자 활동을 시간별로 분석합니다.
  • 계획부터 모니터링까지의 동시 DevOps의 전반적인 채택을 보여주는 DevOps 점수.
  • 보다 적극적인 지원(가정하에 우리 고객 성공 담당자(CSM) 및 지원 조직이 데이터를 활용하여 더 많은 가치를 제공한다고 가정).
  • GitLab 투자의 가장 많은 가치를 얻는 방법에 대한 통찰과 조언.
  • 특정 조직과 비교하여(익명화된) 어떻게 개선할지에 대한 특정 조억과 권고사항을 보여주는 보고서.
  • 무료 유료 기능을 받기 위해 등록 기능 프로그램에 참여.

등록 기능 프로그램

GitLab 버전 14.1 이상에서 GitLab 무료 고객이 GitLab 엔터프라이즈 에디션을 실행하는 자체 관리 인스턴스는 GitLab에 등록하고 활동 데이터를 서비스 핑을 통해 전송하여 유료 기능을받을 수 있습니다. 여기에 소개된 기능은 해당 기능을 유료 티어에서 제거하지 않습니다. 유료 티어에서는 제품 사용 데이터 정책에 준수합니다.

참고: 참여를 위해 등록은 필수가 아닙니다.

사용 가능한 기능

다음 표에서는 다음과 같은 기능을 볼 수 있습니다.

  • 등록 기능 프로그램으로 사용 가능한 기능
  • 해당 기능이 사용 가능한 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 이상
합병된 결과 파이프라인 GitLab 16.7 이상
외부 저장소용 CI/CD GitLab 16.7 이상
GitHub용 CI/CD GitLab 16.7 이상

등록 기능 활성화

  1. 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
  3. 설정 > 지표 및 프로파일링을 선택합니다.
  4. 사용 통계 섹션을 확장합니다.
  5. 활성화되지 않은 경우, 서비스 핑 활성화 확인란을 선택합니다.
  6. 등록 기능 활성화 확인란을 선택합니다.
  7. 변경 사항 저장을 선택합니다.

버전 확인

활성화된 경우, 버전 확인은 새 버전의 중요도와 함께 사용자에게 알립니다. 상태는 모든 인증된 사용자를 위한 도움말 페이지(/help) 및 관리 영역 페이지에 표시됩니다. 상태는 다음과 같습니다:

  • 녹색: GitLab의 최신 버전을 실행 중입니다.
  • 주황색: GitLab의 업데이트된 버전이 있습니다.
  • 빨강: 실행 중인 GitLab 버전에 취약점이 있습니다. 즉시 보안 패치가 적용된 최신 버전을 설치해야 합니다.

주황색 버전 확인 예시

버전 확인 활성화 또는 비활성화

  1. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
  2. 설정 > 지표 및 프로파일링을 선택합니다.
  3. 사용 통계를 확장합니다.
  4. 버전 확인 활성화 확인란을 선택하거나 선택 해제합니다.
  5. 변경 사항 저장을 선택합니다.

요청 흐름 예시

다음 예시는 자체 관리형 GitLab 인스턴스와 GitLab 버전 애플리케이션 간의 기본 요청/응답 흐름을 보여줍니다:

sequenceDiagram participant GitLab 인스턴스 participant 버전 애플리케이션 GitLab 인스턴스->>버전 애플리케이션: 새 버전이 있는지 확인합니까? 버전 애플리케이션->>GitLab 인스턴스: 응답 (PNG/SVG)

네트워크 구성

GitLab 인스턴스에서 GitLab Inc.로의 사용 통계 전송을 위해, 포트 443의 version.gitlab.com 호스트로부터의 네트워크 트래픽을 허용해야 합니다.

GitLab 인스턴스가 프록시 뒤에 있는 경우, 적절한 프록시 구성 변수를 설정하세요.

서비스 핑 활성화 또는 비활성화

UI를 통해

서비스 핑의 활성화 또는 비활성화:

  1. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
  2. 설정 > 지표 및 프로파일링을 선택합니다.
  3. 사용 통계를 확장합니다.
  4. 서비스 핑 활성화 확인란을 선택하거나 선택 해제합니다.
  5. 변경 사항 저장을 선택합니다.

참고: 서비스 핑 비활성화의 효과는 인스턴스의 티어에 따라 다릅니다. 자세한 내용은 고객 제품 사용 정보를 참조하십시오. 서비스 핑 설정은 데이터가 GitLab과 공유되는지 또는 인스턴스에서만 내부적으로 사용되도록 제한하는지를 제어합니다. 서비스 핑을 비활성화해도, gitlab_service_ping_worker 백그라운드 작업은 주기적으로 인스턴스용 서비스 핑 페이로드를 생성합니다. 페이로드는 지표 및 프로파일링 관리 섹션에서 사용 가능합니다.

구성 파일을 통해

참고: GitLab 구성 파일에서 서비스 핑 비활성화 방법은 GitLab 버전 9.3에서 13.12.3까지 작동하지 않습니다. 비활성화 방법에 대한 자세한 내용은 문제 해결을 참조하십시오.

서비스 핑을 비활성화하고 향후에 Admin 영역을 통해 구성되는 것을 막으려면 다음을 수행하세요.

Linux 패키지 (Omnibus)

  1. /etc/gitlab/gitlab.rb 파일을 편집합니다: 

    gitlab_rails['usage_ping_enabled'] = false

  2. GitLab을 다시 구성합니다: 

    sudo gitlab-ctl reconfigure
직접 컴파일한 경우 (소스)

  1. /home/git/gitlab/config/gitlab.yml 파일을 편집합니다: 

    production: &base
  # ...
  gitlab:
    # ...
    usage_ping_enabled: false

  2. GitLab을 재시작합니다: 

    sudo service gitlab restart

서비스 핑 페이로드 보기

GitLab Inc.에 전송된 정확한 JSON 페이로드를 관리 영역에서 확인할 수 있습니다. 페이로드를 보려면:

  1. 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
  3. 설정 > 지표 및 프로파일링 > 사용 통계를 선택합니다.
  4. 페이로드 미리보기를 선택합니다.

예시 페이로드는 서비스 핑 페이로드 예시를 참조하세요.

서비스 핑 페이로드 수동 업로드

  • GitLab 14.8에서 admin_application_settings_service_usage_data_center라는 플래그와 함께 도입. 기본적으로 비활성화됨.
  • GitLab 14.10에서 기능 플래그가 제거되었습니다.

인터넷 액세스가 없거나 서비스 핑 크론 작업이 활성화되지 않은 경우에도 서비스 핑 페이로드를 GitLab에 업로드할 수 있습니다.

페이로드를 수동으로 업로드하려면:

  1. 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
  3. 설정 > 지표 및 프로파일링 > 사용 통계를 선택합니다.
  4. 페이로드 다운로드를 선택합니다.
  5. JSON 파일을 저장합니다.
  6. 서비스 사용 데이터 센터를 방문합니다.
  7. 파일 선택을 선택한 후, 다운로드한 페이로드를 포함하는 JSON 파일을 선택합니다.
  8. 업로드를 선택합니다.

업로드된 파일은 암호화되어 안전한 HTTPS 프로토콜을 통해 전송됩니다. HTTPS는 웹 브라우저와 서버 간에 안전한 통신 채널을 생성하며 중간자 공격으로부터 전송된 데이터를 보호합니다.

수동 업로드에 문제가 있는 경우:

  1. version 애플리케이션 프로젝트의 보안 포크에서 비밀 이슈를 엽니다.
  2. 가능한 경우 JSON 페이로드를 첨부합니다.
  3. 문제를 정리할 @gitlab-org/analytics-section/analytics-instrumentation를 태그합니다.