로그

Tier: Ultimate Offering: GitLab.com, Self-managed Status: Beta

플래그: 이 기능의 사용 가능 여부는 피처 플래그로 제어됩니다. 자세한 정보는 이력을 참조하십시오. 이 기능은 테스트용으로 제공되지만 상용 환경에서 사용하기에는 준비되지 않았습니다.

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

로그 누적 제한

로그는 분당 최대 102,400바이트까지 수집됩니다. 제한을 초과하면 429 Too Many Requests 응답이 반환됩니다.

분당 1,048,576바이트로 제한을 증가하려면 GitLab 지원팀에 문의하십시오.

로깅 구성

프로젝트에 로깅을 활성화하려면 로깅을 구성하십시오.

구성 요구 사항:

  • 프로젝트의 유지 관리자 역할 이상이어야 합니다.
  1. 액세스 토큰을 만듭니다:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
    2. 설정 > 액세스 토큰을 선택합니다.
    3. api 범위와 Developer 역할 이상으로 액세스 토큰을 만듭니다. 나중을 위해 액세스 토큰 값을 저장합니다.

  2. GitLab 로그를 보내려면 응용 프로그램을 구성하십시오: 

    OTEL_EXPORTER = "otlphttp"
OTEL_EXPORTER_OTLP_ENDPOINT = "https://gitlab.example.com/api/v4/projects/<gitlab-project-id>/observability/"
OTEL_EXPORTER_OTLP_HEADERS = "PRIVATE-TOKEN=<gitlab-access-token>"

    다음 값을 사용하십시오:

    • gitlab.example.com - 자체 관리형 인스턴스의 호스트 이름 또는 gitlab.com
    • gitlab-project-id - 프로젝트 ID
    • gitlab-access-token - 생성한 액세스 토큰

프로젝트에 로그가 구성됩니다. 응용 프로그램을 실행하면 OpenTelemetry 익스포터가 로그를 GitLab으로 전송합니다.

로그 보기

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

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

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

속성으로 로그를 필터링하거나 검색 막대에서 로그 문자열을 쿼리할 수 있습니다. 상단의 로그 양 차트는 지정된 시간 기간 동안 수집된 로그 수를 보여줍니다.

로그 목록

로그 상세 정보 보기

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

로그 상세 정보

로그에 대한 이슈 생성

로그를 해결하거나 조사하기 위해 수행된 모든 조치를 추적하기 위해 이슈를 만들 수 있습니다. 로그에 대한 이슈를 만들려면 다음 단계를 수행합니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 로그를 선택합니다.
  3. 로그 목록에서 로그를 선택합니다.
  4. 상세 창에서 이슈 생성을 선택합니다.

이슈가 선택한 프로젝트에 생성되며 로그에서 정보가 미리 채워집니다. 이슈 제목과 설명을 편집할 수 있습니다.

로그와 관련된 이슈 보기

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 로그를 선택합니다.
  3. 로그 목록에서 로그를 선택합니다.
  4. 세부 사항 창에서 관련 이슈로 스크롤합니다.
  5. 이슈 세부 정보를 보려면 선택하십시오.