MySQL

MySQL은 여러 데이터베이스에 대한 다중 사용자 액세스를 제공하는 서버로 실행되는 관계형 데이터베이스 관리 시스템입니다. 자세한 내용은 mysql.com을 방문하세요.

기본 요건

MySQL 원격 분석을 수집하려면 작업 에이전트 버전 2.5.0 이상을 설치해야 합니다.

MySQL용 작업 에이전트 구성

작업 에이전트 구성 가이드에 따라 MySQL 인스턴스에서 로그를 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 MySQL에서 로그를 수집 및 처리하고 Linux에서 작업 에이전트를 다시 시작하도록 구성을 만듭니다.

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    mysql_error:
      type: mysql_error
    mysql_general:
      type: mysql_general
    mysql_slow:
      type: mysql_slow
  service:
    pipelines:
      mysql:
        receivers:
          - mysql_error
          - mysql_general
          - mysql_slow
EOF
sudo service google-cloud-ops-agent restart

로그 수집 구성

MySQL에서 로그를 수집하려면 MySQL로 생성되는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

mysql_error 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
type 값은 mysql_error여야 합니다.
include_paths [/var/log/mysqld.log, /var/log/mysql/mysqld.log, /var/log/mysql/error.log] 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다(예: /var/log/mysql/*.log).
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.


mysql_general 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
type 값은 mysql_general여야 합니다.
include_paths [/var/lib/mysql/${HOSTNAME}.log] 읽을 로그 파일입니다.
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.


mysql_slow 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
type 값은 mysql_slow여야 합니다.
include_paths [/var/lib/mysql/${HOSTNAME}-slow.log] 읽을 로그 파일입니다.
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.

로깅되는 내용

mysql_error, mysql_general, mysql_slow 로그의 logName은 구성에 지정된 수신자 ID에서 파생됩니다.

MySQL 버전에 따라 mysql_error 로그의 LogEntry 안에 다음 필드가 포함될 수 있습니다.

필드 유형 설명
jsonPayload.level 문자열 로그 항목 수준
jsonPayload.tid 숫자 로그가 발생된 스레드 ID
jsonPayload.errorCode 문자열 로그와 연결된 MySQL 오류 코드
jsonPayload.subsystem 문자열 로그가 발생된 MySQL 하위 시스템
jsonPayload.message 문자열 로그 메시지
severity 문자열(LogSeverity) 로그 항목 수준(번역됨)
timestamp 문자열(Timestamp) 요청이 수신된 시간

비어 있거나 누락된 필드는 로그 항목에 표시되지 않습니다.


mysql_general 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.tid 숫자 로그가 발생된 스레드 ID
jsonPayload.command 문자열 로깅되는 데이터베이스 작업 유형
jsonPayload.message 문자열 데이터베이스 작업 로그
timestamp 문자열(Timestamp) 항목이 로깅된 시간


mysql_slow 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.user 문자열 쿼리를 실행한 사용자
jsonPayload.database 문자열 쿼리가 실행된 데이터베이스
jsonPayload.host 문자열 데이터베이스 인스턴스의 호스트
jsonPayload.ipAddress 문자열 데이터베이스 인스턴스의 주소
jsonPayload.tid 숫자 쿼리가 로깅된 스레드 ID
jsonPayload.queryTime 숫자 문 실행 시간(초)
jsonPayload.lockTime 숫자 잠금 획득 시간(초)
jsonPayload.rowsSent 숫자 클라이언트에 전송된 행 수
jsonPayload.rowsExamined 숫자 서버 레이어에서 검사한 행 수
jsonPayload.errorNumber 숫자 문 오류 번호 또는 오류가 발생하지 않은 경우 0
jsonPayload.killed 숫자 문이 종료된 경우 이유를 나타내는 오류 번호 또는 문이 정상적으로 종료된 경우 0
jsonPayload.bytesReceived 숫자 모든 클라이언트에서 수신된 바이트 수
jsonPayload.bytesSent 숫자 모든 클라이언트에 전송된 바이트 수
jsonPayload.readFirst 숫자 색인의 첫 번째 항목을 읽은 횟수
jsonPayload.readLast 숫자 색인의 마지막 키를 읽은 요청 수
jsonPayload.readKey 숫자 키를 기준으로 행을 읽은 요청 수
jsonPayload.readNext 숫자 키 순서로 다음 행을 읽은 요청 수
jsonPayload.readPrev 숫자 키 순서로 이전 행을 읽은 요청 수
jsonPayload.readRnd 숫자 고정된 위치를 기준으로 행을 읽은 요청 수
jsonPayload.readRndNext 숫자 데이터 파일의 다음 행을 읽은 요청 수
jsonPayload.sortMergePasses 숫자 정렬 알고리즘이 수행해야 했던 병합 패스 수
jsonPayload.sortRangeCount 숫자 범위를 사용하여 수행한 정렬 횟수
jsonPayload.sortRows 숫자 정렬된 행 수
jsonPayload.sortScanCount 숫자 테이블을 스캔하여 수행한 정렬 횟수
jsonPayload.createdTmpDiskTables 숫자 서버에서 생성된 내부 디스크 임시 테이블 수
jsonPayload.createdTmpTables 숫자 서버에서 생성된 내부 임시 테이블 수
jsonPayload.startTime 문자열 문 실행 시작 시간
jsonPayload.endTime 문자열 문 실행 종료 시간
jsonPayload.message 문자열 쿼리의 전체 텍스트
timestamp 문자열(Timestamp) 항목이 로깅된 시간

  이 필드는 log_slow_extra 시스템 변수가 'ON'으로 설정된 경우에만 제공됩니다. 이 변수는 MySQL 8.0.14부터 지원됩니다.

이러한 필드에 대한 자세한 내용은 MySQL 문서를 참조하세요.

구성 확인

로그 탐색기를 사용하여 MySQL 수신자를 올바르게 구성했는지 확인할 수 있습니다. 작업 에이전트가 로그 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 MySQl 로그를 확인합니다.

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/mysql_error" OR "projects/PROJECT_ID/logs/mysql_general" OR "projects/PROJECT_ID/logs/mysql_slow")