Self-hosted를 사용하여 MySQL 모니터링을 위한 NRDOT 설치 및 구성

전제 조건

설치하기 전에 다음을 갖추고 있는지 확인하십시오:

• New Relic 라이센스 키 .

• MySQL 인스턴스에 대한 관리자 액세스 권한입니다.

• NRDOT Collector를 설치하는 호스트와 MySQL 데이터베이스 간의 네트워크 연결

• 뉴렐릭 OTLP 엔드포인트 문서에 대한 네트워크 연결

  지원되는 MySQL 버전, 필수 권한 및 performance_schema 요구 사항은 호환성 및 전제 조건을 참조하십시오.

NRDOT Collector 설정

시스템에 NRDOT Collector를 설치하십시오:

데이터베이스 사용자 구성

MySQL 데이터베이스 인스턴스에 필요한 권한을 가진 모니터링 사용자를 생성합니다.

• 모니터링 사용자를 생성하려면 MySQL 데이터베이스에서 다음 명령을 실행하십시오:

  CREATE USER '<YOUR_DB_USERNAME>'@'%' IDENTIFIED BY '<YOUR_DB_PASSWORD>';

  카피

• 쿼리 샘플 및 상위 쿼리를 수집하려면 모니터링 사용자에게 다음 권한을 부여하십시오:

  GRANT SELECT ON performance_schema.* TO '<YOUR_DB_USERNAME>'@'%';
  GRANT SELECT ON *.* TO '<YOUR_DB_USERNAME>'@'%';
  GRANT REPLICATION CLIENT ON *.* TO '<YOUR_DB_USERNAME>'@'%';
  GRANT PROCESS ON *.* TO '<YOUR_DB_USERNAME>'@'%';

  카피

• (선택 사항) 뉴렐릭 플랫폼에서 대기 시간 데이터를 보려면 모니터링 사용자에게 다음 권한을 부여하십시오:

  GRANT UPDATE ON performance_schema.setup_consumers TO '<YOUR_DB_USERNAME>'@'%';

  카피

• (선택 사항) 연결 및 권한을 확인하려면 다음을 실행하십시오:

  bash

  카피

  $
  mysql -h <YOUR_DB_HOST> -P <YOUR_DB_PORT> -u <YOUR_DB_USERNAME> -p -e "SELECT 1;"

  명령이 오류 없이 완료되면 모니터링 사용자, 호스트 및 포트가 모두 올바른 것입니다.

NRDOT Collector구성

MySQL 특정 설정으로 NRDOT Collector를 구성하십시오.

이 설정은 nrmysql 수신기만을 사용한 필수 MySQL 모니터링에 중점을 둡니다.

1. mysql-config.yaml이라는 이름의 설정 파일을 생성합니다:

   bash

   카피

   $
   sudo nano /etc/nrdot-collector/mysql-config.yaml

