• 로그 레벨
  • 기본 로그 레벨 재정의
• 로그 회전
• production_json.log
• production.log
• api_json.log
• application.log (폐기됨)
• application_json.log
• integrations_json.log
• kubernetes.log (deprecated)
• git_json.log
• audit_json.log
• Sidekiq logs
  • sidekiq.log
  • sidekiq_client.log
• gitlab-shell.log
• Gitaly 로그
  • grpc.log
  • gitaly_hooks.log
• Puma 로그
  • puma_stdout.log
  • puma_stderr.log
• repocheck.log
• importer.log
• exporter.log
• features_json.log
• ci_resource_groups_json.log
• auth.log
• auth_json.log
• graphql_json.log
• clickhouse.log
• migrations.log
• mail_room_json.log (기본값)
• web_hooks.log
• database_load_balancing.log
• zoekt.log
• elasticsearch.log
• exceptions_json.log
• service_measurement.log
• geo.log
• update_mirror_service_json.log
• llm.log
  • LLM 입력 및 출력 로깅
• epic_work_item_sync.log
• secret_push_protection.log
• 레지스트리 로그
• NGINX 로그
• Pages logs
• Let’s Encrypt logs
• Mattermost logs
• Workhorse logs
• PgBouncer logs
• PostgreSQL logs
• Prometheus logs
• Redis logs
• Alertmanager logs
• crond logs
• Grafana logs
• LogRotate logs
• GitLab Monitor logs
• GitLab Exporter
• GitLab agent server
• Praefect logs
• 백업 로그
• 성능 바 통계
• 로그 수집
  • 주요 로그 간략히 보기
  • GitLabSOS
  • Fast-stats
• 상관 ID로 관련 로그 항목 찾기

로그 시스템

GitLab에는 모든 것이 기록되는 고급 로그 시스템이 있어서 다양한 시스템 로그 파일을 사용하여 인스턴스를 분석할 수 있습니다. 로그 시스템은 감사 이벤트와 유사합니다.

시스템 로그 파일은 일반적으로 표준 로그 파일 형식의 일반 텍스트입니다. 이 가이드는 이러한 시스템 로그 파일을 읽고 사용하는 방법에 대해 다룹니다.

로깅 시스템 및 로그 사용에 대해 자세히 알아보기:

• Linux 패키지 설치에서 로깅 사용자 정의 로그 유지 기간 조정, 로그 전달, JSON에서 일반 텍스트 로깅으로 전환 등을 포함합니다.
• JSON 로그 구문 분석 방법.

로그 레벨

각 로그 메시지에는 중요도와 다소성을 나타내는 할당된 로그 레벨이 있습니다. 각 로거에는 할당된 최소 로그 레벨이 있습니다. 로거는 해당 로그 레벨이 최소 로그 레벨보다 크거나 같은 경우에만 로그 메시지를 발생시킵니다.

다음 로그 레벨이 지원됩니다:

GitLab 로거는 기본적으로 DEBUG로 설정되어 모든 로그 메시지를 발생시킵니다.

기본 로그 레벨 재정의

GITLAB_LOG_LEVEL 환경 변수를 사용하여 GitLab 로거의 최소 로그 레벨을 재정의할 수 있습니다. 유효한 값은 0부터 5까지의 값 또는 로그 레벨의 이름입니다.

예시:

GITLAB_LOG_LEVEL=info

일부 서비스의 경우이 설정에 영향을받지 않는 기타 로그 레벨이 적용됩니다. 이러한 서비스 중 일부에는 로그 레벨을 재정의하기 위한 전용 환경 변수가 있습니다. 예를 들어:

로그 회전

특정 서비스의 로그는 다음과 같은 방법으로 관리되고 회전될 수 있습니다:

• logrotate
• svlogd (runit의 서비스 로깅 데몬)
• logrotate 및 svlogd
• 또는 전혀 관리되지 않음

다음 표에는 포함된 서비스에 대한 로그 관리 및 로그 회전 책임 정보가 포함되어 있습니다. 로그가 svlogd로 관리됨으로 표시된 경우 로그는 current라는 파일에 작성됩니다. GitLab에 내장된 logrotate 서비스 는 runit에 의해 캡처되지 않는 모든 로그를 관리합니다.

production_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/production_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/production_json.log에 있습니다.

Lograge 덕분에 GitLab에서 받은 Rails 컨트롤러 요청에 대한 구조화된 로그가 포함되어 있습니다.

API에서의 요청은 api_json.log라는 별도의 파일에 로깅됩니다.

각 줄은 Elasticsearch 및 Splunk와 같은 서비스에서 인계할 수 있는 JSON을 포함합니다. 가독성을 위해 예제에는 줄 바꿈이 추가되었습니다.

{
  "method":"GET",
  "path":"/gitlab/gitlab-foss/issues/1234",
  "format":"html",
  "controller":"Projects::IssuesController",
  "action":"show",
  "status":200,
  "time":"2017-08-08T20:15:54.821Z",
  "params":[{"key":"param_key","value":"param_value"}],
  "remote_ip":"18.245.0.1",
  "user_id":1,
  "username":"admin",
  "queue_duration_s":0.0,
  "gitaly_calls":16,
  "gitaly_duration_s":0.16,
  "redis_calls":115,
  "redis_duration_s":0.13,
  "redis_read_bytes":1507378,
  "redis_write_bytes":2920,
  "correlation_id":"O1SdybnnIq7",
  "cpu_s":17.50,
  "db_duration_s":0.08,
  "view_duration_s":2.39,
  "duration_s":20.54,
  "pid": 81836,
  "worker_id":"puma_0"
}

이 예는 특정 이슈에 대한 GET 요청이었습니다. 각 줄에는 또한 다음과 같은 성능 데이터도 포함되어 있습니다.

