SQL 쿼리 주석 기능을 통해 애플리케이션과 데이터베이스 성능 간의 원활한 상관관계를 파악하십시오. 이 메커니즘을 통해 뉴렐릭의 NRDOT(Distribution of OpenTelemetry) 데이터베이스 수신기는 특정 데이터베이스 로드, 느린 쿼리 또는 차단 이벤트를 담당하는 서비스를 정확하게 식별할 수 있습니다.
중요
뉴렐릭은 애플리케이션의 데이터베이스 연결 주소 및 포트를 데이터베이스 모니터링 에이전트의 연결 주소 및 포트와 일치시켜 뉴렐릭 애플리케이션 성능 모니터링(뉴렐릭 APM) 및 데이터베이스 엔티티를 연결합니다. 이 연결은 양쪽에서 정확히 동일한 주소와 포트를 보고할 때 안정적으로 작동합니다. 그러나 애플리케이션이 로드 밸런서나 프록시를 통해 트래픽을 라우팅하거나 두 구성 요소가 다른 주소 형식(예: IP 주소 대 도메인 이름)을 사용하는 경우 자동 연결이 실패할 수 있습니다.
전제 조건
- 자바 에이전트: 버전
9.1.0이상. - .NET 에이전트: 버전
10.52.0이상.
저항력에 대한 APM-DB 상관관계 활성화
이 상관관계를 활성화하려면 자바 에이전트 설정 파일(newrelic.yml)의 transaction_tracer 섹션에 sql_metadata_comments 속성을 추가합니다. 자세한 내용은 자바 에이전트 설정 문서를 참조하세요.
transaction_tracer: sql_metadata_comments: nr_service_guid.NET 에이전트에 대한 APM-DB 상관관계 활성화
이 상관관계를 활성화하려면 .NET 에이전트 설정 파일(newrelic.config)의 transactionTracer 섹션에 sqlMetadataComments 속성을 추가하십시오. 자세한 내용은 .NET 에이전트 설정 문서를 참조하십시오.
작동 원리
애플리케이션이 데이터베이스에 쿼리를 전송하면 APM 에이전트가 자동으로 APM 엔티티 GUID를 SQL 텍스트 앞에 주석으로 추가합니다. 이러한 일반적인 업계 관행은 SQL 문의 실행 논리에 영향을 미치지 않습니다.
- 주석 추가: APM 에이전트는 나가는 SQL 앞에 주석 문자열을 추가합니다(예:
/* nr_service_guid="MTE2MDAzMTl8QVBNfEFQUExJ" */ SELECT * FROM orders...). - 실행: 데이터베이스는 평소와 같이 쿼리를 실행합니다. 댓글은 데이터베이스의 내부 성능 스키마(예:
sys.dm_exec_requests또는v$session)에 저장됩니다. - 추출: 데이터베이스 수신기는 이러한 쿼리(활성, 느린 또는 차단)를 가져옵니다.
- 보강: 수신자는 댓글을 구문 분석하고
nr_service_guid을 추출하여 데이터베이스 메트릭에 차원으로 추가합니다.
서비스 혜택
서비스 메타데이터를 앞에 추가하면 데이터베이스 생태계에 대한 높은 수준의 가시성을 확보할 수 있습니다.
- 서비스 수준 원인 파악: 데이터베이스 CPU 또는 메모리 사용량 급증의 원인이 되는 마이크로서비스를 즉시 확인할 수 있습니다.
- 개선된 느린 쿼리 분석: 데이터베이스 병목현상이 특정 애플리케이션 버전에 국한된 것인지 파악하려면
client_name(으)로 느린 쿼리 로그를 필터링하십시오. - 블로킹 및 교착 상태 해결: 블로킹의 "소유자"를 신속하게 식별하여 팀 간 협업을 가속화합니다. 문제 진단, 해결
보안 및 성능 영향
이 메커니즘은 데이터베이스 작업에 보이지 않도록 설계되었습니다:
기능 | 영향 상세 정보 |
|---|---|
실행 논리 | 데이터베이스 엔진의 옵티마이저는 SQL 주석을 무시합니다. |
데이터베이스 오버헤드 | 짧은 문자열(일반적으로 50자 미만)을 추가하는 것은 네트워크 대역폭이나 메모리에 거의 영향을 미치지 않습니다. |
데이터 프라이버시 | 서비스 GUID만 삽입됩니다. 댓글에는 민감한 애플리케이션 데이터나 사용자 컨텍스트가 포함되어 있지 않습니다. |
비밀 관리
NRDOT Collector 설정에서 데이터베이스 암호와 같은 민감한 자격 증명을 관리하는 데 사용할 수 있는 두 가지 안전한 방법이 있습니다. 인프라 및 보안 정책에 가장 적합한 방법을 선택하십시오.