MariaDB

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

MariaDB에 대한 자세한 내용은 mariadb.org를 참조하세요.

기본 요건

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

이 수신자는 MariaDB 버전 10.1.X~10.7.X를 지원합니다.

MariaDB 인스턴스 구성

MariaDB는 커뮤니티에서 개발하여 상업적으로 지원되는 MySQL 관계형 데이터베이스 관리 시스템(RDBMS)의 포크입니다. MariaDB의 로그와 측정항목을 수집하려면 mysql 수신자를 사용합니다.

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

MariaDB용 운영 에이전트 구성

운영 에이전트 구성 가이드에 따라 MariaDB 인스턴스에서 로그와 측정항목을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 구성 파일을 만들어 MariaDB의 로그와 측정항목을 수집하고 Linux에서 운영 에이전트를 다시 시작합니다.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    mysql:
      type: mysql
  service:
    pipelines:
      mysql:
        receivers:
        - mysql
logging:
  receivers:
    mysql_error:
      type: mysql_error
    mysql_general:
      type: mysql_general
    mysql_slow:
      type: mysql_slow
    # Collect the primary's error log just for debugging the test
    mysql_error_2:
      type: mysql_error
      include_paths:
      - /run/mysqld/mysqld2.err
  service:
    pipelines:
      mysql:
        receivers:
          - mysql_error
          - mysql_general
          - mysql_slow
      mysql2:
        receivers:
          - mysql_error_2
EOF

sudo service google-cloud-ops-agent restart
sleep 60

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

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

로그 수집 구성

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

mysql_error 로깅 수신자는 다음 표에 표시된 기본 파일 경로에서 로그를 수집합니다. 일부 플랫폼에서는 MariaDB가 파일 대신 기본적으로 journald에 로깅됩니다. 대신 파일에 로깅하도록 MariaDB를 구성하려면 MariaDB 구성 log_error 옵션을 설정합니다. log_error 구성에 대한 자세한 내용은 파일에 오류 로그 작성을 참조하세요.

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 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
wildcard_refresh_interval 60s include_paths의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: 30s 또는 2m)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.


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

필드 기본값 설명
type 값은 mysql_general여야 합니다.
include_paths [/var/lib/mysql/${HOSTNAME}.log] 읽을 로그 파일입니다.
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
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 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
wildcard_refresh_interval 60s include_paths의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: 30s 또는 2m)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

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

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

필드 유형 설명
jsonPayload.level 문자열 로그 항목 수준
jsonPayload.tid 숫자 로그가 발생된 스레드 ID
jsonPayload.errorCode 문자열 로그와 연결된 MariaDB 오류 코드
jsonPayload.subsystem 문자열 로그가 시작되는 MariaDB 하위 시스템
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 문서를 참조하세요.

측정항목 수집 구성

MariaDB에서 측정항목을 수집하려면 MariaDB 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

이 수신자는 구성에서 여러 인스턴스 모니터링과 같은 여러 인스턴스의 사용을 지원하지 않습니다. 이러한 모든 인스턴스는 동일한 시계열에 기록되며, Cloud Monitoring은 이를 구분할 수 있는 방법이 없습니다.

MariaDB 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

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

모니터링 대상

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

측정항목 유형 
종류, 유형
모니터링 리소스		 라벨
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

구성 확인

이 섹션에서는 MariaDB 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 운영 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

MariaDB 로그가 Cloud Logging으로 전송되고 있는지 확인하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.

  2. 편집기에 다음 쿼리를 입력한 후 쿼리 실행을 클릭합니다. 
    resource.type="gce_instance"
(log_id("mysql_error") OR log_id("mysql_general") OR log_id("mysql_slow"))

MariaDB 측정항목이 Cloud Monitoring으로 전송되고 있는지 확인하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서  측정항목 탐색기 페이지로 이동합니다.

    측정항목 탐색기로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 쿼리 빌더 창의 툴바에서 이름이  MQL 또는  MQL인 버튼을 선택합니다.
  3. MQL 전환 버튼에 MQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.
  4. 편집기에 다음 쿼리를 입력한 후 쿼리 실행을 클릭합니다. 
    fetch gce_instance