• duration_s: 요청 검색에 소요된 총 시간
• queue_duration_s: GitLab Workhorse 내에서 대기 중인 총 시간
• view_duration_s: Rails 뷰 내의 총 시간
• db_duration_s: PostgreSQL에서 데이터를 검색하는 데 걸린 총 시간
• cpu_s: CPU에서 총 소요 시간
• gitaly_duration_s: Gitaly 호출에 의한 총 시간
• gitaly_calls: Gitaly로의 총 호출 횟수
• redis_calls: Redis로의 총 호출 횟수
• redis_duration_s: Redis에서 데이터를 검색하는 데 걸린 총 시간
• redis_read_bytes: Redis에서 읽은 총 바이트
• redis_write_bytes: Redis에 기록된 총 바이트
• pid: 워커의 Linux 프로세스 ID(워커 재시작 시 변경)
• worker_id: 워커의 논리적 ID(워커 재시작 시 변경되지 않음)

HTTP 전송을 통한 사용자 복제 및 가져오기 활동은 action: git_upload_pack으로 로그에 나타납니다.

또한 로그에는 원본 IP 주소(remote_ip), 사용자 ID(user_id), 사용자 이름(username)도 포함되어 있습니다.

/search와 같은 일부 엔드포인트는 고급 검색을 사용하는 경우 Elasticsearch에 요청을 보낼 수 있습니다. 이 경우 elasticsearch_calls 및 elasticsearch_call_duration_s가 추가로 기록됩니다. 이는 다음을 의미합니다.

• elasticsearch_calls: Elasticsearch로의 총 호출 횟수
• elasticsearch_duration_s: Elasticsearch 호출에 의한 총 소요 시간
• elasticsearch_timed_out_count: 시간 초과되어 부분적 결과를 반환한 Elasticsearch 호출의 총 횟수

ActionCable 연결 및 구독 이벤트도 이 파일에 로깅되며 이전 형식을 따릅니다. method, path, 및 format 필드는 해당되지 않으며 항상 비어 있습니다. ActionCable 연결 또는 채널 클래스는 controller로 사용됩니다.

{
  "method":null,
  "path":null,
  "format":null,
  "controller":"IssuesChannel",
  "action":"subscribe",
  "status":200,
  "time":"2020-05-14T19:46:22.008Z",
  "params":[{"key":"project_path","value":"gitlab/gitlab-foss"},{"key":"iid","value":"1"}],
  "remote_ip":"127.0.0.1",
  "user_id":1,
  "username":"admin",
  "ua":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:76.0) Gecko/20100101 Firefox/76.0",
  "correlation_id":"jSOIEynHCUa",
  "duration_s":0.32566
}

참고: 에러가 발생하는 경우, exception 필드에 class, message, 및 backtrace가 포함됩니다. 이전 버전에서는 exception.class 및 exception.message 대신 error 필드가 있었습니다. 예를 들어:

{
  "method": "GET",
  "path": "/admin",
  "format": "html",
  "controller": "Admin::DashboardController",
  "action": "index",
  "status": 500,
  "time": "2019-11-14T13:12:46.156Z",
  "params": [],
  "remote_ip": "127.0.0.1",
  "user_id": 1,
  "username": "root",
  "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:70.0) Gecko/20100101 Firefox/70.0",
  "queue_duration": 274.35,
  "correlation_id": "KjDVUhNvvV3",
  "queue_duration_s":0.0,
  "gitaly_calls":16,
  "gitaly_duration_s":0.16,
  "redis_calls":115,
  "redis_duration_s":0.13,
  "correlation_id":"O1SdybnnIq7",
  "cpu_s":17.50,
  "db_duration_s":0.08,
  "view_duration_s":2.39,
  "duration_s":20.54,
  "pid": 81836,
  "worker_id": "puma_0",
  "exception.class": "NameError",
  "exception.message": "undefined local variable or method `adsf' for #<Admin::DashboardController:0x00007ff3c9648588>",
  "exception.backtrace": [
    "app/controllers/admin/dashboard_controller.rb:11:in `index'",
    "ee/app/controllers/ee/admin/dashboard_controller.rb:14:in `index'",
    "ee/lib/gitlab/ip_address_state.rb:10:in `with'",
    "ee/app/controllers/ee/application_controller.rb:43:in `set_current_ip_address'",
    "lib/gitlab/session.rb:11:in `with_session'",
    "app/controllers/application_controller.rb:450:in `set_session_storage'",
    "app/controllers/application_controller.rb:444:in `set_locale'",
    "ee/lib/gitlab/jira/middleware.rb:19:in `call'"
  ]
}

production.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/production.log에 있습니다.
• 직접 컴파일하여 설치한 경우 /home/git/gitlab/log/production.log에 있습니다.

여기에는 수행된 모든 요청에 대한 정보가 포함되어 있습니다. URL 및 요청 유형, IP 주소, 그리고 이 특정 요청을 처리하는 데 사용된 코드 부분을 확인할 수 있습니다. 또한 수행된 모든 SQL 요청과 각각이 소요한 시간도 볼 수 있습니다. 이 작업은 GitLab 기여자 및 개발자에게 더 유용합니다. 버그를 보고할 때 이 로그 파일의 일부를 사용하세요. 예를 들면:

Started GET "/gitlabhq/yaml_db/tree/master" for 168.111.56.1 at 2015-02-12 19:34:53 +0200
Processing by Projects::TreeController#show as HTML
  Parameters: {"project_id"=>"gitlabhq/yaml_db", "id"=>"master"}

  ... [CUT OUT]

  Namespaces"."created_at" DESC, "namespaces"."id" DESC LIMIT 1 [["id", 26]]
  CACHE (0.0ms) SELECT  "members".* FROM "members"  WHERE "members"."source_type" = 'Project' AND "members"."type" IN ('ProjectMember') AND "members"."source_id" = $1 AND "members"."source_type" = $2 AND "members"."user_id" = 1  ORDER BY "members"."created_at" DESC, "members"."id" DESC LIMIT 1  [["source_id", 18], ["source_type", "Project"]]
  CACHE (0.0ms) SELECT  "members".* FROM "members"  WHERE "members"."source_type" = 'Project' AND "members".
  (1.4ms) SELECT COUNT(*) FROM "merge_requests"  WHERE "merge_requests"."target_project_id" = $1 AND ("merge_requests"."state" IN ('opened','reopened')) [["target_project_id", 18]]
  Rendered layouts/nav/_project.html.haml (28.0ms)
  Rendered layouts/_collapse_button.html.haml (0.2ms)
  Rendered layouts/_flash.html.haml (0.1ms)
  Rendered layouts/_page.html.haml (32.9ms)
