로그

Tier: Ultimate Offering: GitLab.com Status: Experiment
  • GitLab 16.10에 observability_logs라는 플래그로 도입되었습니다. 기본으로 비활성화되어 있습니다. 이 기능은 Experiment입니다.
이 기능은 GitLab.com에서만 사용할 수 있습니다. Self-Managed GitLab 및 GitLab Dedicated에서는 기본적으로 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

GitLab은 애플리케이션 및 인프라 로그 수집, 저장 및 분석을 지원합니다. GitLab Logging은 감시된 시스템의 운영 상태에 대한 통찰력을 제공합니다. 지정된 시간 범위 내 시스템 및 애플리케이션에 대해 더 많이 알아내기 위해 로그를 사용하세요.

로깅 구성

프로젝트에 로깅을 활성화하려면 다음을 수행하세요.

전제 조건:

  • 프로젝트에 대한 최소한 Maintainer 역할이 있어야 합니다.
  1. 액세스 토큰을 생성하고 로그를 활성화합니다:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
    2. Settings > Access Tokens를 선택합니다.
    3. 다음 스코프를 갖는 액세스 토큰을 생성합니다: read_api, read_observability, write_observability. 나중을 위해 액세스 토큰 값을 저장하세요.
    4. Monitor > Logs를 선택한 다음 Enable을 선택합니다.

  2. 응용 프로그램을 GitLab으로 로그를 보내도록 구성하려면 다음 환경 변수를 설정합니다. 

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

    다음 값을 사용하세요:

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

프로젝트에 대해 로깅이 구성되었습니다. 응용 프로그램을 실행하면 OpenTelemetry 내보내기기가 로그를 GitLab으로 전송합니다.

로그 보기

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

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

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

로그 목록

로깅 세부 정보

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

로그 세부 정보