| metric 'workload.googleapis.com/mysql.commands'
| align rate(1m)
| every 1m

대시보드 보기

MariaDB 측정항목을 보려면 차트 또는 대시보드가 구성되어 있어야 합니다. MariaDB는 MySQL과 동일한 대시보드를 사용합니다. 통합을 구성하고 운영 에이전트가 측정항목 데이터 수집을 시작한 후 모든 대시보드가 자동으로 설치됩니다.

통합을 설치하지 않고도 대시보드의 정적 미리보기를 볼 수 있습니다.

설치된 대시보드를 보려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서  대시보드 페이지로 이동합니다.

    대시보드로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. 대시보드 목록 탭을 선택한 후 통합 카테고리를 선택합니다.
  3. 확인할 대시보드의 이름을 클릭합니다. MariaDB는 MySQL과 동일한 대시보드를 사용합니다.

통합을 구성했지만 대시보드가 설치되지 않은 경우 운영 에이전트가 실행 중인지 확인합니다. 대시보드에 차트의 측정항목 데이터가 없으면 대시보드 설치가 실패합니다. 운영 에이전트가 측정항목 수집을 시작하면 대시보드가 자동으로 설치됩니다.

대시보드의 정적 미리보기를 보려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서  통합 페이지로 이동합니다.

    통합으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. Compute Engine 배포 플랫폼 필터를 클릭합니다.
  3. MySQL 항목을 찾고 세부정보 보기를 클릭합니다. MariaDB는 MySQL과 동일한 대시보드를 사용합니다.
  4. 정적 미리보기를 보려면 대시보드 탭을 선택합니다. 대시보드가 설치되어 있으면 대시보드 보기를 클릭하여 대시보드로 이동할 수 있습니다.

Cloud Monitoring의 대시보드에 대한 자세한 내용은 대시보드 및 차트를 참조하세요.

통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.

알림 정책 설치

알림 정책은 지정된 조건이 발생할 때 Cloud Monitoring에서 알림을 받도록 지시합니다. MariaDB는 MySQL과 동일한 알림 정책을 사용합니다. Monitoring의 통합 페이지에서 이러한 알림 정책을 보고 설치할 수 있습니다.

사용 가능한 알림 정책에 대한 설명을 보고 설치하려면 다음을 수행합니다.

  1. Google Cloud 콘솔에서  통합 페이지로 이동합니다.

    통합으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. MySQL 항목을 찾고 세부정보 보기를 클릭합니다. MariaDB는 MySQL과 동일한 알림 정책을 사용합니다.
  3. 알림 탭을 선택합니다. 이 탭에는 사용 가능한 알림 정책에 대한 설명과 이를 설치하기 위한 인터페이스가 제공됩니다.
  4. 알림 정책을 설치합니다. 알림 정책은 경고가 트리거되었다는 알림을 전송할 위치를 알아야 하므로, 설치 시 사용자에게 해당 정보를 요청합니다. 알림 정책을 설치하려면 다음을 수행합니다.
    1. 사용 가능한 알림 정책 목록에서 설치할 정책을 선택합니다.

    2. 알림 구성 섹션에서 알림 채널을 하나 이상 선택합니다. 알림 채널 사용을 중지할 수 있지만 사용 중지하면 알림 정책이 자동으로 실행됩니다. Monitoring에서 상태를 확인할 수 있지만 알림이 수신되지 않습니다.

      알림 채널에 대한 자세한 내용은 알림 채널 관리를 참조하세요.

    3. 정책 만들기를 클릭합니다.

Cloud Monitoring의 알림 정책에 대한 자세한 내용은 알림 소개를 참조하세요.

통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 서드 파티 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 [운영 에이전트를 설치하여 서드 파티 애플리케이션 문제 해결](https://www.youtube.com/watch?v=GQgNygd-XJU&t=7s) 동영상을 참조하세요.