Completed 200 OK in 166ms (Views: 117.4ms | ActiveRecord: 27.2ms)

이 예에서 서버는 IP 168.111.56.1에서 2015-02-12 19:34:53 +0200에 URL이 /gitlabhq/yaml_db/tree/master인 HTTP 요청을 처리했습니다. 요청은 Projects::TreeController에서 처리되었습니다.

api_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/api_json.log에 있습니다.
• 직접 컴파일하여 설치한 경우 /home/git/gitlab/log/api_json.log에 있습니다.

이 파일을 사용하여 API에 직접적으로 수행된 요청을 확인할 수 있습니다. 예를 들면:

{
  "time":"2018-10-29T12:49:42.123Z",
  "severity":"INFO",
  "duration":709.08,
  "db":14.59,
  "view":694.49,
  "status":200,
  "method":"GET",
  "path":"/api/v4/projects",
  "params":[{"key":"action","value":"git-upload-pack"},{"key":"changes","value":"_any"},{"key":"key_id","value":"secret"},{"key":"secret_token","value":"[FILTERED]"}],
  "host":"localhost",
  "remote_ip":"::1",
  "ua":"Ruby",
  "route":"/api/:version/projects",
  "user_id":1,
  "username":"root",
  "queue_duration":100.31,
  "gitaly_calls":30,
  "gitaly_duration":5.36,
  "pid": 81836,
  "worker_id": "puma_0",
  ...
}

이 항목은 내부 엔드포인트에 액세스하여 해당 프로젝트를 git fetch 또는 git clone을 사용하여 다운로드할 수 있는지 확인하는데 사용된 것을 보여줍니다. 이 예에서는:

• duration: 요청 검색에 소요된 총 시간(밀리초)
• queue_duration: 요청이 GitLab Workhorse 내에서 대기열에 들어간 총 시간(밀리초)
• method: 요청을 만들 때 사용된 HTTP 메소드
• path: 쿼리의 상대 경로
• params: 쿼리 문자열 또는 HTTP 본문에 전달된 키-값 쌍(비밀번호 및 토큰과 같이 민감한 매개변수는 필터링됨)
• ua: 요청자의 User-Agent

참고: Grape Logging v1.8.4 기준으로 duration_s - db_duration_s에 의해 view_duration_s가 계산됩니다. 따라서 view_duration_s는 직렬화 프로세스 외에도 Redis나 외부 HTTP에서의 읽기-쓰기 프로세스와 같은 여러 가지 다른 요인에 영향을 받을 수 있습니다.

application.log (폐기됨)

• GitLab 15.10에서 폐기됨.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/application.log에 있습니다.
• 직접 컴파일하여 설치한 경우 /home/git/gitlab/log/application.log에 있습니다.

이 파일에는 application_json.log에 있는 로그를 조금 덜 구조화된 형식으로 포함하고 있습니다. 다음과 같은 예시가 있습니다:

October 06, 2014 11:56: User "Administrator" (admin@example.com) was created
October 06, 2014 11:56: Documentcloud created a new project "Documentcloud / Underscore"
October 06, 2014 11:56: Gitlab Org created a new project "Gitlab Org / Gitlab Ce"
October 07, 2014 11:25: User "Claudie Hodkiewicz" (nasir_stehr@olson.co.uk)  was removed
October 07, 2014 11:25: Project "project133" was removed

application_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/application_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/application_json.log에 있습니다.

사용자 생성 및 프로젝트 삭제와 같은 인스턴스에서 발생하는 이벤트를 확인하는 데 도움이 됩니다. 예를 들면:

{
  "severity":"INFO",
  "time":"2020-01-14T13:35:15.466Z",
  "correlation_id":"3823a1550b64417f9c9ed8ee0f48087e",
  "message":"User \"Administrator\" (admin@example.com) was created"
}
{
  "severity":"INFO",
  "time":"2020-01-14T13:35:15.466Z",
  "correlation_id":"78e3df10c9a18745243d524540bd5be4",
  "message":"Project \"project133\" was removed"
}

integrations_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/integrations_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/integrations_json.log에 있습니다.

이 파일에는 Jira, Asana 및 irker 서비스와 같은 통합 활동에 관한 정보가 포함되어 있습니다. 다음 예제와 같이 JSON 형식을 사용합니다.

{
  "severity":"ERROR",
  "time":"2018-09-06T14:56:20.439Z",
  "service_class":"Integrations::Jira",
  "project_id":8,
  "project_path":"h5bp/html5-boilerplate",
  "message":"Error sending message",
  "client_url":"http://jira.gitlab.com:8080",
  "error":"execution expired"
}
{
  "severity":"INFO",
  "time":"2018-09-06T17:15:16.365Z",
  "service_class":"Integrations::Jira",
  "project_id":3,
  "project_path":"namespace2/project2",
  "message":"Successfully posted",
  "client_url":"http://jira.example.com"
}

kubernetes.log (deprecated)

• GitLab 14.5에서 사용이 중단되었습니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/kubernetes.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/kubernetes.log에 있습니다.

이 파일은 인증서 기반 클러스터와 관련된 연결 오류와 같은 정보를 기록합니다. 각 줄에는 Elasticsearch 및 Splunk와 같은 서비스에서 처리할 수 있는 JSON이 포함됩니다.

git_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/git_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/git_json.log에 있습니다.

GitLab은 Git 리포지토리와 상호 작용해야 하지만 드물게 문제가 발생할 수 있습니다. 이 경우 발생한 문제를 정확히 파악해야 합니다. 이 로그 파일에는 GitLab에서 Git 리포지토리로의 모든 실패한 요청이 포함되어 있습니다. 대부분의 경우 이 파일은 개발자에게 유용합니다. 예를 들면:

