로그


Tier: Ultimate
Offering: GitLab.com
Status: Experiment

이 기능은 GitLab.com에서만 사용할 수 있습니다. 온프레미스 GitLab 및 GitLab Dedicated에서는 기본적으로 이 기능을 사용할 수 없습니다. 이 기능은 제품으로 사용할 준비가 되지 않았습니다.

GitLab은 중앙 집중식 응용 프로그램 및 인프라 로그 수집, 저장 및 분석을 지원합니다. GitLab 로깅은 모니터링된 시스템의 운영 상태에 대한 통찰력을 제공합니다. 특정 시간 범위 내 시스템 및 응용 프로그램에 대해 자세히 알아보려면 로그를 사용하십시오.

로깅 구성

프로젝트에 로깅을 활성화하려면 로깅을 구성합니다.

전제 조건:

  • 프로젝트의 유지자 역할을 적어도 가지고 있어야 합니다.
  1. 액세스 토큰을 생성하고 로그를 활성화합니다:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
    2. 설정 > 액세스 토큰을 선택합니다.
    3. 다음 스코프를 가진 액세스 토큰을 생성하십시오: read_api, read_observability, write_observability. 나중에 액세스 토큰 값을 저장해 두십시오.
    4. 모니터 > 로그를 선택한 다음 활성화를 선택합니다.

  2. GitLab 로그를 전송하도록 애플리케이션을 구성하려면 다음 환경 변수를 설정하십시오: 

    OTEL_EXPORTER = "otlphttp"
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT = "https://observe.gitlab.com/v3/<namespace-id>/<gitlab-project-id>/ingest/logs"
OTEL_EXPORTER_OTLP_LOGS_HEADERS = "PRIVATE-TOKEN=<gitlab-access-token>"

    다음 값을 사용합니다:

    • namespace-id - 프로젝트를 포함하는 최상위 그룹 ID
    • gitlab-project-id - 프로젝트 ID
    • gitlab-access-token - 생성한 액세스 토큰

프로젝트에 대해 로그가 구성되었습니다. 애플리케이션을 실행하면 OpenTelemetry 익스포터가 로그를 GitLab으로 전송합니다.

로그 보기

지정된 프로젝트의 로그를 볼 수 있습니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 로그를 선택합니다.

로그 디렉터리이 표시됩니다. 현재 로그 날짜, 수준, 서비스 및 메시지가 지원됩니다. 로그 라인을 선택하여 해당 세부 정보를 볼 수 있습니다.

로그 디렉터리

로깅 세부정보

또한 메타데이터 및 리소스 속성과 같은 로그 라인 세부 정보를 볼 수도 있습니다.

로그 세부정보