사용 통계

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

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

자체 관리형 무료 인스턴스의 경우 모든 사용 통계가 자체 서비스 핑 활성화/비활성화로 설정되어 있습니다. 다른 Tier에 대한 정보는 고객 제품 사용 정보를 참조하십시오.

서비스 핑

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

서비스 핑을 활성화하는 이유

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

서비스 핑을 활성화하는 여러 가지 이점이 있습니다:

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

등록 기능 프로그램

GitLab 14.1 이상 버전에서 GitLab Enterprise Edition을 실행하는 자체 관리형 인스턴스의 GitLab Free 고객은 GitLab에 등록하고 서비스 핑을 통해 활동 데이터를 보내면 유료 기능을 받을 수 있습니다. 여기서 소개된 기능은 해당 기능을 유료 Tier에서 제거하지 않습니다. 유료 Tier의 인스턴스는 저희의 제품 사용 데이터 정책에 따라 Cloud Licensing에서 관리됩니다.

참고: 참여를 위해 등록이 필요하지 않습니다.

사용 가능한 기능

다음 테이블에서 다음을 볼 수 있습니다:

  • 등록 기능 프로그램으로 제공되는 기능
  • 해당 기능이 제공되는 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 Inc.에 사용량 통계를 보내려면 GitLab 인스턴스에서 호스트 version.gitlab.com의 포트 443으로의 네트워크 트래픽을 허용해야 합니다.

만약 GitLab 인스턴스가 프록시 뒤에 있다면 적절한 프록시 구성 변수를 설정하세요.

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

참고: 서비스 핑을 완전히 비활성화할 수 있는지는 인스턴스의 티어 및 특정 라이선스에 따라 달라집니다. 자세한 내용은 고객 제품 사용 정보를 참조하십시오. 서비스 핑 설정은 데이터가 GitLab과 공유되는지 또는 인스턴스에서 내부적으로만 사용되도록 제한되는지를 제어합니다. 서비스 핑을 비활성화하더라도 gitlab_service_ping_worker 백그라운드 잡은 주기적으로 인스턴스에 대한 서비스 핑 페이로드를 생성합니다. 이 페이로드는 사용 통계 및 프로파일링 관리자 섹션에서 사용 가능합니다.

UI를 통한 방법

서비스 핑을 활성화 또는 비활성화하려면:

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

구성 파일을 통한 방법

서비스 핑을 비활성화하고 앞으로 관리자 영역에서 구성하지 못하도록 하려면:

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은 운영 및 선택적 수집된 데이터 사이를구분합니다. 더 많은 정보는 고객 제품 사용 정보를 참조하십시오.

UI를 통한 방법

서비스 핑에서 선택적 데이터를 활성화 또는 비활성화하려면:

  1. 왼쪽 사이드바에서 아래쪽에서 관리자를 선택합니다.
  2. 설정 > 사용량 및 프로파일링으로 이동합니다.
  3. 사용 통계 섹션을 확장합니다.
  4. 선택적 데이터를 활성화하려면 서비스 핑에 선택적 데이터 포함 확인란을 선택하세요. 비활성화하려면 확인란을 해제하세요.
  5. 변경 사항 저장을 선택합니다.

구성 파일을 통한 방법

Linux 패키지 (Omnibus)

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

    gitlab_rails['include_optional_metrics_in_service_ping'] = false

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

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

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

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

  2. GitLab을 다시 시작합니다: 

    sudo service gitlab restart

서비스 핑 페이로드에 액세스

GitLab Inc.에 보낸 정확한 JSON 페이로드에 관리자 영역 또는 API를 통해 액세스할 수 있습니다. 서비스 핑 페이로드 예시를 참조하세요.

UI를 통한 방법

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

API를 통한 방법

서비스 핑 API 설명서를 참조하십시오.

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

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

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

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

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

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

  1. 버전 어플리케이션 프로젝트 보안 포크에서 비밀 이슈를 엽니다.
  2. 가능하다면 JSON 페이로드를 첨부합니다.
  3. 문제를 처리할 @gitlab-org/analytics-section/analytics-instrumentation를 태그합니다.