2. 이전 단계에서 생성한 mysql-config.yaml 파일에 다음 설정을 추가하십시오.

   receivers:
     nrmysql:
       endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
       transport: tcp
       username: "<YOUR_DB_USERNAME>"
       password: "<YOUR_DB_PASSWORD>"
       allow_native_passwords: true
       collection_interval: 15s
       initial_delay: 1s
       explain_mode: procedure
       statement_events:
         digest_text_limit: 4096
         time_limit: 24h
         limit: 500
       query_sample_collection:
         max_rows_per_query: 100
         allowed_comment_keys: [nr_service_guid]
       top_query_collection:
         lookback_time: 60
         max_query_sample_count: 5000
         top_query_count: 200
         collection_interval: 60s
         query_plan_cache_size: 1000
         query_plan_cache_ttl: 1h
         allowed_comment_keys: [nr_service_guid]
       events:
         db.server.query_sample:
           enabled: true
         db.server.top_query:
           enabled: true
         db.server.query_plan:
           enabled: true
       resource_attributes:
         db.system.version:
           enabled: true
       metrics:
         mysql.query.count:
           enabled: true
         mysql.query.slow.count:
           enabled: true
         mysql.commands:
           enabled: true
         mysql.innodb.data_file.io:
           enabled: true
   
   processors:
     batch:
   
   exporters:
     otlp/newrelic:
       endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
       headers:
         api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
       compression: gzip
       retry_on_failure:
         enabled: true
         initial_interval: 5s
         max_interval: 30s
         max_elapsed_time: 300s
   
   service:
     pipelines:
       metrics:
         receivers: [nrmysql]
         processors: [batch]
         exporters: [otlp/newrelic]
       logs:
         receivers: [nrmysql]
         processors: [batch]
         exporters: [otlp/newrelic]

   카피

   팁

   이 설정은 선택 사항인 database 및 tls 필드를 생략합니다. 기본적으로 수신기는 모니터링 사용자가 액세스할 수 있는 모든 데이터베이스를 모니터하고 TLS 없이 연결합니다. 특정 데이터베이스를 모니터하려면 또는 TLS를 활성화하려면 (대부분의 Amazon RDS/Aurora 인스턴스에 필요) 상세 인사이트 활성화를 참조하십시오.

   구성 매개변수

   다음 표에서는 nrmysql 수신자에 대한 주요 설정 초기화에 대해 설명합니다.

   매개변수	설명
   <YOUR_DB_HOST>	MySQL 호스트 이름 또는 IP 주소를 입력하십시오.
   <YOUR_DB_PORT>	MySQL 포트 번호를 입력하십시오. 기본값은 3306 입니다.
   <YOUR_DB_USERNAME>	데이터베이스 사용자 구성에서 생성한 모니터링 사용자의 사용자 이름을 입력하십시오.
   <YOUR_DB_PASSWORD>	데이터베이스 사용자 설정에서 생성한 모니터링 사용자의 비밀번호를 입력합니다.
   <YOUR_NEWRELIC_OTLP_ENDPOINT>	뉴렐릭 OTLP 엔드포인트를 입력하십시오. 자세한 내용은 뉴렐릭 OTLP 엔드포인트를 참조하십시오.
   <YOUR_NEWRELIC_LICENSE_KEY>	뉴렐릭 라이선스 키를 입력하십시오.
   transport	네트워크를 통해 연결하도록 기본값이 tcp (으)로 설정되어 있습니다. NRDOT Collector가 MySQL과 동일한 호스트에서 실행되는 경우, 대신 unix을(를) 사용하여 Unix 도메인 소켓을 통해 연결하십시오.
   collection_interval	메트릭 스크랩 간격을 입력하십시오. 기본값: 15s.
   explain_mode	기본값은 inline으로 설정되어 있습니다. 모니터링 사용자에게 DML 권한을 부여하지 않고 쓰기 문에 대한 쿼리 계획을 수집하려면 값을 procedure (으)로 설정하십시오. 쓰기 문에 대한 쿼리 계획을 참조하십시오.

NRDOT Collector 설정 유효성 검사

1. 새 mysql-config.yaml 파일을 가리키도록 설정 경로를 업데이트하십시오:

   bash

   카피

   $
   sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/mysql-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

2. NRDOT Collector 설정을 검증하여 형식이 올바르고 제대로 작동하는지 확인합니다:

   bash

   카피

   $
   sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/mysql-config.yaml

NRDOT Collector를 다시 시작하십시오

설정을 업데이트한 후 NRDOT Collector 서비스를 다시 시작하십시오:

$
sudo systemctl restart nrdot-collector

수집기가 제대로 실행되고 있는지 확인하려면 서비스 상태를 확인하십시오:

$
sudo systemctl status nrdot-collector

데이터 찾기 및 사용

데이터가 수집되면 뉴렐릭 UI를 통해 포괄적인 MySQL 데이터베이스 모니터링에 액세스할 수 있습니다.

뉴렐릭에서 MySQL 데이터베이스 엔티티를 찾으려면 다음을 수행하십시오:

1. https://one.newrelic.com > All Capabilities > Databases 으)로 이동합니다.

2. Entity type 드롭다운 메뉴에서 MySQL instance을(를) 선택한 다음 Apply을(를) 클릭합니다.

3. 엔티티 목록에서 MySQL 데이터베이스를 선택하십시오.

   NRDOT를 사용하여 MySQL 데이터베이스 모니터링을 설정한 후:

   • 사용자 정의 대시보드를 만들어 데이터베이스 지표를 시각화하세요.
   • 중요한 데이터베이스 성능에 대한 알림 설정, 참조 값