프로파일링
성능 문제를 추적하기 쉽도록 하기 위해 GitLab에는 기본적으로 제공되는 몇 가지 프로파일링 도구가 포함되어 있습니다. 일부 도구는 기본적으로 제공되며, 다른 도구는 명시적으로 활성화해야 합니다.
URL 프로파일링
Gitlab::Profiler.profile 메서드와 해당하는 bin/profile-url 스크립트를 사용하여 특정 URL의 GET 또는 POST 요청을 프로파일링할 수 있습니다. 이는 기본적으로 익명 사용자(기본값) 또는 특정 사용자로 프로파일링할 수 있습니다.
프로파일러의 첫 번째 인수는 전체 URL(인스턴스 호스트 이름 포함)이거나 처음의 슬래시를 포함한 절대 경로입니다.
기본적으로 보고서 덤프는 임시 파일에 저장되며, Stackprof API를 통해 상호 작용할 수 있습니다.
스크립트를 사용할 때는 인수를 전달하지 않고 실행하여 명령행 문서를 확인할 수 있습니다.
대화형 콘솔 세션에서 메서드를 사용할 때에는 해당 콘솔 세션 내의 애플리케이션 코드에 대한 변경 사항이 프로파일러 출력에 반영됩니다.
예시:
Gitlab::Profiler.profile('/my-user')
# 보고서 덤프가 저장된 임시 파일의 위치를 반환합니다
class UsersController; def show; sleep 100; end; end
Gitlab::Profiler.profile('/my-user')
# 보고서 덤프가 저장된 임시 파일의 위치를 반환합니다
# 여기서 100초가 UsersController#show에서 소요됩니다
인증이 필요한 경로의 경우, Gitlab::Profiler에 사용자를 제공해야 합니다.
다음과 같이 수행할 수 있습니다:
Gitlab::Profiler.profile('/gitlab-org/gitlab-test', user: User.first)
logger: 키워드 인수를 Gitlab::Profiler.profile에 전달하면 Active Record 및 Action Controller 로그 출력이 해당 로거로 전송됩니다.
추가적인 옵션에 대한 설명은 메서드 소스에 문서화되어 있습니다.
Gitlab::Profiler.profile('/gitlab-org/gitlab-test', user: User.first, logger: Logger.new($stdout))
출력 파일(out)을 구성하기 위해 profiler_options 해시를 전달할 수 있습니다. 예를 들어:
Gitlab::Profiler.profile('/gitlab-org/gitlab-test', user: User.first, profiler_options: { out: 'tmp/profile.dump' })
GitLab::Profiler 보고서 읽기
샘플링 데이터에 대해 Stackprof를 실행하여 시간이 소요된 위치에 대한 요약 정보를 얻을 수 있습니다. 예를 들어:
stackprof tmp/profile.dump
예시 샘플링 데이터:
==================================
Mode: wall(1000)
Samples: 8745 (6.92% miss rate)
GC: 1399 (16.00%)
==================================
TOTAL (pct) SAMPLES (pct) FRAME
1022 (11.7%) 1022 (11.7%) Sprockets::PathUtils#stat
957 (10.9%) 957 (10.9%) (marking)
493 (5.6%) 493 (5.6%) Sprockets::PathUtils#entries
576 (6.6%) 471 (5.4%) Mustermann::AST::Translator#decorator_for
439 (5.0%) 439 (5.0%) (sweeping)
630 (7.2%) 241 (2.8%) Sprockets::Cache::FileStore#get
208 (2.4%) 208 (2.4%) ActiveSupport::FileUpdateChecker#watched
206 (2.4%) 206 (2.4%) Digest::Instance#file
544 (6.2%) 176 (2.0%) Sprockets::Cache::FileStore#safe_open
176 (2.0%) 176 (2.0%) ActiveSupport::FileUpdateChecker#max_mtime
268 (3.1%) 147 (1.7%) ActiveRecord::ConnectionAdapters::PostgreSQLAdapter#exec_no_cache
140 (1.6%) 140 (1.6%) ActiveSupport::BacktraceCleaner#add_gem_filter
116 (1.3%) 116 (1.3%) Bootsnap::CompileCache::ISeq.storage_to_output
160 (1.8%) 113 (1.3%) Gem::Version#<=>
109 (1.2%) 109 (1.2%) block in <main>
108 (1.2%) 108 (1.2%) Gem::Version.new
131 (1.5%) 105 (1.2%) Sprockets::EncodingUtils#unmarshaled_deflated
1166 (13.3%) 82 (0.9%) Mustermann::RegexpBased#initialize
82 (0.9%) 78 (0.9%) FileUtils.touch
72 (0.8%) 72 (0.8%) Sprockets::Manifest.compile_match_filter
71 (0.8%) 70 (0.8%) Grape::Router#compile!
91 (1.0%) 65 (0.7%) ActiveRecord::ConnectionAdapters::PostgreSQL::DatabaseStatements#query
93 (1.1%) 64 (0.7%) ActionDispatch::Journey::Path::Pattern::AnchoredRegexp#accept
59 (0.7%) 59 (0.7%) Mustermann::AST::Translator.dispatch_table
62 (0.7%) 59 (0.7%) Rails::BacktraceCleaner#initialize
2492 (28.5%) 49 (0.6%) Sprockets::PathUtils#stat_directory
242 (2.8%) 49 (0.6%) Gitlab::Instrumentation::RedisBase.add_call_details
47 (0.5%) 47 (0.5%) URI::RFC2396_Parser#escape
46 (0.5%) 46 (0.5%) #<Class:0x00000001090c2e70>#__setobj__
44 (0.5%) 44 (0.5%) Sprockets::Base#normalize_logical_path
flamegraph를 생성할 수도 있습니다:
stackprof --d3-flamegraph tmp/profile.dump > flamegraph.html
자세한 내용은 Stackprof 문서를 확인하세요.
Speedscope flamegraph
성능 바에서 특정 URL에 대한 flamegraph를 생성할 수 있습니다. 성능 바의 flamegraph 샘플링 모드 버튼을 선택하거나 요청에 performance_bar=flamegraph 매개변수를 추가하여 수행할 수 있습니다.
Speedscope 문서에서 뷰에 대해 더 많은 정보를 확인할 수 있습니다.
다른 샘플링 모드에 대한 자세한 정보는 Stackprof 문서에서 확인할 수 있습니다.
이는 성능 바에 액세스할 수 있는 모든 사용자에게 활성화되어 있습니다.
Bullet
Bullet는 N+1 쿼리 문제를 추적하는 데 사용할 수 있는 Gem입니다. 이는 쿼리 문제를 Rails 로그와 브라우저 콘솔에 기록합니다. Bullet 섹션은 성능 바에 표시됩니다.
기본적으로 Bullet는 개발 모드에서만 활성화됩니다. 그러나 로깅은 비활성화되어 있습니다. Bullet 및 해당 로깅을 구성하려면 다음을 수행하십시오.
-
환경에서 Bullet를 매뉴얼으로 활성화하거나 비활성화하려면
config/gitlab.yml에 다음 라인을 추가하여enabled값을 필요에 따라 변경하십시오:bullet: enabled: false -
Bullet 로깅을 활성화하려면 GitLab을 시작하기 전에
ENABLE_BULLET환경 변수를 비어 있지 않은 값으로 설정하십시오:ENABLE_BULLET=true bundle exec rails s
Bullet를 사용하여 N+1 쿼리를 찾은 후에는 QueryRecoder 테스트를 작성하여 회귀를 방지하는 것을 고려해 보세요.
시스템 통계
프로파일링 중이거나 이후에는 루비 가상 머신 프로세스에 대한 자세한 정보를 얻고 싶을 수 있습니다. 메모리 사용, CPU에서 소비한 시간 또는 가비지 수집기 통계와 같은 정보가 있습니다. 이러한 정보는 여러 도구를 통해 개별적으로 생성하기 쉽지만 편리함을 위해 이러한 데이터를 JSON 페이로드로 내보내는 요약 엔드포인트가 추가되었습니다.
curl localhost:3000/-/metrics/system | jq
예시 출력:
{
"version": "ruby 2.7.2p137 (2020-10-01 revision a8323b79eb) [x86_64-linux-gnu]",
"gc_stat": {
"count": 118,
"heap_allocated_pages": 11503,
"heap_sorted_length": 11503,
"heap_allocatable_pages": 0,
"heap_available_slots": 4688580,
"heap_live_slots": 3451712,
"heap_free_slots": 1236868,
"heap_final_slots": 0,
"heap_marked_slots": 3451450,
"heap_eden_pages": 11503,
"heap_tomb_pages": 0,
"total_allocated_pages": 11503,
"total_freed_pages": 0,
"total_allocated_objects": 32679478,
"total_freed_objects": 29227766,
"malloc_increase_bytes": 84760,
"malloc_increase_bytes_limit": 32883343,
"minor_gc_count": 88,
"major_gc_count": 30,
"compact_count": 0,
"remembered_wb_unprotected_objects": 114228,
"remembered_wb_unprotected_objects_limit": 228456,
"old_objects": 3185330,
"old_objects_limit": 6370660,
"oldmalloc_increase_bytes": 21838024,
"oldmalloc_increase_bytes_limit": 119181499
},
"memory_rss": 1326501888,
"memory_uss": 1048563712,
"memory_pss": 1139554304,
"time_cputime": 82.885264633,
"time_realtime": 1610459445.5579069,
"time_monotonic": 24001.23145713,
"worker_id": "puma_0"
}
성능에 영향을 미치는 설정
애플리케이션 설정
- 기본적으로
development환경에서는 핫 리로딩이 활성화되어 작동하며, 이로 인해 Rails는 매 요청마다 파일 변경을 확인하고 잠재적인 경합 락을 생성합니다. 핫 리로딩은 단일 스레드를 사용하기 때문에 잠재적인 경합 락을 생성합니다. -
개발환경은 요청이 발생할 때 코드를 느리게로드하고, 이로 인해 첫 요청이 항상 느립니다.
프로파일링/벤치마킹을 위해 이러한 기능을 비활성화하려면 GitLab을 시작하기 전에 RAILS_PROFILE 환경 변수를 true로 설정하세요. 예를 들어 GDK를 사용하는 경우:
- root GDK 디렉터리에
env.runit파일을 생성합니다. -
env.runit파일에export RAILS_PROFILE=true를 추가합니다. -
gdk restart로 GDK를 다시 시작합니다.
이 환경 변수는 개발 모드에만 해당됩니다.
GC 설정
루비 가비지 컬렉터 (GC)는 애플리케이션 성능에 직접적인 영향을 미칠 수 있는 다양한 환경 변수를 통해 조정할 수 있습니다.
다음 표는 이러한 환경 변수와 기본값을 나열한 것입니다.
| 환경 변수 | 기본값 |
|---|---|
RUBY_GC_HEAP_INIT_SLOTS
| 10000
|
RUBY_GC_HEAP_FREE_SLOTS
| 4096
|
RUBY_GC_HEAP_FREE_SLOTS_MIN_RATIO
| 0.20
|
RUBY_GC_HEAP_FREE_SLOTS_GOAL_RATIO
| 0.40
|
RUBY_GC_HEAP_FREE_SLOTS_MAX_RATIO
| 0.65
|
RUBY_GC_HEAP_GROWTH_FACTOR
| 1.8
|
RUBY_GC_HEAP_GROWTH_MAX_SLOTS
| 0 (disable)
|
RUBY_GC_HEAP_OLDOBJECT_LIMIT_FACTOR
| 2.0
|
RUBY_GC_MALLOC_LIMIT(_MIN)
| (16 * 1024 * 1024 /* 16MB */)
|
RUBY_GC_MALLOC_LIMIT_MAX
| (32 * 1024 * 1024 /* 32MB */)
|
RUBY_GC_MALLOC_LIMIT_GROWTH_FACTOR
| 1.4
|
RUBY_GC_OLDMALLOC_LIMIT(_MIN)
| (16 * 1024 * 1024 /* 16MB */)
|
RUBY_GC_OLDMALLOC_LIMIT_MAX
| (128 * 1024 * 1024 /* 128MB */)
|
RUBY_GC_OLDMALLOC_LIMIT_GROWTH_FACTOR
| 1.2
|
(출처)
GitLab은 애플리케이션 성능을 높이거나 메모리 요구 사항을 낮추거나 둘 다를 위해 이러한 설정을 변경할 수 있습니다.
각 설정이 GC 성능, 메모리 사용, 그리고 휴면 상태의 GitLab 인스턴스의 애플리케이션 시작 시간에 어떤 영향을 미치는지를 확인하려면 scripts/perf/gc/collect_gc_stats.rb 스크립트를 실행하세요. 이는 표준 출력에 GC 통계 및 일반 타이밍 데이터를 CSV로 출력합니다.
도움말