NRDOT로 MySQL 모니터링을 시작하기 전에 환경이 다음 요구 사항을 충족하는지 확인하십시오.
전제 조건
시작하기 전에 다음 사항이 있는지 확인하세요.
- 유효한 뉴렐릭 클러스터
- NRDOT Collector를 설치하는 호스트와 MySQL 데이터베이스 간의 네트워크 연결입니다. MySQL 데이터베이스와 다른 호스트에 NRDOT Collector를 설치하려는 경우 네트워크 액세스 요구 사항을 참조하십시오.
- 뉴렐릭 OTLP 엔드포인트 문서에 대한 네트워크 연결
- 이 통합은 뉴렐릭 퍼블릭 프리뷰 프로그램의 일환으로 제공됩니다. 미리 보기 및 평가판 페이지에서 옵트인하려면 조직 관리자에게 문의하세요.
지원되는 MySQL 버전
수신기는 첫 번째 연결 시 데이터베이스 제품 및 버전을 감지하고 그에 따라 동작을 조정합니다 — 지원되지 않거나 이전 버전도 계속 작동하지만 기능이 제한됩니다:
버전 | 쿼리 계획 활성화
| Traceparent 전파 |
/
| 복제본 상태 구문 |
|---|---|---|---|---|
| 아니요 | 네 | 0 |
|
–
| 아니요 | 네 | 0 |
|
–
| 네 | 네 | 0 |
|
| 네 | 네 | 채워짐 |
|
| 네 | 네 | 채워짐 |
|
| 네 | 네 | 채워짐 |
|
중요
버전 감지는 치명적이지 않습니다: 실패할 경우 수신기는 오류를 발생시키는 대신 MySQL < 8 동작으로 대체됩니다.
네트워크 액세스 요구 사항
기본적으로 NRDOT는 TCP (수신기 구성의 transport: tcp, 기본값)를 통해 연결합니다. 수집기가 데이터베이스와 동일한 호스트에서 실행되는 경우, 대신 transport: unix을(를) 설정하고 endpoint을(를) 데이터베이스의 Unix 도메인 소켓(예: /var/run/mysqld/mysqld.sock)에 지정하여 아래의 네트워크 검사를 완전히 우회할 수 있습니다. 다른 모든 배포 ― 수집기와 데이터베이스가 다른 호스트, 컨테이너 또는 VPC에 있는 경우 ― 에는 TCP가 필요합니다.
전개 | 확인해야 할 사항 |
|---|---|
EC2의 자체 관리형 MySQL | 보안 그룹 : 수집기가 다른 EC2 인스턴스에서 실행되는 경우 수집기의 소스 ― 자체 보안 그룹 ID(원시 IP보다 선호되는 동일한 VPC) ― 에서 DB 포트(기본값
)에 인바운드 규칙을 추가하며, 동일한 인스턴스에서 사이드카로 실행되는 경우에는 규칙이 필요하지 않습니다.
의
도 확인하십시오: 많은 배포판 기본값은 로컬이 아닌 모든 TCP 연결을 거부하는
을(를) 제공합니다 ― 원격 수집기가 도달하기 전에 이를 인스턴스의 프라이빗 IP 또는
(으)로 설정하십시오. |
MySQL용 Amazon RDS/Aurora | VPC 보안 그룹 : 수집기의 보안 그룹 또는 프라이빗 IP에서 RDS 인스턴스의 포트(기본값
)에 인바운드 규칙을 추가하십시오, RDS에는 편집할 수 있는 OS 수준
이(가) 없으므로 이것이 유일한 네트워크 게이트입니다. 권한 부여 는 RDS 마스터 사용자로부터 와야 합니다 ― RDS에는
계정이 없습니다. 제한된 권한 :
및
는 RDS 엔진 버전 및 파라미터 그룹에 따라 제한되거나 사용할 수 없습니다. TLS : "Require SSL/TLS" 적용이 있는 RDS 인스턴스는 수집기가 Amazon의 RDS CA를 신뢰해야 합니다 ―
(또는
)를 로 설정하고
/
을(를)
(으)로 유지하십시오. |
모든 원격/교차 호스트 배포 | MySQL은 동일한 사용자 이름이라도
및
(또는 특정 호스트/CIDR)을 다른 계정 으로 취급합니다 — 모니터링 사용자를
(으)로 생성하면 다른 곳에서 실행 중인 수집기에서 인증이 조용히 실패하며, 잘못된 비밀번호와 구별할 수 없는 액세스 거부 오류가 발생합니다.
을(를) 사용하거나 수집기의 특정 사설 IP/CIDR로 범위를 지정하십시오. |
중요
라이브 Amazon RDS for MySQL 인스턴스에 대해 확인됨: RDS의 mysql8.0 파라미터 그룹 제품군은 performance_schema_consumer_* 파라미터를 전혀 노출하지 않습니다 ― 크기 조정/버퍼 파라미터와 performance_schema, slow_query_log, long_query_time만 설정할 수 있습니다. 이는 events_waits_current (mysql.events_waits_current.timer_wait 및 대기 기반 대시보드에 일반적으로 필요함)를 RDS의 런타임에만 켤 수 있으며, 재시작이나 장애 조치 시 유지되지 않음을 의미합니다.
권장되는 서버 측 설정
수신기가 사용 가능한 모든 메트릭과 쿼리 계획을 수집할 수 있도록 이러한 MySQL 서버 파라미터를 구성하십시오. 다음 표에는 파라미터와 권장 값이 나열되어 있습니다:
매개변수 | 권장 값 | 이유 |
|---|---|---|
| 활성화됨 | 쿼리 샘플, 상위 쿼리 및 차단 감지는 모두 이에 의존합니다. |
|
| MySQL이 자르기 전의 더 긴 다이제스트 텍스트 |
|
| 성능 스키마 계층에서도 동일합니다. |
|
| 캡처된 명령문이 잘리면 수신기는 해당 명령문에 대해
을(를) 완전히 건너뜁니다. 기본값인
바이트에서는 긴 명령문에 대한 쿼리 계획이 조용히 사라집니다. |
다음 단계
환경이 이러한 사전 요구 사항을 충족하는지 확인한 후:
- 설치 방법을 선택하세요:
- 수집될 사용 가능한 메트릭을 검토하십시오.
- 쓰기 명령문 쿼리 계획 및 잠금 대기 시간 추적과 같은 선택적 기능에 대해서는 고급 설정을 참조하십시오.
- 일반적인 문제에 대해서는 문제 진단, 해결 가이드를 확인하십시오.