Ruby agent release notesRSS

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

Recurso: Introduzir Agente Híbrido para suporte ao Rastreamento OpenTelemetry

As APIs de rastreamento do OpenTelemetry agora podem ser traduzidas em telemetria da New Relic com os novos recursos de Agente Híbrido do agente Ruby da New Relic. Isso permite que a gem newrelic_rpm se comporte de forma semelhante a um SDK OpenTelemetry, aceitando chamadas da API OpenTelemetry e transformando-as em Transações e Segmentos do New Relic com atributos e nomes familiares.

As seguintes opções de configuração referem-se aos recursos do Hybrid Agent:

Recurso: Adicionar opção de configuração error_collector.backtrace_truncate_location

Uma nova opção de configuração foi adicionada, error_collector.backtrace_truncate_location, que permite ao usuário especificar onde truncar o backtrace quando o número de frames exceder error_collector.max_backtrace_frames. As opções são 'top' (remove frames do início), 'middle' (remove frames do meio, preservando o início e o fim) ou 'end' (remove frames do fim). O padrão é 'middle'. PR#3424

Recurso: Adicionar instrumentação da gem Logging

O agente agora registrará logs gerados pela gem Logging. PR#3420

Funcionalidade: Adicionar opção de configuração utilization.detect_in_parallel

Uma nova opção de configuração foi adicionada, utilization.detect_in_parallel, que controla se o agente usa threads ao detectar informações do provedor de nuvem para acelerar a inicialização do agente. Quando definido como false, a detecção de fornecedor é executada sequencialmente sem criar threads. O padrão é true. PR#3439

Feature: Add support for forking processes in Parallel gem instrumentation

Parallel gem instrumentation has been added to allow more consistent monitoring in processes forked using the Parallel gem. PR#3405

Feature: Add support for Grape v3.1.0

Grape's release of v3.1.0 introduced changes that were incompatible with the agent's instrumentation, causing issues when collecting transaction names. The agent has been updated to properly extract class names for transaction naming in the updated Grape API structure. PR#3413

Bugfix: Create health check files in forked processes

The agent now properly initializes health check loops after forking, ensuring each process generates its own health check file. This fix also has the effect of correctly including entity.guid values in the health check files. PR#3409 Issue#3408

Bugfix: Fix sidekiq.ignore_retry_errors

The configuration option sidekiq.ignore_retry_errors: true was continuing to report retry errors. The agent now correctly ignores retry errors and only reports when jobs permanently fail. PR#3399

Alteração significativa: Remover o suporte para Ruby 2.4 e 2.5

O suporte para as versões Ruby 2.4 e 2.5 foi removido. A nova versão mínima do Ruby necessária agora é 2.6. PR#3314

Mudança importante: Remoção do Cross Application Tracing (CAT)

Anteriormente, o Cross Application Tracing (CAT) foi descontinuado em favor do Distributed Tracing. A funcionalidade CAT foi removida. A opção de configuração cross_application_tracer.enabled foi removida. Os métodos da API pública NewRelic::Agent::External.process_request_metadata, NewRelic::Agent::External.get_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#process_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#get_request_metadata e NewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headers também foram removidos. PR#3333

Mudança radical: Renomear métricas e segmentos do ActiveJob

As métricas do ActiveJob foram atualizadas para incluir o nome da classe do trabalho para relatórios mais específicos. Esta é uma alteração significativa e pode exigir a atualização de painéis ou alertas personalizados. PR#3370 PR#3320

• Formato antigo: Ruby/ActiveJob/<QueueName>/<Method>
• Novo formato: Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

Além disso, os segmentos criados para ações de enfileiramento do Active Job agora incluem a classe de trabalho.

• Formato antigo: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• Novo formato: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

Mudança radical: Renomear o comando bin/newrelic para bin/newrelic_rpm

O arquivo executável para a CLI do agente foi renomeado de bin/newrelic para bin/newrelic_rpm. Essa alteração resolve uma colisão de nomes com a ferramenta CLI autônoma do New Relic. PR#3323

Mudança radical: Remova o comando CLI newrelic deployments

O comando CLI newrelic deployments obsoleto foi removido. Para rastrear alterações e implantações no New Relic, consulte nosso guia sobre Rastreamento de alterações para obter uma lista de opções disponíveis. PR#3299

Mudança radical: Remover o método NewRelic::Agent::SqlSampler#notice_sql

Os usuários devem chamar NewRelic::Agent::Datastores.notice_sql em vez disso. PR#3338

Mudança radical: Remova argumentos não utilizados de várias APIs NewRelic::Agent::Datastores

As seguintes APIs da classe NewRelic::Agent::Datastores tiveram argumentos de método removidos:

