GitLab 서비스 측정 개발자 안내서
느린 서비스의 실행 시간, SQL 호출 수, 가비지 수집 통계, 메모리 사용량 등을 디버그하기 위해 서비스 측정을 활성화할 수 있습니다.
측정 모듈
측정 모듈은 서비스의 실행을 측정하고 다음을 기록할 수 있는 도구입니다:
- 서비스 클래스 이름
- 실행 시간
- SQL 호출 수
- 자세한
gc
통계 및 차이점 - RSS 메모리 사용량
- 서버 워커 ID
측정 모듈은 각 서비스 실행에 대해 단일 항목으로 service_measurement.log
로 불리는 구조화된 로그에 이러한 측정값을 기록합니다.
GitLab.com의 경우, service_measurement.log
은 모니터링 솔루션의 일환으로 Elasticsearch 및 Kibana에 흡수됩니다.
사용 방법
측정 모듈을 사용하면 어떤 서비스의 실행도 쉽게 측정하고 로그로 남길 수 있습니다. 이를 위해 해당 서비스 클래스 파일의 마지막 줄에 Measurable
을 간단히 선행시키면 됩니다.
예를 들어, DummyService
클래스에 모듈을 선행시키려면 다음과 같은 방식을 사용할 수 있습니다:
class DummyService
def execute
# ...
end
end
DummyService.prepend(Measurable)
EE
기능이 있는 EE
네임스페이스의 모듈을 선행시키는 경우, EE
모듈을 선행시킨 후에 Measurable
을 선행시켜야 합니다.
이렇게 하면 Measurable
이 조상 체인의 맨 아래에 있어 EE
기능의 실행을 측정할 수 있습니다:
class DummyService
def execute
# ...
end
end
DummyService.prepend_mod_with('DummyService')
DummyService.prepend(Measurable)
추가 속성 로깅
추가 속성을 로깅해야 하는 경우, 서비스 클래스에 extra_attributes_for_measurement
를 정의할 수 있습니다:
def extra_attributes_for_measurement
{
project_path: @project.full_path,
user: current_user.name
}
end
서비스에 측정 모듈이 주입된 후에는 일반적인 기능 플래그를 사용합니다. 실제로 사용하려면 플래그를 활성화하여 원하는 서비스에 대한 측정을 활성화해야 합니다.
기능 플래그를 사용한 측정 활성화
다음 예에서 Projects::ImportService
에 대한 측정 기능을 활성화하기 위해 :gitlab_service_measuring_projects_import_service
기능 플래그가 사용됩니다.
챗옵스를 통해:
/chatops run feature set gitlab_service_measuring_projects_import_service true