Ruby agent release notesRSS

Feature: Add transaction_tracer.cap_segment_artifacts configuration option

Long-running transactions with many segments can cause continuously increasing memory usage for the lifetime of the transaction. The agent now offers an opt-in transaction_tracer.cap_segment_artifacts configuration option (defaults to false). When enabled, once transaction_tracer.limit_segments is reached, the agent also stops recording exclusive time for any segments created afterward in that transaction, reducing memory usage at the cost of less accurate timing data for the transaction. PR#3615

Feature: Add Puma server-statistics instrumentation

The agent now samples Puma's cluster-wide server statistics and reports them as Ruby/Puma/* timeslice metrics, including backlog, running, pool_capacity, max_threads, and requests_count. Statistics are sampled in single mode and in clustered mode when preload_app! is enabled. This instrumentation is disabled by default. Enable it by setting disable_puma_instrumentation to false. When enabled, the agent starts a reporting thread in the Puma master process to deliver these metrics, which runs an additional agent connection alongside the Puma workers. The sampling interval is configurable via the new puma.sample_rate setting (default 60 seconds). Requires Puma 6.6 or later. See our docs for more information. PR#3578

Feature: Report a unique hostname for Google Cloud Run instances

The agent now detects Cloud Run and reports the GCP instance id as the hostname so individual instances can be distinguished. Before this change, all Google Cloud Run hostnames were localhost. This feature is controlled by the new utilization.gcp_cloud_run.use_instance_as_host configuration option (default true). Set utilization.gcp_cloud_run.include_revision_in_host (default false) to true to report the hostname as {K_REVISION}-{instance id} instead, where K_REVISION is the Cloud Run revision name. Issue#3295 PR#3609

Bugfix: Slow SQL no longer recorded after transaction_tracer.limit_segments exceeded

Once a transaction exceeded transaction_tracer.limit_segments, datastore segments created afterward still could have their slow SQL recorded. The agent now stops recording slow SQL for any segment created after the limit is reached. PR#3615

Bugfix: Explain plans could target the wrong database in multi-database Rails apps (Rails >= 7.2)

On Rails 7.2+, the agent gathered explain plans using a connection from the app's default/shared pool rather than a dedicated one. This primarily affected multi-database apps. Explain plans could be generated against the wrong database, and a failed explain could leave a shared connection in a bad state, affecting unrelated requests. The agent now uses its own dedicated connection for explain plans, as it did before Rails 7.2, and resets or discards that connection whenever an explain attempt fails, so a bad connection is never reused. Issue#3610 PR#3612

Bugfix: Browser monitoring instrumentation no longer fails with FrozenError

When a response body's first fragment was a frozen String and there were multiple fragments, browser instrumentation hit a FrozenError and the browser timing header was never injected. This began appearing with ERB 6.0.3+, which started freezing more of its compiled strings. This issue is now fixed. Issue#3624 PR#3625

Bugfix: Normalize boolean configuration values to allow all casing

In version 9.x, the agent accepted capitalized boolean values, like "FALSE", and mixed-case values like "True". Version 10.0.0 included PR#3341, which unintentionally removed the case-insensitive requirement. This caused users who had any casing besides all lowercase to have their configuration options fall back to the defaults. Now, the agent uses case-insensitive checks again. Issue#3632 PR#3633

Recurso: eventos SpanLink agora são suportados para o agente Hybrid

Spans criados por uma API do OpenTelemetry agora podem ter Span Links associados a eles. Links podem ser adicionados no início de um span, passando-os para o argumento links, ou chamando a API OpenTelemetry::Trace::Span#add_link. PR#3586

Recurso: eventos SpanEvent agora são suportados para o agente Hybrid

Os spans criados por uma API do OpenTelemetry agora podem ter eventos SpanEvent associados a eles por meio da API OpenTelemetry::Trace::Span#add_event. Os eventos SpanEvent capturam anotações com timestamp em um span e são enviados para o New Relic junto com o span pai. PR#3587

Recurso: definir o tipo de span em todos os spans do agente Hybrid

