Antes de instalar o agente Ruby da New Relic, certifique-se de atender a estes requisitos de sistema operacional compatível, requisitos de segurança e estrutura suportada.
Se você ainda não tem uma, comece criando uma conta New Relic. É grátis, para sempre.
Sistema operacional
O agente Ruby oferece suporte a sistemas operacionais semelhantes a UNIX, como Linux, Solaris, FreeBSD e macOS.
Requisitos de segurança
Como medida de segurança padrão para coleta de dados, o servidor do seu aplicativo deve oferecer suporte a SHA-2 (256 bits). SHA-1 não é compatível. New Relic requer TLS 1.2 ou superior para todas as conexões de entrada.
Versões Ruby
O agente New Relic Ruby não oferece suporte a versões experimentais. As versões Ruby suportadas pelo agente Ruby incluem:
Versões Ruby | Suportado | Descontinuada |
|---|---|---|
JRuby |
|
|
CRuby |
|
|
Servidores web
Os servidores Web suportados pelo agente Ruby incluem:
Servidores web | Suportado | Descontinuada |
|---|---|---|
Passageiro |
|
|
Puma |
|
|
Rainbows! |
| 4.5.0: O último agente suportado foi 8.16.0. |
Thin |
| |
Unicorn |
|
|
Webrick | Compatível com todas as versões do Ruby com suporte de agente |
Web frameworks
O agente Ruby não oferece suporte a versões experimentais. A estrutura da Web suportada pelo agente Ruby está listada abaixo. Observe que Grape, Padrino e Sinatra não são compatíveis com Ruby 3.0+.
Web frameworks | Suportado | Descontinuada |
|---|---|---|
Grape |
|
|
Padrinho |
|
|
Rack |
|
|
Rails |
|
|
Roda |
| |
Sinatra |
|
|
Banco de dados
O agente Ruby não oferece suporte a versões experimentais. banco de dados suportado pelo agente Ruby incluem:
Banco de dados | Suportado | Descontinuada |
|---|---|---|
Registro Ativo |
|
|
DataMapper |
|
|
Elasticsearch |
| |
Mongo |
|
|
Redis |
| |
Sequel |
|
|
Outros softwares APM
Se a sua aplicação utiliza outro software de monitoramento do desempenho de aplicativos (APM) (APM) além do nosso agente, não podemos garantir que nosso agente funcionará corretamente e não podemos oferecer suporte técnico. Para obter mais informações, consulte Erros ao usar outro software de monitoramento.
Detalhes da instância
New Relic coleta detalhes de instância para uma variedade de bancos de dados e drivers do banco de dados. A capacidade de visualizar instâncias específicas e os tipos de informações do banco de dados no APM depende da versão do agente New Relic.
O agente Ruby da New Relic versão 3.17.0 ou superior suporta o seguinte banco de dados ORM:
ORM | Banco de dados | Nome do adaptador | Versão mínima do agente |
|---|---|---|---|
Registro Ativo 5 ou superior | 3.17.0 | ||
3.17.0 | |||
Registro Ativo 2.1 a 4 | 3.17.0 | ||
3.17.0 | |||
3.17.0 |
O agente Ruby também oferece suporte a estes gem bancos de dados:
Gem banco de dados | Nome da gema | Versão mínima da gema | Versão mínima do agente |
|---|---|---|---|
| 3.17.0 | ||
1.8.6 | 3.17.0 | ||
3.0.7 | 3.17.0 |
Para solicitar informações em nível de instância de datastores atualmente não listados para seu agente New Relic, obtenha suporte em support.newrelic.com.
Trabalhos em segundo plano
Os trabalhos em segundo plano suportados pelo agente New Relic Ruby incluem:
Trabalhos em segundo plano | Suportado | Descontinuada |
|---|---|---|
Delayed_Job |
|
|
Ancinho |
|
|
Resque |
|
|
Auxiliar |
|
|
HTTP e clientes de rede
Os clientes HTTP suportados pelo agente Ruby incluem:
- Async::HTTP: 0.59.0 ou superior
- Meio-fio: 0.8.1 ou superior
- Ethon: 0.12.0 ou superior
- Excon: 0.19.0 ou superior (versões inferiores a 0.55.0 suportadas pela última vez na versão 8.16.0 do agente)
- gRPC: 1.0.0 ou superior
- HttpClient: 2.2.0 ou superior (versões 2.2.0 - 2.8.0 suportadas pela última vez na versão 8.16.0 do agente)
- HttpRb: 0.9.9 ou superior (versões 0.9.9 - 2.2.1 suportadas pela última vez na versão 8.16.0 do agente)
- HTTPX: 1.0.0 ou superior
- Net::HTTP: compatível com todas as versões do Ruby com suporte de agente .
- Typhoeus: 0.5.3 ou superior (versões 0.5.3 - 1.2.x suportadas pela última vez na versão 8.16.0 do agente)
Enfileiramento de mensagens
A instrumentação da fila de mensagens está disponível apenas com o agente Ruby versão 4.3.0 ou superior. Corretores de mensagens atualmente suportados:
- RabbitMQ
Gems atualmente suportadas que facilitam os corretores de mensagens:
- Bunny: 2.0 ou superior (versões 2.0.x - 2.6.x suportadas pela última vez na versão 8.16.0 do agente)
Outro
O agente Ruby do APM também suporta:
- ActiveMerchant: 1.25.0 ou superior (versões 1.25.0 - 1.64.x suportadas pela última vez na versão 8.16.0 do agente)
- Acts_as_Solr: Suportado pela última vez na versão 8.16.0 do agente
- authlogic: Suportado pela última vez na versão 8.16.0 do agente
- concurrent-ruby: 1.1.5 ou mais alto
- Stripe: 5.38.0 ou superior
- Sunspot: Suportado pela última vez na versão 8.16.0 do agente
- Tilt: 2.x para Ruby 2.2 ou superior; 1.x para Ruby 2.7 ou inferior
- Yajl-Ruby: 1.1.0 ou mais alto
Conecte o agente a outras partes da New Relic
O agente Ruby se integra a outros recursos do New Relic para oferecer visibilidade de ponta a ponta.
Capacidade | Capacidade |
|---|---|
Você pode coletar dados de IA usando o agente Ruby e a gem | |
O agente Ruby injeta automaticamente o agente JavaScript do browser quando você habilita a instrumentação automática. Depois de ativar a injeção do browser, você poderá visualizar os dados na página Resumo do APM e alternar rapidamente entre o APM e os dados do browser para um aplicativo específico. Para opções de configuração e instrumentação manual, consulte a documentação do browser e do agente Ruby. | |
Ao instalar a infraestrutura e o agente APM no mesmo host, eles detectam um ao outro automaticamente. Você pode então visualizar uma lista de hosts na interface do APM e filtrar seus hosts por aplicativo APM na interface de infraestrutura. Para obter mais informações, consulte Dados do APM na interface de infraestrutura. | |
Sintético trace da transação conecta solicitações do monitor Sintético à transação APM subjacente. |