MySQL

MySQL 통합은 InnoDB, 버퍼 풀, 기타 여러 작업과 관련된 성능 측정항목을 수집합니다. 또한 일반 로그, 오류 로그, 느린 쿼리 로그를 수집하여 JSON 페이로드로 파싱합니다. 오류 로그는 오류 코드 및 하위 시스템에 대해 파싱됩니다. 느린 쿼리 로그는 쿼리 시간 및 검사된 행을 포함하여 쿼리 성능을 설명하는 키-값 쌍으로 파싱됩니다.

MySQL에 대한 자세한 내용은 mysql.com을 참조하세요.

기본 요건

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

이 수신자는 MySQL 버전 5.7 및 8.0을 지원합니다.

MySQL 인스턴스 구성

mysql 수신자는 기본적으로 Unix 소켓과 Unix 인증을 root 사용자로 사용하여 로컬 MySQL 서버에 연결합니다.

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
metrics:
  receivers:
    mysql:
      type: mysql
  service:
    pipelines:
      mysql:
        receivers:
          - mysql
EOF
sudo service google-cloud-ops-agent restart

사용자 이름과 비밀번호를 사용하여 TCP 연결을 통해 MySQL 인스턴스에 연결하려면 측정항목 수신자에 사용자 이름과 비밀번호를 지정합니다. 예를 들면 다음과 같습니다.

metrics:
  receivers:
    mysql:
      type: mysql
      endpoint: localhost:3306
      password: pwd
      username: usr
  service:
    pipelines:
      mysql:
        receivers:
          - mysql

로그 수집 구성

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` 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
`wildcard_refresh_interval`	`60s`	`include_paths`의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: `30s` 또는 `2m`)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

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

필드	기본값	설명
`type`		값은 `mysql_general`여야 합니다.
`include_paths`	`[/var/lib/mysql/${HOSTNAME}.log]`	읽을 로그 파일입니다.
`exclude_paths`	`[]`	`include_paths` 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
`wildcard_refresh_interval`	`60s`	`include_paths`의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: `30s` 또는 `2m`)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

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

필드	기본값	설명
`type`		값은 `mysql_slow`여야 합니다.
`include_paths`	`[/var/lib/mysql/${HOSTNAME}-slow.log]`	읽을 로그 파일입니다.
`exclude_paths`	`[]`	`include_paths` 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
`wildcard_refresh_interval`	`60s`	`include_paths`의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: `30s` 또는 `2m`)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

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에서 측정항목을 수집하려면 MySQL 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다. MySQL 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`type`		값은 `mysql`여야 합니다.
`endpoint`	`localhost:3306`	MySQL에서 노출한 URL입니다.
`collection_interval`	`60s`	time.Duration 값(예: `30s` 또는 `5m`)입니다.
`username`	`root`	서버를 연결하는 데 사용되는 비밀번호입니다.
`password`		서버 연결에 사용되는 비밀번호입니다.

모니터링 대상

다음 표에서는 작업 에이전트가 MySQL 인스턴스에서 수집하는 측정항목의 목록을 보여줍니다.

측정항목 유형
종류, 유형 모니터링 리소스	라벨
`workload.googleapis.com/mysql.buffer_pool_operations`
`CUMULATIVE`, `INT64` gce_instance	`operation`
`workload.googleapis.com/mysql.buffer_pool_pages`
`GAUGE`, `DOUBLE` gce_instance	`kind`
`workload.googleapis.com/mysql.buffer_pool_size`
`GAUGE`, `DOUBLE` gce_instance	`kind`
`workload.googleapis.com/mysql.commands`
`CUMULATIVE`, `INT64` gce_instance	`command`
`workload.googleapis.com/mysql.double_writes`
`CUMULATIVE`, `INT64` gce_instance	`kind`
`workload.googleapis.com/mysql.handlers`
`CUMULATIVE`, `INT64` gce_instance	`kind`
`workload.googleapis.com/mysql.locks`
`CUMULATIVE`, `INT64` gce_instance	`kind`
`workload.googleapis.com/mysql.log_operations`
`CUMULATIVE`, `INT64` gce_instance	`operation`
`workload.googleapis.com/mysql.operations`
`CUMULATIVE`, `INT64` gce_instance	`operation`
`workload.googleapis.com/mysql.page_operations`
`CUMULATIVE`, `INT64` gce_instance	`operation`
`workload.googleapis.com/mysql.row_locks`
`CUMULATIVE`, `INT64` gce_instance	`kind`
`workload.googleapis.com/mysql.row_operations`
`CUMULATIVE`, `INT64` gce_instance	`operation`
`workload.googleapis.com/mysql.sorts`
`CUMULATIVE`, `INT64` gce_instance	`kind`
`workload.googleapis.com/mysql.threads`
`GAUGE`, `DOUBLE` gce_instance	`kind`

샘플 대시보드

샘플 Cloud Monitoring 대시보드를 사용하여 이 통합의 측정항목을 확인할 수 있습니다. 샘플 대시보드 설치 절차를 완료하여 샘플 라이브러리에서 MySQL GCE 개요 대시보드를 가져오고 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")

측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.

fetch gce_instance
| metric 'workload.googleapis.com/mysql.commands'
| align rate(1m)
| every 1m

다음 단계

Ansible을 사용하여 작업 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 작업 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.