Requisitos do agente Ruby e estrutura suportada

Antes de instalar o agente New Relic do, certifique-se Ruby de que seu sistema atende a estes requisitos de sistema operacional compatível, protocolosRuby de segurança, versões e framework/biblioteca suportados.

Se você ainda não tem uma, comece criando uma conta New Relic. É grátis, para sempre.

Sistema operacional

O agente Ruby suporta sistemas operacionais semelhantes ao UNIX, como Linux, Solaris, FreeBSD e macOS. Windows não é oficialmente suportado para ambiente de produção, mas pode funcionar para desenvolvimento.

Requisitos de segurança

Coleta de dados: como medida de segurança padrão para coleta de dados, seu servidor de aplicativos deve oferecer suporte a SHA-2 (256 bits) para comunicação SSL com o New Relic. SHA-1 não é suportado.
TLS: O New Relic requer TLS 1.2 ou superior para todas as conexões de entrada do agente.

Versões Ruby

O agente Ruby do New Relic não suporta versões experimentais ou não oficiais do Ruby. O agente é continuamente testado em relação às versões oficiais do Ruby.

Implementação Ruby	Suportado	Notas
CRuby (RM)	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	Ruby 2.3.x, 2.2.x: Última versão totalmente suportada pelo agente v8.16.0. Ruby 2.1.x, 2.0.x: Última versão totalmente suportada pelo agente v6.15.0. Ruby 1.9.3: Último agente v3.18.1. Ruby 1.8.7: Último agente v3.18.1.
JRuby	9.x	JRuby 1.7.x: Último agente v3.18.1. Versões mais antigas não são suportadas.

Observação: "Último suporte total do agente vX.YZ" significa que a versão XYZ do agente foi a última a garantir suporte. Agentes mais novos ainda podem funcionar, mas não são testados ativamente em relação às versões mais antigas Ruby.

Servidores web

O agente Ruby suporta os seguintes servidores web. A instrumentação normalmente se conecta ao Rack.

Servidor Web	Suportado	Notas
Puma	6.x, 5.x, 4.x, 3.x	Versões '<' 3.x: O suporte pode variar.
Unicorn	6.x, 5.x	Versões '<' 4.x: O suporte pode variar.
Passageiro	6.x, 5.x	Versões '<' 5.x: O suporte pode variar.
Thin	1.x
Webrick	Incluído com versões Ruby suportadas	Geralmente com suporte para desenvolvimento e aplicativos Rack básicos.
Falcon	0.30.x e superior

Web frameworks

O agente Ruby fornece instrumentação robusta para esses frameworks web.

Framework	Suportado	Notas
Rails	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 também foi extensivamente testado. Rails 3.2.x: Última versão totalmente suportada pelo agente v8.16.0. Versões mais antigas (por exemplo, 2.x, 3.0.x, 3.1.x) não são suportados pelo agente recente.
Sinatra	3.x, 2.x	Sinatra 1.4.x: Última versão totalmente suportada pelo agente v8.16.0. Versões mais antigas não são suportadas.
Rack	5.x, 4.x, 3.x
Grape	1.7.x, 1.6.x, 1.5.x, 1.4.x, 1.3.x, 1.2.x	Grape 0.2.0: Última versão totalmente suportada pelo agente v8.16.0. Versões mais antigas podem não ser totalmente suportadas.
Padrinho	0,15.x	Versões mais antigas (por exemplo, 0.14.x) foram totalmente suportadas pelo agente v8.16.0.
Roda	3.x

Armazenamentos de dados e ORMs

O agente instrumentou uma ampla variedade de drivers do banco de dados e mapeadores objeto-relacionais.

armazenamento de dados / ORM	Nome da gema	Suportado	Notas
Registro ativo	`activerecord`	Veja as versões do Rails	Uso autônomo também é suportado. Adaptador Redshift reconhecido.
Sequel	`sequel`	5.17.0 e superior	Sequência 3.37.x, 4.0.x: Última versão totalmente suportada pelo agente v8.16.0.
MongoDB	`mongo`	2.4.0 e superior	Mongo 1.8.x - 2.3.x: Última versão totalmente suportada pelo agente v8.16.0.
Redis	`redis`	5.x, 4.x, 3.x	`redis-client` (usado pelo redis-rb 5+) também é instrumentado.
Memcached (Dalli)	`dalli`	3.x, 2.7.x
Memcached (gema memcached)	`memcached`	1.8.x
Elasticsearch	`elasticsearch`	8.x, 7.x	`elasticsearch.capture_cluster_name` opção de configuração disponível.
OpenSearch	`opensearch-ruby`	3.x, 2.1.x	Suporte experimental, fornece telemetria semelhante ao Elasticsearch.
DynamoDB (SDK da AWS)	`aws-sdk-dynamodb`	3.x

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.

Oferecemos suporte aos seguintes adaptadores:

Banco de dados	Nome da Gema do Adaptador
PostgreSQL	`pg`
MySQL	`mysql2`, `trilogy`
SQLite	`sqlite3`

Esta não é uma lista abrangente.

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.

Trabalho em segundo plano e sistemas de mensagens

instrumentação para processamento popular de trabalhos em segundo plano e fila de mensagens biblioteca.

