MariaDB 로그 가이드: 오류, 슬로우 쿼리, Galera 이벤트

MariaDB 오류와 슬로우 쿼리 로그의 출력 경로를 찾고, 노드별 로그와 Galera WSREP 상태를 함께 확인하는 방법을 설명합니다.

모범 사례
로그 이벤트 수집과 데이터 분석을 보여 주는 그림

Galera 노드가 클러스터에 다시 합류한 뒤 결제 쿼리가 느려졌다고 가정해 봅시다. 오류 로그를 보면 상태 전송이 시작된 시점을 찾을 수 있습니다. 슬로우 쿼리 로그에는 기준 시간을 넘긴 SQL이 남습니다. 노드가 지금 쿼리를 받을 수 있는지, 흐름 제어로 멈춘 시간이 얼마나 되는지는 wsrep 상태를 확인해야 합니다.

슬로우 로그 변수는 MariaDB 10.11 이후의 이름을 쓰며, 파일 로그 예제는 단일 MariaDB 11.8 서버에서 확인했습니다. Galera 설명은 공식 문서를 따릅니다. 설치 패키지나 관리형 서비스에 따라 기본값은 다를 수 있습니다.

오류 로그가 실제로 쓰이는 위치 찾기

실행 중인 서버에서 SHOW VARIABLES LIKE 'log_error';를 실행합니다. Unix에서 log_error를 설정하지 않으면 서버는 오류를 stderr에 씁니다. systemd가 그 출력을 수집한다면 실제 서비스 유닛을 지정해 저널을 확인합니다. 예를 들어 journalctl -u mariadb를 쓸 수 있습니다. 컨테이너에서는 런타임이 stderr를 어떻게 처리하는지 살펴봅니다.

[mariadb]
log_error = /var/log/mariadb/error.log
log_warnings = 2

위 설정은 오류를 파일로 보냅니다. 상위 디렉터리를 만들고 MariaDB 서비스 계정이 쓸 수 있게 합니다. 파일이 이미 있다면 그 파일에 대한 쓰기 권한도 필요합니다. 문서상 log_warnings 기본값은 2지만 배포 설정에 따라 달라질 수 있고, 이 변수로 모든 경고를 제어할 수는 없습니다. 연결 문제를 조사하려고 상세도를 높인다면 이전 값을 기록하고 조사 후 복원합니다. 로그 로테이션에서 파일을 옮긴 뒤에는 MariaDB가 파일을 다시 열어 새 경로에 쓰는지 확인합니다. 오류 로그 · 로그 로테이션

해석할 수 있는 범위로 슬로우 쿼리 로그 설정하기

테스트 환경의 서버 옵션 파일에 아래 예제를 추가합니다. 쓰기 가능한 경로를 사용합니다. log_output = FILE은 일반 쿼리 로그에도 적용되므로 기존 출력 위치를 먼저 확인하세요.

[mariadb]
log_output = FILE
log_slow_query = 1
log_slow_query_file = /var/log/mariadb/slow.log
log_slow_query_time = 1
log_queries_not_using_indexes = OFF
log_slow_rate_limit = 1

이 예제의 기준은 1초입니다. 인덱스 미사용 쿼리가 시간 기준을 건너뛰는 옵션은 끄고, 로그를 샘플링하지 않습니다. 서버의 다른 슬로우 로그 조건은 그대로 적용됩니다. MariaDB 10.11 이후에는 log_slow_query, log_slow_query_file, log_slow_query_time을 씁니다. 예전 이름인 slow_query_log, slow_query_log_file, long_query_time도 새 버전에서 별칭으로 쓸 수 있습니다.

log_slow_filter로 전체 테이블 스캔, filesort, 내부 임시 테이블 같은 특징을 기준으로 좁힐 수 있습니다. not_using_index를 켜면 빠르게 끝났어도 인덱스를 사용하지 않은 쿼리가 기록될 수 있습니다. log_slow_min_examined_row_limit으로 살펴본 행이 적은 쿼리를 제외할 수 있습니다. log_slow_rate_limit을 높였다면 로그 건수는 표본으로 봅니다. MariaDB 11.7부터는 log_slow_always_query_time을 넘긴 쿼리가 샘플링 제한을 건너뛸 수 있습니다.