{
   "severity":"ERROR",
   "time":"2019-07-19T22:16:12.528Z",
   "correlation_id":"FeGxww5Hj64",
   "message":"Command failed [1]: /usr/bin/git --git-dir=/Users/vsizov/gitlab-development-kit/gitlab/tmp/tests/gitlab-satellites/group184/gitlabhq/.git --work-tree=/Users/vsizov/gitlab-development-kit/gitlab/tmp/tests/gitlab-satellites/group184/gitlabhq merge --no-ff -mMerge branch 'feature_conflict' into 'feature' source/feature_conflict\n\nerror: failed to push some refs to '/Users/vsizov/gitlab-development-kit/repositories/gitlabhq/gitlab_git.git'"
}

audit_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/audit_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/audit_json.log에 있습니다.

그룹 또는 프로젝트 설정 및 멤버십 (target_details)에 대한 변경 사항이 이 파일에 기록됩니다. 예를 들면:

{
  "severity":"INFO",
  "time":"2018-10-17T17:38:22.523Z",
  "author_id":3,
  "entity_id":2,
  "entity_type":"Project",
  "change":"visibility",
  "from":"Private",
  "to":"Public",
  "author_name":"John Doe4",
  "target_id":2,
  "target_type":"Project",
  "target_details":"namespace2/project2"
}

Sidekiq logs

Linux 패키지 설치의 경우 일부 Sidekiq 로그는 /var/log/gitlab/sidekiq/current에 있으며 다음과 같습니다.

sidekiq.log

• Helm 차트 설치의 경우 GitLab 16.0부터 text가 json으로 기본 로그 형식으로 변경되었습니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/sidekiq/current에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/sidekiq.log에 있습니다.

GitLab은 긴 시간이 걸릴 수 있는 작업을 처리하는 백그라운드 작업을 사용합니다. 이러한 작업을 처리하는 모든 정보가 이 파일에 기록됩니다. 예를 들면:

{
  "severity":"INFO",
  "time":"2018-04-03T22:57:22.071Z",
  "queue":"cronjob:update_all_mirrors",
  "args":[],
  "class":"UpdateAllMirrorsWorker",
  "retry":false,
  "queue_namespace":"cronjob",
  "jid":"06aeaa3b0aadacf9981f368e",
  "created_at":"2018-04-03T22:57:21.930Z",
  "enqueued_at":"2018-04-03T22:57:21.931Z",
  "pid":10077,
  "worker_id":"sidekiq_0",
  "message":"UpdateAllMirrorsWorker JID-06aeaa3b0aadacf9981f368e: done: 0.139 sec",
  "job_status":"done",
  "duration":0.139,
  "completed_at":"2018-04-03T22:57:22.071Z",
  "db_duration":0.05,
  "db_duration_s":0.0005,
  "gitaly_duration":0,
  "gitaly_calls":0
}

JSON 로그 대신 Sidekiq의 텍스트 로그를 생성할 수도 있습니다. 예를 들면:

2023-05-16T16:08:55.272Z pid=82525 tid=23rl INFO: Initializing websocket
2023-05-16T16:08:55.279Z pid=82525 tid=23rl INFO: Booted Rails 6.1.7.2 application in production environment
2023-05-16T16:08:55.279Z pid=82525 tid=23rl INFO: Running in ruby 3.0.5p211 (2022-11-24 revision ba5cf0f7c5) [arm64-darwin22]
2023-05-16T16:08:55.279Z pid=82525 tid=23rl INFO: See LICENSE and the LGPL-3.0 for licensing details.
2023-05-16T16:08:55.279Z pid=82525 tid=23rl INFO: Upgrade to Sidekiq Pro for more features and support: https://sidekiq.org
2023-05-16T16:08:55.286Z pid=82525 tid=7p4t INFO: Cleaning working queues
2023-05-16T16:09:06.043Z pid=82525 tid=7p7d class=ScheduleMergeRequestCleanupRefsWorker jid=efcc73f169c09a514b06da3f INFO: start
2023-05-16T16:09:06.050Z pid=82525 tid=7p7d class=ScheduleMergeRequestCleanupRefsWorker jid=efcc73f169c09a514b06da3f INFO: arguments: []
2023-05-16T16:09:06.065Z pid=82525 tid=7p81 class=UserStatusCleanup::BatchWorker jid=e279aa6409ac33031a314822 INFO: start
2023-05-16T16:09:06.066Z pid=82525 tid=7p81 class=UserStatusCleanup::BatchWorker jid=e279aa6409ac33031a314822 INFO: arguments: []

Linux 패키지 설치의 경우 다음 구성 옵션을 추가합니다.

sidekiq['log_format'] = 'text'

자체 컴파일된 설치의 경우 gitlab.yml을 편집하고 Sidekiq log_format 구성 옵션을 설정합니다.

  ## Sidekiq
  sidekiq:
    log_format: text

sidekiq_client.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/sidekiq_client.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/sidekiq_client.log

이 파일에는 Sidekiq가 작업을 처리하기 전(예: 대기열에 들어가기 전) 작업에 대한 로깅 정보가 포함되어 있습니다.

이 로그 파일은 sidekiq.log와 동일한 구조를 따르며, 만일 Sidekiq에 대해 구성된 경우 JSON 형식으로 구성됩니다.

gitlab-shell.log

GitLab 쉘은 GitLab에서 Git 명령을 실행하고 Git 저장소에 SSH 액세스를 제공하기 위해 사용됩니다.

/var/log/gitlab/gitlab-shell/gitlab-shell.log에는 git-{upload-pack,receive-pack} 요청에 대한 정보가 포함되어 있습니다. 또한, Gitaly에서 GitLab 쉘로의 후크에 대한 정보는 /var/log/gitlab/gitaly/current에 있습니다.

/var/log/gitaly/current의 예시 로그 항목:

