GitLab

·

GitLab 운영 데이터를 수집하여 메트릭으로 Guance에 보고합니다.

설정¶

먼저 GitLab 서비스의 데이터 수집 기능을 활성화하고 허용 목록을 설정합니다. 자세한 절차는 다음 섹션을 참조하세요.

GitLab 설정을 완료한 후 DataKit을 구성합니다. GitLab 버전과 구성에 따라 수집되는 데이터가 다를 수 있습니다.

[[inputs.gitlab]]
    ## set true if you need to collect metric from url below
    enable_collect = true

    ## param type: string - default: http://127.0.0.1:80/-/metrics
    prometheus_url = "http://127.0.0.1:80/-/metrics"

    ## param type: string - optional: time units are "ms", "s", "m", "h" - default: 10s
    interval = "10s"

    ## datakit can listen to gitlab ci data at /v1/gitlab when enabled
    enable_ci_visibility = true

    ## Set true to enable election
    election = true

    ## Bearer token file for authentication
    bearer_token_file = ""

    ## HTTP headers
    [inputs.gitlab.http_headers]
    # X-Custom-Header = "custom-value"

    ## TLS configuration
    # tls_ca = "/path/to/ca.pem"
    # tls_cert = "/path/to/cert.pem"
    # tls_key = "/path/to/key.pem"
    # insecure_skip_verify = false

    ## extra tags for gitlab-ci data.
    ## these tags will not overwrite existing tags.
    [inputs.gitlab.ci_extra_tags]
    # some_tag = "some_value"
    # more_tag = "some_other_value"

    ## extra tags for gitlab metrics
    [inputs.gitlab.tags]
    # some_tag = "some_value"
    # more_tag = "some_other_value"

GitLab 데이터 수집 기능 활성화¶

다음과 같이 GitLab에서 Prometheus 데이터 수집 기능을 활성화합니다(영어 UI 기준).

• 관리자 계정으로 GitLab 인스턴스에 로그인합니다
• Admin Area > Settings > Metrics and profiling으로 이동합니다
• Metrics - Prometheus를 선택하고 Enable Prometheus Metrics, save change 순서로 클릭합니다
• GitLab 서비스를 다시 시작합니다

자세한 내용은 공식 구성 문서를 참조하세요.

데이터 액세스 허용 목록 구성¶

데이터 수집 기능만 활성화해서는 충분하지 않습니다. GitLab은 데이터 액세스를 엄격하게 관리하므로 액세스 클라이언트의 허용 목록도 구성해야 합니다.

• GitLab 구성 파일 /etc/gitlab/gitlab.rb를 편집하고 gitlab_rails['monitoring_whitelist'] = ['::1/128']를 찾아 배열에 DataKit 액세스 IP를 추가합니다(일반적으로 DataKit이 실행되는 호스트의 IP이며, GitLab이 컨테이너에서 실행되는 경우 환경에 맞는 IP를 추가하세요)
• GitLab 서비스를 다시 시작합니다

자세한 내용은 공식 구성 문서를 참조하세요.

GitLab CI 시각화 활성화¶

GitLab Webhook을 구성하면 GitLab CI를 시각화할 수 있습니다. DataKit에서 GitLab Webhook을 수신하는 기본 URL은 http://DataKit-IP:9529/v1/gitlab입니다.

GitLab 왼쪽 사이드바에서 Settings ➔ Webhooks로 이동합니다. URL을 위 주소로 설정하고 Trigger에서 Job events와 Pipeline events를 선택한 다음 Add webhook을 클릭합니다.

메트릭¶

아래에서 수집되는 모든 데이터에는 기본적으로 전역 선출 tag가 추가됩니다. 구성에서 추가 태그를 지정할 수도 있습니다.

• 구성의 [inputs.gitlab.tags]를 사용하여 GitLab 메트릭 데이터에 추가 태그를 지정할 수 있습니다.

[inputs.gitlab.tags]
# some_tag = "some_value"
# more_tag = "some_other_value"
# ...

• 구성의 [inputs.gitlab.ci_extra_tags]를 사용하여 GitLab CI 데이터에 추가 태그를 지정할 수 있습니다.

[inputs.gitlab.ci_extra_tags]
# some_tag = "some_value"
# more_tag = "some_other_value"
# ...

참고: GitLab CI가 정상적으로 작동하도록 GitLab CI 데이터에 지정한 extra tags는 기존 태그를 덮어쓰지 않습니다(아래 GitLab CI 태그 목록 참조).

gitlab¶

GitLab runtime metrics

gitlab_base¶

GitLab programming language level metrics

gitlab_http¶

GitLab HTTP metrics

로그¶

gitlab_pipeline¶

GitLab Pipeline event metrics

gitlab_job¶

GitLab Job Event metrics