사용 통계

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

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형 인스턴스로 등록하고 서비스 핑을 통해 활동 데이터를 보내면 유료 기능을 받을 수 있습니다. 여기서 소개된 기능은 유료 티어의 기능을 제거하지 않습니다. 유료 티어의 인스턴스는 제품 사용 데이터 정책의 적용을 받으며 클라우드 라이선싱에서 관리됩니다.

note
참여를 위한 등록은 필요하지 않습니다.

사용 가능한 기능

다음 표에서 확인할 수 있습니다:

  • 등록 기능 프로그램으로 제공되는 기능
  • 해당 기능의 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 이후

등록 기능 활성화

  1. 관리자 액세스 권한이 있는 사용자로서 로그인합니다.
  2. 왼쪽 사이드바에서 Admin Area를 선택합니다.
  3. Settings > Metrics and profiling를 선택합니다.
  4. Usage statistics 섹션을 확장합니다.
  5. 활성화되지 않은 경우 Enable Service Ping 확인란을 선택합니다.
  6. Enable Registration Features 확인란을 선택합니다.
  7. Save changes를 선택합니다.

버전 확인

활성화된 경우 버전 확인은 새 버전의 유무와 중요성을 상태를 통해 알려줍니다. 상태는 모든 인증된 사용자를 위해 도움링크(/help) 페이지 및 Admin Area 페이지에 표시됩니다. 상태는 다음과 같습니다:

  • 녹색: 최신 버전의 GitLab을 실행 중입니다.
  • 오렌지: GitLab의 업데이트된 버전이 사용 가능합니다.
  • 빨강: 실행 중인 GitLab 버전이 취약합니다. 보안 문제를 수정한 최신 버전을 가능한 빨리 설치해야 합니다.

Orange version check example

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

  1. 왼쪽 사이드바에서 Admin Area를 선택합니다.
  2. Settings > Metrics and profiling를 선택합니다.
  3. Usage statistics 섹션을 확장합니다.
  4. Enable version check 확인란을 선택 또는 선택 해제합니다.
  5. Save changes를 선택합니다.

요청 흐름 예제

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

sequenceDiagram participant GitLab 인스턴스 participant 버전 애플리케이션 GitLab 인스턴스->>버전 애플리케이션: 버전 업데이트가 있나요? 버전 애플리케이션->>GitLab 인스턴스: 응답 (PNG/SVG)

네트워크 구성

GitLab Inc.에 사용 통계를 보내려면 GitLab 인스턴스에서 호스트 version.gitlab.com의 포트 443로부터의 네트워크 트래픽을 허용해야 합니다.

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

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

note
서비스 핑을 완전히 비활성화할 수 있는지는 인스턴스의 티어 및 특정 라이선스에 따라 다릅니다. 자세한 정보는 고객 제품 사용 정보를 참조하세요. 서비스 핑 설정은 데이터를 GitLab과 공유할지 또는 인스턴스에서만 내부적으로 사용할지를 제어합니다. 서비스 핑을 비활성화해도 gitlab_service_ping_worker 백그라운드 작업은 주기적으로 인스턴스용 서비스 핑 페이로드를 생성합니다. 이 페이로드는 메트릭 및 프로파일링 관리자 섹션에서 사용할 수 있습니다.

UI를 통해

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

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

구성 파일을 통해

서비스 핑을 비활성화하고 향후 관리 영역을 통해 구성하는 것을 방지하려면

Linux package (Omnibus)

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

    gitlab_rails['usage_ping_enabled'] = false

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

    sudo gitlab-ctl reconfigure
Self-compiled (source)

  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 package (Omnibus)

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

    gitlab_rails['include_optional_metrics_in_service_ping'] = false

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

    sudo gitlab-ctl reconfigure
Self-compiled (source)

  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 페이로드를 관리자 영역에서 확인할 수 있습니다. 페이로드를 보려면:

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

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

서비스 핑 페이로드 매뉴얼으로 업로드

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

페이로드를 매뉴얼으로 업로드하려면:

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

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

매뉴얼 업로드에 문제가 있는 경우:

  1. 버전 앱 프로젝트의 보안 포크에서 기밀 문제를 엽니다.
  2. 가능한 경우 JSON 페이로드를 첨부합니다.
  3. 문제를 진단할 @gitlab-org/analytics-section/analytics-instrumentation을 태그합니다.