{
  "method": "POST",
  "url": "http://127.0.0.1:8080/api/v4/internal/allowed",
  "duration": 0.058012959,
  "gitaly_embedded": true,
  "pid": 16636,
  "level": "info",
  "msg": "finished HTTP request",
  "time": "2020-04-17T20:29:08+00:00"
}
{
  "method": "POST",
  "url": "http://127.0.0.1:8080/api/v4/internal/pre_receive",
  "duration": 0.031022552,
  "gitaly_embedded": true,
  "pid": 16636,
  "level": "info",
  "msg": "finished HTTP request",
  "time": "2020-04-17T20:29:08+00:00"
}

Gitaly 로그

이 파일은 /var/log/gitlab/gitaly/current에 있으며 runit에 의해 생성됩니다. runit는 리눅스 패키지와 함께 제공되며 그 목적에 대한 간략한 설명은 리눅스 패키지 설명서에서 찾을 수 있습니다. 로그 파일은 회전됩니다, 유닉스 타임스탬프 형식으로 이름이 변경되며 gzip로 압축되어 저장됩니다(예: @1584057562.s).

grpc.log

이 파일은 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/grpc.log에 있습니다. Gitaly에서 사용되는 네이티브 gRPC 로깅입니다.

gitaly_hooks.log

이 파일은 /var/log/gitlab/gitaly/gitaly_hooks.log에 있으며 gitaly-hooks 명령에 의해 생성됩니다. 또한, GitLab API 응답 처리 중 수신된 실패에 대한 기록을 포함하고 있습니다.

Puma 로그

puma_stdout.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/puma/puma_stdout.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/puma_stdout.log

puma_stderr.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/puma/puma_stderr.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/puma_stderr.log

repocheck.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/repocheck.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/repocheck.log

이 파일은 프로젝트에서 저장소 확인이 실행될 때 마다 정보를 기록합니다.

importer.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/importer.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/importer.log

이 파일은 프로젝트 가져오기와 이전의 진행 상황을 기록합니다.

exporter.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/exporter.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/exporter.log

이 파일은 내보내기 프로세스의 진행 상황을 기록합니다.

features_json.log

이 파일은 다음 위치에 있습니다:

• 리눅스 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/features_json.log
• 자체 컴파일 설치의 경우 /home/git/gitlab/log/features_json.log

GitLab의 기능 플래그에 대한 수정 이벤트가 이 파일에 기록됩니다. 예를 들면:

{"severity":"INFO","time":"2020-11-24T02:30:59.860Z","correlation_id":null,"key":"cd_auto_rollback","action":"enable","extra.thing":"true"}
{"severity":"INFO","time":"2020-11-24T02:31:29.108Z","correlation_id":null,"key":"cd_auto_rollback","action":"enable","extra.thing":"true"}
{"severity":"INFO","time":"2020-11-24T02:31:29.129Z","correlation_id":null,"key":"cd_auto_rollback","action":"disable","extra.thing":"false"}
{"severity":"INFO","time":"2020-11-24T02:31:29.177Z","correlation_id":null,"key":"cd_auto_rollback","action":"enable","extra.thing":"Project:1"}
{"severity":"INFO","time":"2020-11-24T02:31:29.183Z","correlation_id":null,"key":"cd_auto_rollback","action":"disable","extra.thing":"Project:1"}
{"severity":"INFO","time":"2020-11-24T02:31:29.188Z","correlation_id":null,"key":"cd_auto_rollback","action":"enable_percentage_of_time","extra.percentage":"50"}
{"severity":"INFO","time":"2020-11-24T02:31:29.193Z","correlation_id":null,"key":"cd_auto_rollback","action":"disable_percentage_of_time"}
{"severity":"INFO","time":"2020-11-24T02:31:29.198Z","correlation_id":null,"key":"cd_auto_rollback","action":"enable_percentage_of_actors","extra.percentage":"50"}
{"severity":"INFO","time":"2020-11-24T02:31:29.203Z","correlation_id":null,"key":"cd_auto_rollback","action":"disable_percentage_of_actors"}
{"severity":"INFO","time":"2020-11-24T02:31:29.329Z","correlation_id":null,"key":"cd_auto_rollback","action":"remove"}

ci_resource_groups_json.log

• GitLab 15.9에서 소개되었습니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/ci_resource_group_json.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/ci_resource_group_json.log

이 파일에는 자원 그룹 획득에 관한 정보가 포함되어 있습니다. 예를 들어:

{"severity":"INFO","time":"2023-02-10T23:02:06.095Z","correlation_id":"01GRYS10C2DZQ9J1G12ZVAD4YD","resource_group_id":1,"processable_id":288,"message":"attempted to assign resource to processable","success":true}
{"severity":"INFO","time":"2023-02-10T23:02:08.945Z","correlation_id":"01GRYS138MYEG32C0QEWMC4BDM","resource_group_id":1,"processable_id":288,"message":"attempted to release resource from processable","success":true}

예에서 각 항목의 resource_group_id, processable_id, message, 그리고 success 필드가 표시됩니다.

auth.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/auth.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/auth.log

이 로그는 다음을 기록합니다.

• Raw Endpoints에서의 요청 제한을 넘는 요청.
• 보호된 경로에서의 악의적인 요청.
• 사용자 ID 및 사용자 이름(사용 가능한 경우).

auth_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/auth_json.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/auth_json.log

이 파일에는 auth.log의 로그의 JSON 버전이 포함되어 있습니다. 예를 들어:

{
    "severity":"ERROR",
    "time":"2023-04-19T22:14:25.893Z",
    "correlation_id":"01GYDSAKAN2SPZPAMJNRWW5H8S",
    "message":"Rack_Attack",
    "env":"blocklist",
    "remote_ip":"x.x.x.x",
    "request_method":"GET",
    "path":"/group/project.git/info/refs?service=git-upload-pack"
}

graphql_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/graphql_json.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/graphql_json.log

GraphQL 쿼리가 이 파일에 기록됩니다. 예를 들어:

{"query_string":"query IntrospectionQuery{__schema {queryType { name },mutationType { name }}}...(etc)","variables":{"a":1,"b":2},"complexity":181,"depth":1,"duration_s":7}

clickhouse.log