Sistema / biblioteca	Nome da gema	Suportado	Notas
Auxiliar	`sidekiq`	8.x, 7.x, 6.x, 5.x	Sidekiq 4.2.x: Última versão totalmente suportada pelo agente v8.16.0. `sidekiq-delay_extensions` também suportado.
Resque	`resque`	2.x, 1.27.x	Suporte para `FORK_PER_JOB`.
Trabalho atrasado	`delayed_job`	4.1.x	Active Record e backend Mongoid. Trabalho atrasado 2.0.x - 4.0.x: Última versão totalmente suportada pelo agente v8.16.0.
Trabalho Ativo	`activejob`	Veja as versões do Rails
Bunny (RabbitMQ)	`bunny`	2.x	Bunny 2.0.x - 2.6.x: Última versão totalmente suportada pelo agente v8.16.0.
Kafka (rubi-kafka)	`ruby-kafka`	1.x
Kafka (rdkafka)	`rdkafka`	0,15.x+
Kinesis (SDK da AWS)	`aws-sdk-kinesis`	3.x
Firehose (SDK da AWS)	`aws-sdk-firehose`	3.x
SQS (SDK da AWS)	`aws-sdk-sqs`	3.x
Fila Sólida	`solid_queue`	Veja ActiveJob	Usado com ActiveJob. `ThreadError: queue empty` ignorado por padrão.

Clientes HTTP e rede

O agente instrumentado diversas bibliotecas de clientes HTTP para monitoramento de serviços externos.

Biblioteca	Nome da gema	Suportado	Notas
Net::HTTP	(Biblioteca Ruby Standard)	Incluído com versões Ruby suportadas	Cliente HTTP principal.
Cliente HTTP	`httpclient`	2.8.3 e superior	HttpClient 2.2.0 - 2.8.0 (abaixo do atual 2.8.x): Última versão totalmente suportada pelo agente v8.16.0.
Tifeu	`typhoeus`	1.4.x e superior	Typhoeus 0.5.3 - 1.2.x: Última versão totalmente suportada pelo agente v8.16.0. Suporte Hydra.
Excon	`excon`	0,56,0 e acima	Excon '<' 0.55.0: Última versão totalmente suportada pelo agente v8.16.0.
Éton	`ethon`	0.12.0 e acima
Meio-fio	`curb`	0.9.x e superior
HTTPX	`httpx`	1.0.0 e superior
HTTP.rb (gema http)	`http`	5.x, 4.x, 3.x, 2.x	HttpRb 0.9.9 - 2.2.1: Última versão totalmente suportada pelo agente v8.16.0.
Faraday	`faraday`		a instrumentação funciona através de adaptadores instrumentados (ex: Net::HTTP, Excon).
Async::HTTP	`async-http`	0,59,0 e acima
gRPC	`grpc`	1.48.0 e acima	Para instrumentação de servidor e cliente gRPC.

Biblioteca de IA e Aprendizado de Máquina

New Relic está expandindo seu suporte para bibliotecas de IA/ML.

Biblioteca	Nome da gema	Suportado	Notas
OpenAI	`ruby-openai`	3.4.0 e acima	Requer `ai_monitoring.enabled = true`. Captura chamadas para incorporação e endpoint de conclusão de bate-papo. atributo personalizado pode ser adicionado com o prefixo `llm.`.

Outras bibliotecas e tecnologias

Biblioteca	Nome da gema	Suportado	Notas
Cabo de ação	`actioncable`	Veja as versões do Rails
Comerciante Ativo	`activemerchant`	1.65.0 e acima	ActiveMerchant 1.25.0 - 1.64.x: Última versão totalmente suportada pelo agente v8.16.0.
Capistrano	`capistrano`	2.15.5 e acima
Ruby concorrente	`concurrent-ruby`	1.1.5 e acima
Fibra			instrumentação da classe Fiber do Ruby.
GráficoQL	`graphql`		instrumentação fornecida por GraphQL gem
Lambda (SDK da AWS)	`aws-sdk-lambda`		Veja monitoramentoAWS Lambda para mais informações.
Logger	`logger`		Suporte para encaminhamento de logs APM usando a biblioteca de Logger do Ruby.
Logstasher	`logstasher`	1.xx e superior	Suporte para encaminhamento de logs APM.
Stripe	`stripe`	5.38.0 e acima
Fio			instrumentação da classe Thread do Ruby.
Exibir componente		2.53.x e superior
Yajl-Ruby	`yajl-ruby`	1.2.1 e superior

Notas sobre versões suportadas

O agente pode ser compatível com uma gama mais ampla de versões (mais antigas ou mais recentes) do que as explicitamente listadas. No entanto, as versões listadas recebem os testes mais rigorosos.
Para obter as informações mais atualizadas sobre novas versões com suporte ou descontinuações, consulte sempre as notas de versão do agente Ruby.
Se uma biblioteca não estiver listada, ela ainda poderá ser instrumentada se depender de uma tecnologia subjacente que seja instrumentada (por exemplo, uma framework construída no Rack ou um ORM usando um adaptador de banco de dados padrão). Para bibliotecas críticas não listadas, você pode explorar instrumentação personalizada ou enviar uma solicitação de recurso.

Se você tiver dúvidas sobre versões específicas ou bibliotecas não abordadas aqui, visite nosso fórum da comunidade Explorers Hub.

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.

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	Descrição
AI Monitoring	Você pode coletar dados de IA usando o agente Ruby e a gem`ruby-openai` . Este recurso foi introduzido no agente Ruby versão 9.8.0 e suporta `ruby-openai` versões 3.4.0 e acima.
Monitoramento de browser	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.
Monitoramento de infraestrutura	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.
Monitoramento sintético	Sintético trace da transação conecta solicitações do monitor Sintético à transação APM subjacente.

Esta tradução de máquina é fornecida para sua comodidade.