MySQL 로그 가이드: 오류, 슬로우 쿼리, 일반 쿼리, 바이너리 로그
MySQL 8.0과 8.4에서 네 가지 로그를 설정하고 읽는 방법을 살펴봅니다. 슬로우 쿼리 집계와 복제·특정 시점 복구를 위한 바이너리 로그 보존 기준도 설명합니다.
배포 중 MySQL이 재시작했고, 서버가 돌아온 뒤에도 읽기 API가 느립니다. 먼저 오류 로그에서 시작과 복구 과정을 확인하고, 같은 시간대에 완료된 쿼리는 슬로우 쿼리 로그에서 찾습니다. 배포로 어떤 데이터가 바뀌었는지 재구성해야 한다면 바이너리 로그를 봅니다.
아래 예시는 직접 운영하는 MySQL 8.0과 8.4를 기준으로 합니다. 각 [mysqld] 예시는 시작 시 적용하는 설정입니다. 변경하기 전에 실제 경로, 권한, 기존 영구 설정을 확인하세요.
어떤 MySQL 로그부터 확인할까?
| 로그 | 확인할 수 있는 것 | 일반적인 기본 상태 |
|---|---|---|
| 오류 로그 | 시작에 실패한 이유나 복구 중 서버가 남긴 진단 정보 | 활성화. 출력 위치는 시작 설정에 따라 다름 |
| 슬로우 쿼리 로그 | 완료된 문장 중 기록 조건을 충족한 실행 | 비활성화 |
| 일반 쿼리 로그 | 짧은 조사 구간에 서버가 받은 연결과 SQL | 비활성화 |
| 바이너리 로그 | 복제본이나 복구 대상이 재생할 변경 이벤트 | 활성화 |
1. 오류 로그(Error Log)
[mysqld]
log_error = /var/log/mysql/error.log
서버가 동작한다면 SHOW GLOBAL VARIABLES LIKE 'log_error';로 설정값을 확인합니다. 서버가 뜨지 않는다면 서비스나 컨테이너의 시작 설정부터 확인하세요. 예시처럼 파일에 쓰려면 mysqld에 대상 디렉터리 쓰기 권한이 필요합니다. 표준 오류 출력으로 보낸 내용은 systemd 저널이나 컨테이너 런타임이 받아 기록할 수 있습니다.
기본 필터인 log_filter_internal에서 log_error_verbosity가 1이면 오류, 2이면 경고까지, 3이면 정보 메시지까지 포함합니다. 별도의 억제 목록도 확인해야 합니다. 종료, 시작, InnoDB 복구 기록을 시간순으로 맞추면 재시작 원인과 이후에 이어진 지연을 구분해 조사할 수 있습니다. MySQL 오류 로그 문서(영어)
2. 슬로우 쿼리 로그(Slow Query Log)
[mysqld]
log_output = FILE
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 1
# log_queries_not_using_indexes = 1
# log_slow_admin_statements = 1
슬로우 쿼리 로그는 기본적으로 꺼져 있으며, long_query_time의 기본값은 10초입니다. 예시의 1초는 조정값이며 min_examined_row_limit 같은 추가 조건도 적용됩니다. 주석 처리한 첫 옵션을 켜면 행 조회에 인덱스를 쓰지 않은 문장이 후보에 들어가고, 실행 시간이 임계값보다 짧은 쿼리도 기록될 수 있습니다. 두 번째 옵션은 ALTER TABLE 같은 관리 문장 가운데 조건을 충족한 실행을 기록합니다. 활성화 전에 로그 증가량을 확인하세요.
log_output은 슬로우 쿼리 로그와 일반 쿼리 로그 모두에 적용됩니다. FILE은 파일에 기록하고, TABLE은 각각 mysql.slow_log와 mysql.general_log에 기록하며, NONE은 출력을 끕니다. 동적 변수를 SET GLOBAL로 바꾼 내용 자체는 재시작 이후 유지되지 않습니다. 기존 연결의 long_query_time도 그대로이므로 새 연결에서 확인하세요. 재시작 후에도 유지하려면 시작 설정에 반영하거나 지원되는 변수에 승인된 SET PERSIST를 사용합니다.
파일에 있는 Query_time과 Lock_time의 단위는 초입니다. Rows_examined와 Rows_sent를 비교하면 읽어 본 행과 반환한 행을 구분할 수 있습니다. 도구를 준비한 뒤 읽기 가능한 로그 사본을 집계합니다.
mysqldumpslow -l -s t /path/to/copied/slow.log
pt-query-digest /path/to/copied/slow.log
이 예시에서 mysqldumpslow는 총 쿼리 시간순으로 그룹을 정렬하고, -l은 잠금 대기 시간을 빼지 않도록 합니다. pt-query-digest는 쿼리를 지문으로 묶어 통계를 보여 줍니다. 운영 환경에서는 서비스의 응답 시간 목표와 감당할 수 있는 로그량, 스토리지 부하를 기준으로 임계값을 정합니다. 슬로우 쿼리 로그(영어) · mysqldumpslow 옵션(영어) · Percona Toolkit(영어)
3. 일반 쿼리 로그(General Log)
[mysqld]
log_output = FILE
general_log = 1
general_log_file = /var/log/mysql/general.log
일반 쿼리 로그는 클라이언트의 연결과 연결 종료, 서버가 수신한 문장을 기록합니다. 애플리케이션이 보낸 SQL을 확인할 수 있지만 실행 성공 여부나 트랜잭션 커밋은 별도의 증거로 확인해야 합니다. 민감한 SQL도 포함될 수 있으므로 접근을 제한합니다.
예시 설정은 시작할 때 로그를 켭니다. 운영에서 잠깐만 조사한다면 시작 설정은 꺼 둡니다. 권한을 가진 운영 담당자가 출력 위치와 여유 공간, 기존 설정을 확인한 뒤 SET GLOBAL general_log = 'ON';을 실행하고, 조사가 끝나면 이전 값으로 돌립니다. 테이블에 기록하더라도 수집 기간과 정리 방법이 필요합니다. 일반 쿼리 로그(영어) · 로그 출력 설정(영어)
4. 바이너리 로그(Binary Log)
[mysqld]
log_bin = /var/log/mysql/mysql-bin
binlog_expire_logs_seconds = 604800
max_binlog_size = 1G
sync_binlog = 1
정상적으로 동작하는 MySQL 8.x 서버는 바이너리 로그를 기본적으로 활성화하지만, 실제 인스턴스의 log_bin 값을 확인하세요. 기록 대상 변경은 이벤트로 저장되며 복제본이 해당 이벤트를 가져갑니다. GTID 자동 위치 지정은 필요한 이벤트를 소스에서 가져올 수 있을 때 누락된 트랜잭션을 요청할 수 있습니다.
특정 시점 복구(PITR)는 일관성 있는 백업을 복원한 뒤 백업에 해당하는 위치에서 목표 시점까지 재생합니다. 해당 구간의 로그가 모두 필요합니다. mysqlbinlog로 로그 사본을 살펴볼 수 있습니다. 재생하면 변경이 적용되므로 먼저 격리된 인스턴스에서 절차를 검증하세요.
예시의 604800초는 7일입니다. 평균 생성량에 보존 기간을 곱해 공간을 추정하고 쓰기량 급증과 대규모 트랜잭션을 위한 여유를 둡니다. 트랜잭션 하나는 여러 파일로 나뉘지 않으므로 파일 크기가 회전 기준인 max_binlog_size를 넘을 수 있습니다. sync_binlog=1은 커밋 그룹이 커밋하기 전에 바이너리 로그를 동기화합니다. InnoDB 커밋의 내구성에는 innodb_flush_log_at_trx_commit과 스토리지 동작도 영향을 줍니다. 바이너리 로그(영어) · GTID 자동 위치 지정(영어) · 특정 시점 복구(영어)
5. 함께 확인할 만한 기록
InnoDB는 비정상 종료 후 복구에 redo를, 롤백과 일관된 읽기에 undo를 사용합니다. Performance Schema의 events_statements_summary_by_digest는 수집한 실행 통계를 문장 다이제스트별로 집계합니다. 개별 실행은 빠르지만 호출이 잦아 누적 시간이 큰 쿼리는 이 집계에서 단서를 찾을 수 있습니다. 기록된 개별 실행은 슬로우 쿼리 로그에서 확인합니다.
오류와 슬로우 쿼리를 같은 시간대에서 확인하기
DataKit이 파일을 읽을 수 있다면 로그 수집 설정(영어)에서 경로를 각각 지정하고 인스턴스와 서비스 태그를 남깁니다. 여러 줄로 된 SQL 한 건을 기준으로 줄 병합이 제대로 되는지 먼저 확인합니다. 표준 슬로우 로그 형식은 MySQL 연동 문서(영어)의 mysql.p를 참고해 이벤트 시간과 query_time, lock_time, rows_examined를 원본과 대조합니다. 오류 로그 파싱은 실제 텍스트 또는 JSON 출력 형식에 맞춥니다.
인스턴스와 시간으로 오류를 좁힌 다음 같은 구간의 쿼리 시간과 검사 행 수를 비교합니다. 필드와 원본 SQL을 수집한 뒤에도 문장 지문을 만들려면 별도의 정규화가 필요합니다. 반복되는 증상을 알림으로 받고 싶다면 Guance 로그 감지(영어)에서 필터, 평가 구간, 건수 임계값을 설정합니다. 오류 로그와 슬로우 쿼리 로그의 보존 기간은 각각 얼마나 이전까지 조사해야 하는지에 맞춥니다.
자주 묻는 질문
슬로우 쿼리 로그를 켜면 MySQL이 느려지나요?
부하는 기록 건수, 출력 위치, 스토리지에 따라 달라집니다. long_query_time을 낮추거나 인덱스를 쓰지 않는 조회를 포함하면 쓰기가 크게 늘 수 있습니다. 실제에 가까운 부하에서 로그량, 디스크 I/O, 쿼리 지연을 함께 비교하세요.
일반 쿼리 로그를 끄는 걸 잊었다면 어떻게 하나요?
파일이나 테이블이 빠르게 커질 수 있습니다. 조사 전 꺼져 있었다면 권한을 가진 담당자가 SET GLOBAL general_log = 'OFF';로 복원합니다. 시작 설정도 바꿨다면 함께 되돌립니다. 테이블 출력 역시 수집 시간과 정리 계획이 필요합니다.
바이너리 로그가 갑자기 디스크를 채우면 어떻게 하나요?
쓰기 속도, 대규모 트랜잭션, 보존 기간을 먼저 확인합니다. 보존 기간을 줄이거나 PURGE BINARY LOGS를 실행하기 전에 백업 복구 범위와 연결이 끊긴 복제본을 포함한 모든 복제본의 진행 위치를 확인하세요. 소스에서 오프라인 복제본이 아직 필요한 로그도 삭제할 수 있습니다. 정리할 때는 서버가 지원하는 방법을 사용하세요. 대규모 트랜잭션을 나누는 방법은 애플리케이션이 별도 커밋을 허용할 때 고려합니다. 바이너리 로그 삭제 동작(영어)
관리형 MySQL에서 파일을 직접 읽을 수 없으면 어떻게 수집하나요?
서비스에서 제공하는 다운로드, 내보내기, 구독 기능으로 로그를 가져온 뒤 해당 형식에 맞춰 파싱합니다. 예를 들어 Amazon RDS for MySQL은 DB 파라미터 그룹에서 슬로우 쿼리 로그와 일반 쿼리 로그를 켭니다. 내보내기 방식에 필요한 출력 설정부터 확인하세요.
