마가자- GEM을 사용하여 데이터베이스 쿼리에 대한 주석
마가자- GEM은 ActiveRecord에서 생성된 PostgreSQL 쿼리에 애플리케이션 관련 컨텍스트 정보를 포함하는 쿼리 주석을 추가하는 데 사용됩니다.
애플리케이션 소스로부터 발생한 문제가 있는 쿼리를 추적하는 데 매우 유용합니다.
당직 중에 엔지니어는 쿼리와 해당 애플리케이션 소스의 전체 컨텍스트를 주석에서 확인할 수 있습니다.
주석 내의 메타데이터 정보
Rails에서 생성된 쿼리는 주석에 다음과 같은 메타데이터를 포함합니다:
application
correlation_id
endpoint_id
line
Sidekiq 워커에서 생성된 쿼리는 주석에 다음과 같은 메타데이터를 포함합니다:
application
jid
correlation_id
endpoint_id
line
endpoint_id
는 애플리케이션의 모든 엔드포인트를 나타낼 수 있는 단일 필드입니다:
- Rails 컨트롤러의 경우 컨트롤러와 액션입니다. 예:
Projects::BlobController#show
. - Grape API 엔드포인트의 경우 라우트입니다. 예:
/api/:version/users/:id
. - Sidekiq 워커의 경우 워커 클래스 이름입니다. 예:
UserStatusCleanup::BatchWorker
.
line
은 추가 오버헤드가 필요하여 프로덕션 로그에는 등장하지 않습니다.
주석이 있는 쿼리의 예:
-
Rails:
/*application:web,controller:blob,action:show,correlation_id:01EZVMR923313VV44ZJDJ7PMEZ,endpoint_id:Projects::BlobController#show*/ "routes"에서 "routes"."source_id" = 75 및 "routes"."source_type" = 'Namespace'와 일치하는 "routes".*을 선택
-
Grape:
/*application:web,correlation_id:01EZVN0DAYGJF5XHG9N4VX8FAH,endpoint_id:/api/:version/users/:id*/ "users"와 "user_follow_users" 사이의 "follower_id" = 1인 행 수를 선택
-
Sidekiq:
/*application:sidekiq,correlation_id:df643992563683313bc0a0288fb55e23,jid:15fbc506590c625d7664b074,endpoint_id:UserStatusCleanup::BatchWorker,line:/app/workers/user_status_cleanup/batch_worker.rb:19:in `perform'*/ "user_statuses"에서 "user_statuses"."clear_status_at" <= $2인 경우 "user_statuses"."clear_status_at"을 $1로 선택, 결과를 one으로 이름 지정하여 1개 행을 선택