• NewRelic::Agent::Datastores.notice_sql, anteriormente tinha três argumentos posicionais, query, scoped_metric e elapsed. Agora, ele só tem query.
• NewRelic::Agent::Datastores.notice_statement, anteriormente tinha dois argumentos posicionais query e elapsed. Agora ele só tem query.
• NewRelic::Agent::Datastores.wrap exige um proc. Anteriormente, o proc recebia três argumentos: o resultado do yield, o nome da métrica com escopo mais específico e o tempo decorrido da chamada. Agora, ele recebe apenas um: o resultado do yield.

Os valores dos argumentos removidos são derivados do segmento atual no momento da chamada. PR#3347

Mudança radical: Remover o recurso experimental Configurable Security Policies (CSP)

O recurso experimental, Configurable Security Policies (CSP), não é mais suportado e foi removido. PR#3292

Mudança radical: Remover o suporte para as versões do Puma '<' 3.9.0

A versão mínima do Puma agora suportada é 3.9.0 ou superior. PR#3326

Mudança radical: Melhorar a validação e coerção da configuração

Os mecanismos internos usados para forçar e validar os valores fornecidos para a configuração do agente agora são mais eficientes e precisos.

• Mensagens de aviso agora serão registradas no arquivo newrelic_agent.log quando nil for fornecido como um valor de configuração para uma configuração que não o suporta.
• Valores inteiros são permitidos para tipos de configuração Float
• Valores float são permitidos para tipos de configuração Integer
• Interrupções fatais são evitadas quando um valor padrão pode ser encontrado para substituir um valor de entrada inválido PR#3341

Mudança radical: Substitua a opção 'default' por 'adaptive' para amostradores de pais remotos de rastreamento distribuído

Anteriormente, a opção padrão para distributed_tracing.sampler.remote_parent_sampled e distributed_tracing.sampler.remote_parent_not_sampled era default, que usava o amostrador adaptável pré-existente. A opção default foi renomeada para adaptive. PR#3363

Recurso: Adicionar logger como uma dependência

O gem logger agora está listado como uma dependência do agente para garantir a funcionalidade contínua de logging e suporte para as versões Ruby 4.0.0 e mais recentes. PR#3293

Recurso: Adicione a opção de configuração de lista de permissões de notificação do Active Support

Uma nova opção de configuração, instrumentation.active_support_notifications.active_support_events, permite que os usuários definam uma lista de permissões de nomes de eventos de notificação do Active Support para o agente assinar. Por padrão, o agente se inscreve em todos os eventos Active Support: Caching e Active Support: Messages. PR#3327

Recurso: Use a compressão Gzip integrada do Ruby

O agente agora usa o método Zlib.gzip integrado da biblioteca padrão Ruby para compactação, substituindo a implementação personalizada anterior. PR#3332

Recurso: Adicionar validação de argumento para a API NewRelic::Agent#record_custom_event

A API NewRelic::Agent#record_custom_event agora levanta um ArgumentError quando um event_type inválido é fornecido. Um tipo de evento válido deve consistir apenas em caracteres alfanuméricos, sublinhados (_), dois pontos (:) ou espaços ( ). PR#3319

Recurso: Adicionar opções de configuração de amostragem raiz

Agora você pode configurar o comportamento de amostragem para rastreios que se originam dentro do serviço atual usando distributed_tracing.sampler.root. PR#3330

Há quatro modos disponíveis:

Recurso: Adicione opções de amostragem baseadas na taxa de ID de rastreamento

O agente agora pode amostrar rastreios usando o algoritmo de amostragem baseado na taxa de ID de rastreio OpenTelemetry. PR#3330 Isso amostra rastreios com base em uma probabilidade entre 0,0 e 1,0 com base no ID do rastreio.

Para usar esta opção, você deve primeiro definir sua configuração de amostrador de rastreamento distribuído para trace_id_ratio_based e, em seguida, definir o amostrador distributed_tracing.sampler.*.trace_id_ratio_based.ratio correspondente para um Float entre 0,0 e 1,0.

Por exemplo:

distributed_tracing.sampler.remote_parent_sampled: 'trace_id_ratio_based'
  distributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratio': 0.5

Essa configuração amostrará aproximadamente 50% de seus rastreamentos para todos os rastreamentos em que o pai remoto for amostrado.

Esta opção está disponível para:

• distributed_tracing.sampler.root
• distributed_tracing.sampler.remote_parent_sampled
• distributed_tracing.sampler.remote_parent_not_sampled

Recurso: Adicionar GUID da entidade aos arquivos de verificação de integridade do Agent Control

Quando o agente é iniciado em um ambiente de Controle do Agente, um arquivo de verificação de integridade é criado no local configurado do arquivo para cada processo do agente. Este arquivo agora inclui o guid da entidade relacionada ao agente quando disponível. PR#3371

Correção de bug: Resolver um NoMethodError na detecção de utilização do GCP.

A lógica de descoberta de metadados do GCP agora lidará normalmente com nil ou valores inesperados, evitando falhas na inicialização do serviço. PR#3388