Anteriormente, apenas os spans do OpenTelemetry traduzidos em segmentos de solicitação externa ou segmentos de armazenamento de dados adicionavam o tipo de span como um atributo. Agora, o agente adiciona o tipo de span a todos os spans do OpenTelemetry onde o valor está disponível. PR#3589

Recurso: adicionar suporte para OpenTelemetry::Tracer#start_root_span

A API OpenTelemetry::Tracer#start_root_span agora pode ser usada para forçar o início de uma transação para um determinado span, desde que ele tenha um tipo de span :server ou :consumer. Para quaisquer outros tipos de span, ela não executará nenhuma ação. Esse método é mais comumente usado na instrumentação de jobs em segundo plano. PR#3588

Correção de bug: corrigir instrumentation.rails_event_logger: false não desativando a instrumentação

Anteriormente, definir instrumentation.rails_event_logger como false não desativava a instrumentação de Rails.event como esperado; ela ainda era instalada durante a inicialização do Rails. O problema já foi resolvido. PR#3564

Correção de bug: normalizar valores semelhantes a booleanos para disabled em chaves de configuração de instrumentação

Anteriormente, apenas disabled desativaria uma chave de configuração instrumentation.*. Agora, valores do tipo booleano, como false, no ou off, também são resolvidos como disabled e impedem que a instrumentação seja instalada. PR#3579

Correção de bug: métricas de suportabilidade de logging por biblioteca agora refletem o estado de instrumentação de cada biblioteca

Anteriormente, as métricas Supportability/Logging/Ruby/{library}/{enabled|disabled} relatavam o valor da configuração global application_logging.enabled para cada biblioteca, em vez do estado real de cada biblioteca. Como resultado, a métrica relatava enabled mesmo quando você havia desativado a instrumentação de log para uma biblioteca específica ou não estava usando a gem dessa biblioteca. Agora, a métrica de cada biblioteca reflete se sua própria instrumentação de log está ativada. PR#3571

Recurso: adicionar suporte ao Dalli 5.0 e corrigir a instrumentação do metaprotocolo

O agente agora oferece suporte ao Dalli 5.0+, que removeu Dalli::Protocol::Binary exclusivamente em favor do metaprotocolo. Para Dalli 3.2.0+, A instrumentação pipelined_get agora tem Dalli::Protocol::Base como destino corretamente (onde o método é definido) em vez de Dalli::Protocol::Binary, corrigindo uma lacuna em que as chamadas get_multi não eram instrumentadas ao usar o metaprotocolo. Para o Dalli 5.0+, o agente adicionalmente instrumenta Dalli::Protocol::Meta#read_multi_req, que é invocado pela otimização get_multi de servidor único do Dalli. PR#3541

Recurso: adicionar opção de configuração active_record_use_table_name

Uma nova opção de configuração, active_record_use_table_name, usa o nome da tabela de um modelo Active Record em vez do nome de sua classe ao nomear métricas, spans e segmentos de trace da transação. Isso pode ser particularmente útil para reduzir a cardinalidade em aplicativos usando herança de tabela única. A opção tem como padrão false para preservar o comportamento existente. PR#3540

Recurso: ocultar parcialmente chaves de licença nos logs do agente

Anteriormente, o agente ocultava completamente as chaves de licença da New Relic nos logs do agente. Agora, os primeiros 10 caracteres são visíveis enquanto o restante é substituído por *. Isso preserva o suficiente para solucionar problemas relacionados à região sem expor a parte secreta da chave. PR#3547

Correção de bug: corrigir a incompatibilidade da instrumentação do Semantic Logger com rails_semantic_logger

Anteriormente, um ArgumentError era gerado quando uma exceção atingia ActionDispatch::DebugExceptions ao usar rails_semantic_logger. Isso foi corrigido. Obrigado a @jdelStrother por relatar isso! PR#3548

Recurso: adicionar instrumentação do Rails.event para logging estruturado

