Ruby agent release notesRSS

Bugfix: Resolve ArgumentError on multi-key operations with Dalli 5.1.0

This fix updates Dalli instrumentation to accept and forward optional request options arguments in multi and pipelined operations. Our thanks go to @dbackeus for contributing a fix! PR#3642

Bugfix: Async::HTTP requests no longer raise NoMethodError when a segment fails to start

If the agent encountered an internal error while creating the segment for an Async::HTTP request, the instrumentation went on to use that missing segment and could raise a NoMethodError. This is now fixed, thanks to @ydah. PR#3640

Recurso: adicionar transaction_tracer.cap_segment_artifacts opção de configuração

Transações de longa duração com muitos segmentos podem causar o aumento contínuo do uso de memória durante a vida útil da transação. O agente agora oferece uma opção de configuração transaction_tracer.cap_segment_artifacts opcional (o padrão é false). Quando ativado, assim que transaction_tracer.limit_segments for atingido, o agente também para de registrar o tempo exclusivo para quaisquer segmentos criados posteriormente nessa transação, reduzindo o uso de memória à custa de dados de tempo menos precisos para a transação. PR#3615

Recurso: Adicionar instrumentação de estatísticas do servidor Puma

O agente agora faz a amostragem das estatísticas do servidor em todo o cluster do Puma e as relata como métricas de timeslice Ruby/Puma/*, incluindo backlog, running, pool_capacity, max_threads e requests_count. As estatísticas são amostradas no modo único e no modo em cluster quando preload_app! está habilitado. Esta instrumentação está desabilitada por padrão. Habilite-a definindo disable_puma_instrumentation como false. Quando habilitado, o agente inicia uma thread de relatório no processo mestre do Puma para entregar essas métricas, o que executa uma conexão adicional do agente junto com os workers do Puma. O intervalo de amostragem é configurável por meio da nova configuração puma.sample_rate (padrão de 60 segundos). Requer o Puma 6.6 ou posterior. Consulte nossos documentos para obter mais informações. PR#3578

Recurso: relatar um nome do host exclusivo para instâncias do Google Cloud Run

O agente agora detecta o Cloud Run e relata o ID da instância do GCP como o nome do host para que instâncias individuais possam ser distinguidas. Antes dessa alteração, todos os nomes do host do Google Cloud Run eram localhost. Esse recurso é controlado pela nova opção de configuração utilization.gcp_cloud_run.use_instance_as_host (padrão true). utilization.gcp_cloud_run.include_revision_in_host (padrão false) deve ser definido como true para, em vez disso, relatar o nome do host como {K_REVISION}-{instance id}, em que K_REVISION é o nome da revisão do Cloud Run. Issue n.º 3295 PR n.º 3609

Correção de bug: o SQL lento não é mais registrado após transaction_tracer.limit_segments excedido

Depois que uma transação excedia transaction_tracer.limit_segments, os segmentos de armazenamento de dados criados posteriormente ainda podiam ter seu SQL lento registrado. O agente agora para de registrar SQL lento para qualquer segmento criado após o limite ser atingido. PR#3615

Correção de bug: os planos de execução poderiam ter como destino o banco de dados errado em aplicativos Rails com vários bancos de dados (Rails >= 7.2)

No Rails 7.2+, o agente coletou planos de explicação usando uma conexão do pool padrão/compartilhado do aplicativo, em vez de uma dedicada. Isso afetou principalmente aplicativos com vários bancos de dados. Os planos de explicação poderiam ser gerados no banco de dados errado, e uma explicação com falha poderia deixar uma conexão compartilhada em um estado ruim, afetando requests não relacionados. O agente agora usa sua própria conexão dedicada para planos de explicação, como fazia antes do Rails 7.2, e redefine ou descarta essa conexão sempre que uma tentativa de explicação falha, para que uma conexão ruim nunca seja reutilizada. Issue#3610 PR#3612

Correção de bug: a instrumentação do monitoramento de Browser não falha mais com FrozenError

Quando o primeiro fragmento do corpo de uma resposta era um String congelado e havia vários fragmentos, a instrumentação do navegador atingia um FrozenError e o cabeçalho de tempo do navegador nunca era injetado. Isso começou a aparecer com o ERB 6.0.3+, que começou a congelar mais de suas strings compiladas. Esse problema já foi resolvido. Issue#3624 PR#3625

Correção de bug: normalizar valores de configuração booleanos para permitir qualquer formato de maiúsculas e minúsculas

Na versão 9.x, o agente aceitava valores booleanos em maiúsculas, como "FALSE", e valores com letras maiúsculas e minúsculas, como "True". A versão 10.0.0 incluiu o PR#3341, que removeu acidentalmente o requisito de não diferenciar maiúsculas de minúsculas. Isso fez com que os usuários que tivessem qualquer uso de maiúsculas e minúsculas além de todas minúsculas tivessem suas opções de configuração revertidas para os padrões. Agora, o agente usa verificações que não diferenciam maiúsculas de minúsculas novamente. 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