파일 출력에는 log_slow_verbosity로 상세 정보를 덧붙일 수 있습니다. query_plan은 실행 계획 관련 정보를 남기고, explain은 지원되는 구문의 EXPLAIN 출력을 추가합니다. 테이블 출력은 이 상세도 설정을 지원하지 않습니다. 파일에서는 mariadb-dumpslow로 유사 SQL을 묶고, 테이블 출력을 사용한다면 mysql.slow_log를 조회합니다. 다른 분석기를 쓰기 전에 추가 필드가 포함된 실제 샘플로 확인하세요. 슬로우 쿼리 로그 · 서버 변수 · mariadb-dumpslow

일반 쿼리 로그는 짧게 수집하기

일반 쿼리 로그에는 연결과 종료, 서버가 받은 SQL이 기록됩니다. 수신할 때 쓰는 기록이므로 구문이 성공했거나 트랜잭션이 커밋됐다는 증거는 아닙니다.

SHOW GLOBAL VARIABLES
WHERE Variable_name IN ('general_log', 'general_log_file', 'log_output');

잠시 수집할 필요가 있다면 원래 상태와 출력 위치를 기록합니다. 일반 쿼리 로그가 OFF이고 출력은 이미 FILE인 테스트 인스턴스에서 다음 쿼리로 경로를 확인할 수 있습니다.

SET GLOBAL general_log = ON;
SELECT 1 AS learn_general_log_probe;
SET GLOBAL general_log = OFF;

확인 후 원래 설정으로 돌립니다. log_output을 TABLE로 바꾸면 활성화된 슬로우 쿼리 로그의 출력도 함께 바뀝니다. 로그에는 SQL 리터럴 값이 포함될 수 있고 쓰기량도 크므로 수집 시간과 읽기 권한을 제한합니다. 일반 쿼리 로그 · 테이블 출력

백업과 복구 계획에 맞춰 바이너리 로그 보존하기

MariaDB 10.6.1 이상에서 파일 기반 바이너리 로그를 쓸 때의 예입니다. 604800초는 7일입니다.

[mariadb]
log_bin = /var/log/mariadb/mariadb-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G

보존 기간은 기본 백업 주기, 시점 복구 목표, 복제본이 지연되거나 연결이 끊겨 있을 수 있는 시간을 기준으로 정합니다. 만료 여부는 시작이나 로테이션 등의 시점에 확인합니다. 기한에 이르자마자 삭제된다는 보장은 없습니다. MariaDB가 바이너리 로그 파일과 인덱스를 관리하므로 OS 로그 로테이션에 맡기거나 직접 삭제하지 않습니다. 바이너리 로그 관리

Galera 노드의 기록을 한 타임라인에 놓기

donor와 joiner의 오류 로그를 이벤트 시각 기준으로 나란히 놓고, WSREP 멤버십 변경과 상태 스냅샷 전송(SST), 증분 상태 전송(IST)을 찾습니다. donor에 필요한 write set 기록이 남아 있다면 IST로 따라잡을 수 있습니다. SST가 실패하면 설정된 전송 방식의 로그도 확인합니다.

SHOW GLOBAL STATUS
WHERE Variable_name IN (
  'wsrep_cluster_status',
  'wsrep_cluster_size',
  'wsrep_ready',
  'wsrep_connected',
  'wsrep_local_state_comment',
  'wsrep_local_recv_queue_avg',
  'wsrep_flow_control_paused'
);

Galera 배포에서 wsrep_cluster_status는 Primary 컴포넌트 여부를, wsrep_ready와 wsrep_local_state_comment는 쿼리 준비 상태와 노드 상태를 보여 줍니다. wsrep_flow_control_paused는 마지막 FLUSH STATUS 이후 흐름 제어로 일시 중지된 시간의 비율입니다. 수신 큐와 다른 노드의 상태를 함께 확인합니다.

파일로 쓰는 로그는 DataKit 파일 수집에서 읽을 수 있는 경로를 유형별로 지정합니다. 노드와 클러스터 식별자를 보존하고, 여러 줄 SQL이 한 이벤트로 묶이는지와 이벤트 시각 및 시간대가 맞는지 샘플로 확인합니다. Pipeline으로 시간 필드를 정리해도 호스트 시계의 오차는 고쳐지지 않습니다. 시계 동기화는 별도로 구성합니다. 확인한 특정 WSREP 실패는 Guance 로그 감지 규칙에서 노드나 클러스터별로 집계할 수 있습니다. 오류와 슬로우 로그의 보존 기간을 다르게 하려면 로그 인덱스 라우팅과 저장 정책을 확인합니다. Galera 상태 변수 · Guance 로그 감지 · 로그 인덱스

관련 글

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소