O agente agora suporta Rails.event como eventos de log estruturados. Quando habilitado, os eventos publicados via Rails.event.notify são capturados e encaminhados para o New Relic como eventos de log. Cargas de evento, tags, contexto, timestamps e locais de origem são capturados automaticamente como atributos de log.

Esta instrumentação pode ser configurada com as seguintes opções:

• instrumentation.rails_event_logger - Controla se a instrumentação de Rails.event está habilitada. Por padrão, usa o valor de application_logging.enabled.
• instrumentation.rails_event_logger.event_names - Uma matriz de nomes de eventos específicos para capturar. Quando vazio (padrão), todas as notificações do Rails.event são capturadas. Use isso para filtrar eventos por nome, por exemplo: ['user.signup', 'payment.processed'].

PR#3526

Recurso: adicionar instrumentação para Rails Active Job Continuations

O agente agora instrumenta as continuações do Active Job do Rails, fornecendo visibilidade da execução de etapas individuais em tarefas de longa duração. Os nomes dos passos são incluídos nas métricas de segmento (por exemplo, Ruby/ActiveJob/default/MyJob/step/process_records) e atributos específicos do passo, como posição do cursor, status retomado e status interrompido, são capturados. Uma nova opção de configuração, disable_active_job_step_names, permite que os usuários excluam nomes de etapas dos nomes de métricas para reduzir a cardinalidade da métrica, se necessário (o padrão é false). PR#3493

Recurso: Adicionar sidekiq.separate_transactions opção de configuração

Uma nova opção de configuração, sidekiq.separate_transactions, permite que as tarefas do Sidekiq executadas durante uma transação da web sejam executadas em sua própria transação separada. Quando habilitado, isso evita que o tempo de execução do job do Sidekiq seja incluído nas métricas de transação da web, fornecendo dados de desempenho mais precisos. O recurso é opt-in (padrão: falso) para manter a compatibilidade com versões anteriores. Isso afeta apenas os trabalhos executados durante transações da web ativas; os trabalhos iniciados de forma independente ou aninhados em outros trabalhos em segundo plano não são afetados. Issue#3364 PR#3514

Correção de bug: atualizar regexes que podem ter sido vulneráveis a ataques ReDOS

Anteriormente, o agente tinha algumas regexes identificadas como possíveis destinos para ataques de complexidade de tempo polinomial (ReDOS). Essas regexes agora estão atualizadas para abordar as preocupações. PR#3520

Correção de bug: evitar falhas durante a criação de segmento HTTPX

Anteriormente, se start_external_request_segment encontrasse um erro e retornasse nil, o agente acionaria um NoMethodError ao tentar adicionar cabeçalhos ao segmento ausente. Adicionamos uma verificação de segurança para garantir que a instrumentação lide com esses casos de forma adequada.

Parabéns a @thebravoman pelo relatório! Issue#3509 PR#3510

Correção de bug: tornar Transaction#finish idempotente

Anteriormente, se o método Transaction#finish fosse chamado várias vezes, mais de uma transação poderia ser criada para a mesma operação. Agora, um mutex protege as chamadas para Transaction#finish para garantir que as operações de finalização sejam executadas apenas uma vez. PR#3513

Correção de bug: Aviso único de descontinuação do Log para a API Datastores.wrap

Anteriormente, esse aviso estava sendo registrado a cada chamada para Datastores.wrap. Agora, isso será registrado apenas na primeira chamada. Além disso, a documentação foi atualizada para indicar o status descontinuado do segundo e terceiro argumentos de retorno de chamada. Issue#3516 PR#3519

Recurso: adicionar nomenclatura de consulta ao banco de dados via comentários SQL

As consultas ao banco de dados agora podem ser nomeadas explicitamente usando comentários SQL. Consultas podem incluir comentários /* NewRelicQueryName: CustomName */ para atribuir nomes estáveis para melhor rastreamento e identificação. Isso é especialmente útil para rastrear consultas específicas ao banco de dados durante regressões de desempenho ou incidentes. PR#3480

Recurso: Adicionar instrumentação do Semantic Logger