• GitLab 16.5에서 소개되었습니다.

clickhouse.log 파일은 GitLab의 ClickHouse 데이터베이스 클라이언트와 관련된 정보를 기록합니다.

migrations.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/migrations.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/migrations.log

이 파일은 데이터베이스 마이그레이션의 진행 상황을 기록합니다.

mail_room_json.log (기본값)

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/mailroom/current
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/mail_room_json.log

이 구조화된 로그 파일은 mail_room 젬 내부 활동을 기록합니다. 이름과 경로는 구성 가능하므로 위의 정보와 일치하지 않을 수 있습니다.

web_hooks.log

• GitLab 16.3에 도입되었습니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우: /var/log/gitlab/gitlab-rails/web_hooks.log
• 올바르게 컴파일된 설치의 경우: /home/git/gitlab/log/web_hooks.log

웹훅의 백오프, 비활성화 및 재활성화 이벤트가 이 파일에 기록됩니다. 예를 들어:

{"severity":"INFO","time":"2020-11-24T02:30:59.860Z","hook_id":12,"action":"backoff","disabled_until":"2020-11-24T04:30:59.860Z","backoff_count":2,"recent_failures":2}
{"severity":"INFO","time":"2020-11-24T02:30:59.860Z","hook_id":12,"action":"disable","disabled_until":null,"backoff_count":5,"recent_failures":100}
{"severity":"INFO","time":"2020-11-24T02:30:59.860Z","hook_id":12,"action":"enable","disabled_until":null,"backoff_count":0,"recent_failures":0}

database_load_balancing.log

GitLab 데이터베이스 로드 밸런싱에 대한 세부 정보가 포함되어 있습니다. 이 파일은 다음 위치에 있습니다:

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/database_load_balancing.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/database_load_balancing.log에 있습니다.

zoekt.log

• GitLab 15.9에서 도입되었습니다.

이 파일은 정확한 코드 검색과 관련된 정보를 기록합니다. 이 파일은 다음 위치에 있습니다:

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/zoekt.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/zoekt.log에 있습니다.

elasticsearch.log

이 파일은 Elasticsearch 통합과 관련된 정보를 기록합니다. 이는 Elasticsearch의 색인 또는 검색 중 발생한 오류를 포함합니다. 이 파일은 다음 위치에 있습니다:

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/elasticsearch.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/elasticsearch.log에 있습니다.

각 행은 Elasticsearch나 Splunk와 같은 서비스에서 처리할 수 있는 JSON을 포함하고 있습니다. 가독성을 위해 다음과 같이 예제 행을 줄 바꿈 처리했습니다:

{
  "severity":"DEBUG",
  "time":"2019-10-17T06:23:13.227Z",
  "correlation_id":null,
  "message":"redacted_search_result",
  "class_name":"Milestone",
  "id":2,
  "ability":"read_milestone",
  "current_user_id":2,
  "query":"project"
}

exceptions_json.log

이 파일은 Gitlab::ErrorTracking에 의해 추적되는 예외에 관한 정보를 기록합니다. 이는 rescued 예외 처리의 표준적이고 일관된 방식을 제공합니다. 이 파일은 다음 위치에 있습니다:

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/exceptions_json.log에 있습니다.
• 직접 컴파일한 설치의 경우 /home/git/gitlab/log/exceptions_json.log에 있습니다.

각 행은 Elasticsearch에서 처리할 수 있는 JSON을 포함하고 있습니다. 다음은 예시입니다:

{
  "severity": "ERROR",
  "time": "2019-12-17T11:49:29.485Z",
  "correlation_id": "AbDVUrrTvM1",
  "extra.project_id": 55,
  "extra.relation_key": "milestones",
  "extra.relation_index": 1,
  "exception.class": "NoMethodError",
  "exception.message": "undefined method `strong_memoize' for #<Gitlab::ImportExport::RelationFactory:0x00007fb5d917c4b0>",
  "exception.backtrace": [
    "lib/gitlab/import_export/relation_factory.rb:329:in `unique_relation?'",
    "lib/gitlab/import_export/relation_factory.rb:345:in `find_or_create_object!'"
  ]
}

service_measurement.log

이 파일은 각 서비스 실행에 대한 측정 값을 단일 구조화된 로그만 포함하고 있습니다. SQL 호출 수, execution_time, gc_stats, 및 memory usage와 같은 측정 값을 포함하고 있습니다.

예:

{ "severity":"INFO", "time":"2020-04-22T16:04:50.691Z","correlation_id":"04f1366e-57a1-45b8-88c1-b00b23dc3616","class":"Projects::ImportExport::ExportService","current_user":"John Doe","project_full_path":"group1/test-export","file_path":"/path/to/archive","gc_stats":{"count":{"before":127,"after":127,"diff":0},"heap_allocated_pages":{"before":10369,"after":10369,"diff":0},"heap_sorted_length":{"before":10369,"after":10369,"diff":0},"heap_allocatable_pages":{"before":0,"after":0,"diff":0},"heap_available_slots":{"before":4226409,"after":4226409,"diff":0},"heap_live_slots":{"before":2542709,"after":2641420,"diff":98711},"heap_free_slots":{"before":1683700,"after":1584989,"diff":-98711},"heap_final_slots":{"before":0,"after":0,"diff":0},"heap_marked_slots":{"before":2542704,"after":2542704,"diff":0},"heap_eden_pages":{"before":10369,"after":10369,"diff":0},"heap_tomb_pages":{"before":0,"after":0,"diff":0},"total_allocated_pages":{"before":10369,"after":10369,"diff":0},"total_freed_pages":{"before":0,"after":0,"diff":0},"total_allocated_objects":{"before":24896308,"after":24995019,"diff":98711},"total_freed_objects":{"before":22353599,"after":22353599,"diff":0},"malloc_increase_bytes":{"before":140032,"after":6650240,"diff":6510208},"malloc_increase_bytes_limit":{"before":25804104,"after":25804104,"diff":0},"minor_gc_count":{"before":94,"after":94,"diff":0},"major_gc_count":{"before":33,"after":33,"diff":0},"remembered_wb_unprotected_objects":{"before":34284,"after":34284,"diff":0},"remembered_wb_unprotected_objects_limit":{"before":68568,"after":68568,"diff":0},"old_objects":{"before":2404725,"after":2404725,"diff":0},"old_objects_limit":{"before":4809450,"after":4809450,"diff":0},"oldmalloc_increase_bytes":{"before":140032,"after":6650240,"diff":6510208},"oldmalloc_increase_bytes_limit":{"before":68537556,"after":68537556,"diff":0}},"time_to_finish":0.12298400001600385,"number_of_sql_calls":70,"memory_usage":"0.0 MiB","label":"process_48616"}

