뉴렐릭의 루비 에이전트를 설치하기 전에 시스템이 호환 가능한 운영 시스템, 보안 프로토콜, 루비 버전 및 지원되는 프레임워크/라이브러리에 대한 요구 사항을 충족하는지 확인하세요.
아직 계정이 없다면 먼저 New Relic 계정을 만드세요 . 영원히 무료입니다.
운영체제
루비 에이전트는 Linux, Solaris, FreeBSD, macOS 등 UNIX와 유사한 운영 시스템을 지원합니다. Windows 공식적으로 운영 환경을 지원하지 않지만 개발에는 작동할 수 있습니다.
보안 요구 사항
- 데이터 수집: 데이터 수집을 위한 표준 보안 조치 로, 앱 서버는 뉴렐릭과의 SSL 통신을 위해 SHA-2(256비트)를 지원해야 합니다. SHA-1은 지원되지 않습니다.
- TLS: 뉴렐릭은 에이전트에서 들어오는 모든 연결에 TLS 1.2 이상이 필요합니다.
루비 버전
뉴렐릭 루비 에이전트는 실험적 또는 비공식 루비 버전을 지원하지 않습니다. 에이전트는 공식 루비 릴리스에 대해 지속적으로 테스트됩니다.
루비 구현 | 지원 | Notes |
|---|---|---|
크루비(MRI) | 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.7.x, 2.6.x, 2.5.x, 2.4.x | 루비 2.3.x, 2.2.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
JRuby | 9.x | JRuby 1.7.x: 마지막 에이전트 v3.18.1. 이전 버전은 지원되지 않습니다. |
참고: "에이전트 vX.YZ에서 마지막으로 완전 지원됨"은 에이전트 버전 XYZ가 마지막으로 지원을 보장했음을 의미합니다. 최신 에이전트는 여전히 작동할 수 있지만 이전 Ruby 버전에 대해 적극적으로 테스트되지는 않습니다.
웹 서버
루비 에이전트는 다음과 같은 웹 서버를 지원합니다. 측정, 사용량은 일반적으로 Rack 에 연결됩니다.
웹 서버 | 지원 | Notes |
|---|---|---|
퓨마 | 6.x, 5.x, 4.x, 3.x | 버전 '<' 3.x: 지원이 다를 수 있습니다. |
일각수 | 6.x, 5.x | 버전 '<' 4.x: 지원이 다를 수 있습니다. |
승객 | 6.x, 5.x | 버전 '<' 5.x: 지원이 다를 수 있습니다. |
얇은 | 1.x | |
웨브릭 | 지원되는 루비 버전과 함께 제공됨 | 일반적으로 개발 및 기본 Rack 앱에 지원됩니다. |
매 | 0.30.x 이상 |
웹 프레임워크
루비 에이전트는 이러한 웹 프레임워크에 대한 강력한 측정, 트랜잭션을 제공합니다.
뼈대 | 지원 | Notes |
|---|---|---|
울타리 | 8.0.x, 7.1.x, 7.0.x, 6.1.x, 6.0.x, 5.2.x | Rails 5.1.x, 5.0.x, 4.2.x도 광범위하게 테스트되었습니다. |
시나트라 | 3.x, 2.x | 시나트라 1.4.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. 이전 버전은 지원되지 않습니다. |
고문 | 5.x, 4.x, 3.x | |
포도 | 1.7.x, 1.6.x, 1.5.x, 1.4.x, 1.3.x, 1.2.x | Grape 0.2.0: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. 이전 버전은 완벽하게 지원되지 않을 수 있습니다. |
파드리노 | 0.15.x | 이전 버전(예: 0.14.x)은 에이전트 v8.16.0에서 마지막으로 완벽하게 지원되었습니다. |
Roda | 3.x |
데이터 저장소 및 ORM
에이전트는 다양한 데이터베이스 드라이버 및 개체 관계형 매퍼를 제공합니다.
데이터스토어 / ORM | 보석 이름 | 지원 | Notes |
|---|---|---|---|
액티브 레코드 |
| Rails 버전 보기 | 단독 사용도 지원됩니다. Redshift 어댑터가 인식되었습니다. |
계속 |
| 5.17.0 이상 | 속편 3.37.x, 4.0.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
MongoDB |
| 2.4.0 이상 | 몽고 1.8.x - 2.3.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
Redis |
| 5.x, 4.x, 3.x |
|
Memcached(달리) |
| 3.x, 2.7.x | |
Memcached(memcached gem) |
| 1.8.x | |
엘라스틱서치 |
| 8.x, 7.x |
|
오픈서치 |
| 3.x, 2.1.x | 실험적 지원, Elasticsearch 와 유사한 텔레메트리를 제공합니다. |
DynamoDB(AWS SDK) |
| 3.x |
New Relic은 다양한 데이터베이스 및 데이터베이스 드라이버에 대한 인스턴스 세부 정보를 수집합니다. APM에서 특정 인스턴스 및 데이터베이스 정보 유형을 보는 기능은 New Relic 에이전트 버전에 따라 다릅니다.
다음 어댑터를 지원합니다.
데이터 베이스 | 어댑터 젬 이름 |
|---|---|
PostgreSQL |
|
MySQL |
|
SQLite |
|
이것은 포괄적인 목록이 아닙니다.
현재 New Relic 에이전트에 대해 나열되지 않은 데이터 저장소에서 인스턴스 수준 정보를 요청하려면 support.newrelic.com 에서 지원을 받으십시오.
백그라운드 작업 및 메시징 시스템
널리 사용되는 백그라운드 작업 처리를 위한 측정, 로그 저장소입니다.
시스템/라이브러리 | 보석 이름 | 지원 | Notes |
|---|---|---|---|
사이드키크 |
| 8.x, 7.x, 6.x, 5.x | Sidekiq 4.2.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
요청 |
| 2.x, 1.27.x |
|
지연됨::작업 |
| 4.1.x | Active Record와 Mongoid 백앤드. |
액티브잡 |
| Rails 버전 보기 | |
Bunny (RabbitMQ) |
| 2.x | Bunny 2.0.x - 2.6.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
카프카(루비-카프카) |
| 1.x | |
카프카(rdkafka) |
| 0.15.x+ | |
키네시스(AWS SDK) |
| 3.x | |
파이어호스(AWS SDK) |
| 3.x | |
SQS(AWS SDK) |
| 3.x | |
솔리드큐 |
| ActiveJob 보기 | ActiveJob과 함께 사용됩니다. |
HTTP 클라이언트 및 네트워킹
에이전트는 외부 서비스 모니터링을 위한 다양한 HTTP 클라이언트 역할을 수행합니다.
도서관 | 보석 이름 | 지원 | Notes |
|---|---|---|---|
네트::HTTP | (루비 표준 라이브러리) | 지원되는 루비 버전과 함께 제공됨 | 핵심 HTTP 클라이언트. |
HTTP클라이언트 |
| 2.8.3 이상 | HttpClient 2.2.0 - 2.8.0(현재 2.8.x 이하): 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
장티푸스 |
| 1.4.x 이상 | 타이포이우스 0.5.3 - 1.2.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
엑스콘 |
| 0.56.0 이상 | 엑스콘 '<' 0.55.0: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
에톤 |
| 0.12.0 이상 | |
연석 |
| 0.9.x 이상 | |
HTTPX |
| 1.0.0 이상 | |
HTTP.rb(http gem) |
| 5.x, 4.x, 3.x, 2.x | HttpRb 0.9.9 - 2.2.1: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
패러데이 |
| 측정, 로그는 로그된 어댑터(예: Net::HTTP, Excon)를 통해 작동합니다. | |
비동기::HTTP |
| 0.59.0 이상 | |
gRPC |
| 1.48.0 이상 | gRPC 서버 및 클라이언트 측정의 경우, 리소스입니다. |
AI 및 머신 러닝 라이브러리
뉴렐릭이 AI/ML 라이브러리에 대한 지원을 확대하고 있습니다.
도서관 | 보석 이름 | 지원 | Notes |
|---|---|---|---|
오픈AI |
| 3.4.0 그리고 그 이상 |
|
기타 라이브러리 및 기술
도서관 | 보석 이름 | 지원 | Notes |
|---|---|---|---|
액션케이블 |
| Rails 버전 보기 | |
활성 판매자 |
| 1.65.0 이상 | ActiveMerchant 1.25.0 - 1.64.x: 마지막으로 에이전트 v8.16.0에서 완벽하게 지원되었습니다. |
카피스트라노 |
| 2.15.5 이상 | |
동시 루비 |
| 1.1.5 그리고 그 이상 | |
섬유 | 측정, 루비의 Fiber 클래스 사용입니다. | ||
그래프QL |
| 측정, GraphQL gem에서 제공하는 도구 | |
Lambda (AWS SDK) |
| 자세한 내용은 AWS Lambda 모니터링을 참조하세요. | |
나무꾼 |
| 루비의 로거 라이브러리를 사용하여 APM 로그 포워딩을 지원합니다. | |
로그스태셔 |
| 1.xx 이상 | APM 로그 포워딩을 지원합니다. |
줄무늬 |
| 5.38.0 이상 | |
실 | 측정, 루비의 Thread 클래스 사용. | ||
뷰 구성 요소 | 2.53.x 이상 | ||
야즐-루비 |
| 1.2.1 이상 |
지원되는 버전에 대한 참고 사항
- 해당 에이전트는 명시적으로 나열된 것보다 더 다양한 버전(이전 또는 최신)과 호환될 수 있습니다. 그러나 나열된 버전은 가장 엄격한 테스트를 거쳤습니다.
- 새로 지원되는 버전이나 지원 중단에 대한 최신 정보는 항상 루비 에이전트 릴리스 노트를 참조하세요.
- 라이브러리가 나열되지 않은 경우, 리소스 인 기본 기술(예: Rack 에 구축된 프레임워크 또는 표준 데이터베이스 어댑터를 사용하는 ORM)에 의존하는 경우 여전히 수용체일 수 있습니다. 중요한 미등록 라이브러리의 경우 사용자 정의 측정을 탐색하거나 기능 요청을 제출할 수 있습니다.
여기에 언급되지 않은 특정 버전이나 라이브러리에 대한 질문이 있는 경우 Explorers Hub 커뮤니티 포럼을 방문하세요.
기타 APM 소프트웨어
귀하의 애플리케이션이 당사 에이전트 외에 다른 APM(애플리케이션 성능 모니터링) 소프트웨어를 사용하는 경우 당사는 당사 에이전트가 올바르게 작동한다고 보장할 수 없으며 기술 지원을 제공할 수 없습니다. 자세한 내용은 다른 모니터링 소프트웨어 사용 시 오류를 참조하십시오.
에이전트를 New Relic의 다른 부분에 연결
Ruby 에이전트는 다른 New Relic 기능과 통합되어 종단 간 가시성을 제공합니다.
능력 | 설명 |
|---|---|
루비 에이전트와 | |
루비 에이전트는 자동 측정, 자동 로그를 활성화할 때 브라우저 JavaScript 에이전트를 자동으로 주입합니다. 브라우저를 활성화한 후 APM 요약 페이지 에서 데이터를 보고 특정 앱에 대한 APM 과 브라우저 데이터 간에 빠르게 전환할 수 있습니다. 설정 옵션 및 수동 측정에 대한 내용은 브라우저 및 루비 에이전트 문서를 참조하세요. | |
인프라와 APM 에이전트를 동일한 호스트에 설치하면 자동으로 서로를 감지합니다. 그런 다음 APM UI에서 호스트 목록을 보고 인프라 UI에서 APM 앱별로 호스트를 필터링할 수 있습니다. 자세한 내용은 인프라 UI의 APM 데이터를 참조하십시오. | |
합성 트랜잭션 추적 은 합성 모니터의 요청을 기본 APM 트랜잭션으로 연결합니다. |