O agente agora suporta encaminhamento de logs e decoração do Semantic Logger para o gem semantic_logger versões 4.6.0+. Se você usava anteriormente o anexador do New Relic integrado do agente Semantic, é recomendável escolher uma abordagem para evitar o envio de logs duplicados. A instrumentação do agente Semantic da New Relic pode ser desabilitada definindo instrumentation.semantic_logger como disabled. PR#3467

Agradecemos a @jdelStrother por fornecer feedback valioso que ajudou a moldar esta instrumentação.

Recurso: adicionar nova configuração 'ignored_middleware_classes'

Uma nova opção de configuração, ignored_middleware_classes, permite que os usuários excluam middlewares específicos da instrumentação (ex. Rack::Cors). O padrão é uma matriz vazia. Issue#1814 PR#3481

Recurso: Adicionar nova API NewRelic::Agent.add_transaction_log_attributes

Uma nova API, NewRelic::Agent.add_transaction_log_attributes, permite aos usuários adicionar atributo personalizado com escopo de transação ao evento de log para a transação atual. Esses atributos serão aplicados apenas aos logs criados dentro do escopo da transação atual. PR#3472

Correção de bug: fornecer opção de configuração para reduzir a cardinalidade de métricas de broadcast do ActionCable

Por padrão, as métricas para chamadas do método broadcast do ActionCable incluem o valor do broadcasting. Esse valor pode ter cardinalidade muito alta. Agora, a opção de configuração :simplify_action_cable_broadcast_metrics permite que os usuários removam o valor de transmissão do nome da métrica. Isso cria uma métrica que se parece com: Ruby/ActionCable/broadcast. Quando esta opção de configuração estiver habilitada, o valor de broadcasting será adicionado como um atributo de span. PR#3463

Correção de bug: remover require 'digest/md5' inativo para conformidade com FIPS/FedRAMP

Na versão 7.1.0 do agente, o uso do MD5 foi substituído pelo SHA1 para conformidade com FIPS (PR). No entanto, o antigo require para 'digest/md5' não foi removido. Removemos o requisito para ajudar nossos usuários FIPS/FedRAMP. Obrigado a @ashleyboehs por trazer isso à nossa atenção! Issue#3469 PR#3470

Correção de bug: impedir a inicialização do agente durante rails test para evitar atraso no desligamento

Anteriormente, o agente causava um atraso de -3 segundos no encerramento ao executar o comando rails test. A constante Rails::Command::TestCommand foi adicionada à lista autostart.denylisted_constants padrão para impedir que o agente inicie durante as execuções de teste do Rails. Obrigado a @varyform por trazer isso à nossa atenção. PR#3478

Correção de bug: corrige avisos de "Não foi possível calcular o tempo de transação decorrido" ao usar o servidor web Falcon

O agente agora usa Fiber.current.object_id em vez de Thread.current.object_id para rastrear o estado da transação ao executar no Falcon, evitando colisões de requests concorrentes que compartilham a mesma thread. Também corrige um "NameError: uninitialized constant Async::HTTP::VERSION" ao usar o Falcon. Obrigado a @97jaz e @gsar por trazerem isso à nossa atenção. PR#3483

Correção de bug: corrigir erro de digitação em harvest.rb causando NoMethodError

Um erro de digitação em lib/new_relic/agent/agent_helpers/harvest.rb causou um NoMethodError: undefined method 'agent' for NewRelic:Module. Obrigado a @oakbow por relatar este problema. PR#3484

Correção de bug: remove o uso do ObjectSpace._id2ref obsoleto

O agente agora usa uma abordagem alternativa em vez do método ObjectSpace._id2ref descontinuado, eliminando avisos de descontinuação ao executar no Ruby 4.0+. PR#3490

Correção de bug: corrigir NoMethoError na instrumentação de Logging

Anteriormente, quando a instrumentação da gem Logging tentava decorar logs locais, ela lançava um NoMethodError se encontrasse um objeto não string. O problema já foi resolvido. PR#3501