geo.log

Geo는 geo.log 파일에 구조화된 로그 메시지를 저장합니다. Linux 패키지 설치의 경우,이 파일은 /var/log/gitlab/gitlab-rails/geo.log에 있습니다.

Helm 차트 설치의 경우, Sidekiq pod에 저장되어 있으며 /var/log/gitlab/geo.log에 저장됩니다. 이 파일은 직접 파일에 액세스하거나 kubectl을 사용하여 Sidekiq 로그를 가져와 결과를 "subcomponent"=="geo"로 필터링하는 방식으로 읽을 수 있습니다. 아래 예제는 jq를 사용하여 Geo 로그만 가져오는 방법을 보여줍니다:

kubectl logs -l app=sidekiq --max-log-requests=50 | jq 'select(."subcomponent"=="geo")'

이 파일에는 Geo가 저장소와 파일을 동기화하려는 시도에 대한 정보가 포함되어 있습니다. 파일의 각 줄에는 Elasticsearch 또는 Splunk와 같은 시스템에서 처리할 수있는 별도의 JSON 항목이 포함되어 있습니다.

예를 들어:

{"severity":"INFO","time":"2017-08-06T05:40:16.104Z","message":"Repository update","project_id":1,"source":"repository","resync_repository":true,"resync_wiki":true,"class":"Gitlab::Geo::LogCursor::Daemon","cursor_delay_s":0.038}

이 메시지는 Geo가 프로젝트 1에 대해 저장소 업데이트가 필요하다는 것을 감지했음을 보여줍니다.

update_mirror_service_json.log

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/update_mirror_service_json.log에 있습니다.
• 직접 컴파일 설치의 경우 /home/git/gitlab/log/update_mirror_service_json.log에 있습니다.

이 파일에는 프로젝트 미러링 중 발생한 LFS 오류에 대한 정보가 포함되어 있습니다. 다른 프로젝트 미러링 오류를이 로그로 옮기는 작업을 진행 중이지만 일반 로그를 사용할 수 있습니다.

{
   "severity":"ERROR",
   "time":"2020-07-28T23:29:29.473Z",
   "correlation_id":"5HgIkCJsO53",
   "user_id":"x",
   "project_id":"x",
   "import_url":"https://mirror-source/group/project.git",
   "error_message":"The LFS objects download list couldn't be imported. Error: Unauthorized"
}

llm.log

• GitLab 16.0에서 도입되었습니다.

llm.log 파일은 AI 기능에 관련된 정보를 기록합니다. 로깅에는 AI 이벤트에 대한 정보가 포함됩니다.

LLM 입력 및 출력 로깅

• 17.2 버전에서 expanded_ai_logging이라는 플래그로 도입되었습니다. 기본적으로 비활성화되어 있습니다.

LLM 프롬프트 입력 및 응답 출력은 expanded_ai_logging 플래그를 활성화하여 기록할 수 있습니다. 이 플래그는 기본적으로 비활성화되어 있으며 다음 조건에서만 활성화할 수 있습니다.

• GitLab.com의 경우 GitLab 지원 티켓을 통해 동의를 제공한 경우
• Self-managed의 경우이 기능 플래그를 활성화한 경우

기본적으로 로그에는 AI 기능 데이터의 데이터 유지 정책을 지원하기 위해 LLM 프롬프트 입력 및 응답 출력이 포함되어 있지 않습니다.

이 로그 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/llm.log에 있습니다.
• 직접 컴파일 설치의 경우 /home/git/gitlab/log/llm.log에 있습니다.

epic_work_item_sync.log

• GitLab 16.9에서 도입되었습니다.

epic_work_item_sync.log 파일은 에픽을 작업 항목으로 동기화하고 마이그레이션과 관련된 정보를 기록합니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/epic_work_item_sync.log에 있습니다.
• 직접 컴파일 설치의 경우 /home/git/gitlab/log/epic_work_item_sync.log에 있습니다.

secret_push_protection.log

• GitLab 16.7에서 도입되었습니다.

secret_push_protection.log 파일은 Secret Push Protection 기능과 관련된 정보를 기록합니다.

이 파일은 다음 위치에 있습니다.

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/secret_push_protection.log에 있습니다.
• 직접 컴파일 설치의 경우 /home/git/gitlab/log/secret_push_protection.log에 있습니다.

레지스트리 로그

Linux 패키지 설치의 경우 컨테이너 레지스트리 로그는 /var/log/gitlab/registry/current에 있습니다.

NGINX 로그

Linux 패키지 설치의 경우 NGINX 로그는 다음 위치에 있습니다.

• /var/log/gitlab/nginx/gitlab_access.log: GitLab에 대한 요청 로그
• /var/log/gitlab/nginx/gitlab_error.log: GitLab의 NGINX 오류 로그
• /var/log/gitlab/nginx/gitlab_pages_access.log: 페이지 정적 사이트에 대한 요청 로그
• /var/log/gitlab/nginx/gitlab_pages_error.log: 페이지 정적 사이트의 NGINX 오류 로그
• /var/log/gitlab/nginx/gitlab_registry_access.log: 컨테이너 레지스트리에 대한 요청 로그
• /var/log/gitlab/nginx/gitlab_registry_error.log: 컨테이너 레지스트리의 NGINX 오류 로그
• /var/log/gitlab/nginx/gitlab_mattermost_access.log: Mattermost에 대한 요청 로그
• /var/log/gitlab/nginx/gitlab_mattermost_error.log: Mattermost의 NGINX 오류 로그

아래는 기본 GitLab NGINX 액세스 로그 형식입니다:

'$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"'

$request 및 $http_referer는 기밀 토큰과 같은 민감한 쿼리 문자열 매개변수에 대해 필터링됩니다.

Pages logs

Linux 패키지 설치의 경우, Pages 로그는 /var/log/gitlab/gitlab-pages/current에 있습니다.

예시:

{
  "level": "info",
  "msg": "GitLab Pages Daemon",
  "revision": "52b2899",
  "time": "2020-04-22T17:53:12Z",
  "version": "1.17.0"
}
{
  "level": "info",
  "msg": "URL: https://gitlab.com/gitlab-org/gitlab-pages",
  "time": "2020-04-22T17:53:12Z"
}
{
  "gid": 998,
  "in-place": false,
  "level": "info",
  "msg": "running the daemon as unprivileged user",
  "time": "2020-04-22T17:53:12Z",
  "uid": 998
}

Let’s Encrypt logs

Linux 패키지 설치의 경우, Let’s Encrypt 자동 갱신 로그는 /var/log/gitlab/lets-encrypt/에 있습니다.

Mattermost logs

Linux 패키지 설치의 경우, Mattermost 로그는 다음 위치에 있습니다:

• /var/log/gitlab/mattermost/mattermost.log
• /var/log/gitlab/mattermost/current

Workhorse logs

Linux 패키지 설치의 경우, Workhorse 로그는 /var/log/gitlab/gitlab-workhorse/current에 있습니다.

PgBouncer logs

Linux 패키지 설치의 경우, PgBouncer 로그는 /var/log/gitlab/pgbouncer/current에 있습니다.

PostgreSQL logs

Linux 패키지 설치의 경우, PostgreSQL 로그는 /var/log/gitlab/postgresql/current에 있습니다.

Prometheus logs

Linux 패키지 설치의 경우, Prometheus 로그는 /var/log/gitlab/prometheus/current에 있습니다.

Redis logs

Linux 패키지 설치의 경우, Redis 로그는 /var/log/gitlab/redis/current에 있습니다.

Alertmanager logs

Linux 패키지 설치의 경우, Alertmanager 로그는 /var/log/gitlab/alertmanager/current에 있습니다.

crond logs

Linux 패키지 설치의 경우, crond 로그는 /var/log/gitlab/crond/에 있습니다.

Grafana logs

Linux 패키지 설치의 경우, Grafana 로그는 /var/log/gitlab/grafana/current에 있습니다.

LogRotate logs

Linux 패키지 설치의 경우, logrotate 로그는 /var/log/gitlab/logrotate/current에 있습니다.

GitLab Monitor logs

Linux 패키지 설치의 경우, GitLab Monitor 로그는 /var/log/gitlab/gitlab-monitor/에 있습니다.

GitLab Exporter

Linux 패키지 설치의 경우, GitLab Exporter 로그는 /var/log/gitlab/gitlab-exporter/current에 있습니다.

GitLab agent server

Linux 패키지 설치의 경우, GitLab agent server 로그는 /var/log/gitlab/gitlab-kas/current에 있습니다.

Praefect logs

Linux 패키지 설치의 경우, Praefect 로그는 /var/log/gitlab/praefect/에 있습니다.

GitLab은 또한 Praefect에 대한 Prometheus 지표를 추적합니다.

백업 로그

Linux 패키지 설치의 경우, 백업 로그는 /var/log/gitlab/gitlab-rails/backup_json.log에 있습니다.

이 로그는 GitLab 백업이 생성될 때 작성됩니다. 이 로그를 사용하여 백업 프로세스의 수행 내용을 이해할 수 있습니다.

성능 바 통계

이 파일은 다음 위치에 있습니다:

• Linux 패키지 설치의 경우 /var/log/gitlab/gitlab-rails/performance_bar_json.log.
• Self-compiled 설치의 경우 /home/git/gitlab/log/performance_bar_json.log.

성능 바 통계(현재는 SQL 쿼리의 지속 시간만 기록)가 해당 파일에 기록됩니다. 예:

{"severity":"INFO","time":"2020-12-04T09:29:44.592Z","correlation_id":"33680b1490ccd35981b03639c406a697","filename":"app/models/ci/pipeline.rb","method_path":"app/models/ci/pipeline.rb:each_with_object","request_id":"rYHomD0VJS4","duration_ms":26.889,"count":2,"query_type": "active-record"}

이 통계는 .com에서만 로그가 기록되며, Self-deployments에서는 비활성화됩니다.

로그 수집

이전에 나열된 구성 요소 중 하나로 국지화되지 않은 문제를 해결할 때는 GitLab 인스턴스에서 여러 로그와 통계를 동시에 수집하는 것이 유용합니다.

참고: GitLab 지원은 종종 이 중 하나를 요청하며 필요한 도구를 유지합니다.

주요 로그 간략히 보기

버그나 오류가 쉽게 재현되는 경우, 문제를 몇 번 재현하면서 주요 GitLab 로그를 파일로 저장하세요:

sudo gitlab-ctl tail | tee /tmp/<case-ID-and-keywords>.log

로그 수집을 Control + C로 마무리하세요.

GitLabSOS

이전에 나열된 GitLab 구성 요소 중 하나에 속하지 못하는 성능 저하나 연쇄적 오류가 발생하는 경우, GitLabSOS를 사용하여 GitLab 인스턴스를 보다 폭넓게 확인할 수 있습니다. 자세한 내용 및 실행 방법은 GitLabSOS 문서를 참조하세요.

Fast-stats

Fast-stats는 GitLab 로그에서 성능 통계를 생성하고 비교하는 도구입니다. 자세한 내용과 실행 방법은 fast-stats 문서를 참조하세요.

상관 ID로 관련 로그 항목 찾기

대부분의 요청에는 관련 로그 항목을 찾기 위해 사용할 수 있는 로그 ID가 있습니다.