Следы транзакций NewRelic в Ruby Gem

Ответ 1

Я работаю в New Relic и хочу добавить некоторые последние сведения о последней версии newrelic_rpm gem. TrinitronX находится на правильном пути, но, к сожалению, этот пример кода и запись в блоге основаны на очень старой версии драгоценного камня, и внутренности значительно изменились с тех пор. Хорошей новостью является то, что более новые версии агента должны сделать это проще.

Чтобы начать, я должен сказать, что я предполагаю, что ваш процесс длится долгое время как демон и повторяет вызовы prepare_parse.

Вообще говоря, явные вызовы manual_start и shutdown, которые вы вставили в свой метод prepare_parse, не должны быть необходимы, за исключением нескольких особых случаев (некоторые рейк-задачи и интерактивные сеансы). Агент New Relic автоматически запустится, как только это будет необходимо. Вы можете увидеть подробности о том, когда агент Ruby автоматически запустится и как будет управлять этим поведением здесь:

• https://docs.newrelic.com/docs/ruby/forcing-the-ruby-agent-to-start

Для мониторинга фоновых задач, подобных этому, есть концептуально два уровня инструментария, которые вы можете захотеть: трассировщики транзакций и трассировщики методов. У вас уже есть трассировщик транзакций, но вы также можете добавить меток методов вокруг основных фрагментов работы, которые происходят в вашем методе prepare_parse. Это даст вам лучшую видимость того, что происходит в каждом вызове prepare_parse. Здесь вы можете найти информацию о добавлении меток методов:

• https://docs.newrelic.com/docs/ruby/ruby-custom-metric-collection#method_tracers

С тем, что вы вызываете add_transaction_tracer, ваши вызовы на prepare_parse должны отображаться как транзакции на вкладке "Фоновые задачи" в новом реляционном интерфейсе.

Одно из предостережений здесь может заключаться в том, что вы используете это как демон. Агент Ruby использует фоновый поток для асинхронной связи с серверами New Relic. Поскольку потоки не копируются между вызовами на fork(), это означает, что вам иногда придется вручную перезапустить агент после fork() (обратите внимание, что Ruby Process.daemon использует fork внизу, поэтому он также включается). Независимо от того, требуется ли это, зависит от относительного времени запроса newrelic_rpm и вызова fork/daemon (если newrelic_rpm не требуется, пока после вызова fork/daemon, вы должны быть хорошими, иначе см. ниже).

Есть два решения проблемы с fork:

• Вручную вызовите NewRelic::Agent.after_fork из раздвоенного ребенка сразу после fork.

• Если вы используете newrelic_rpm 3.7.1 или новее, есть экспериментальная опция автоматического повторного запуска фонового потока, который вы можете включить в вашем файле newrelic.yml, установив restart_thread_in_children: true. В настоящее время это отключено по умолчанию, но может стать поведением по умолчанию в будущих версиях агента.

Если у вас все еще есть проблемы, файл newrelic_agent.log лучше всего подходит для отладки. Вы хотите увеличить количество слов, установив log_level: debug в ваш файл newrelic.yml, чтобы получить более подробный вывод.

Ответ 2

Для отладки этой проблемы попробуйте следующий код:

require 'fms/parser/version'
require 'fms/parser/core'
require 'fms/parser/env'

require 'mongoid'

ENV['NRCONFIG'] ||= File.dirname(__FILE__) + '/../newrelic.yml'
# Make sure NewRelic has correct log file path
ENV['NEW_RELIC_LOG'] ||= File.dirname(__FILE__) + '/../log/newrelic_agent.log'

require 'newrelic_rpm'
::NewRelic::Agent.manual_start

# For debug purposes: output some dots until we're connected to NewRelic
until NewRelic::Agent.connected? do
  print '.'
  sleep 1
end

module Fms
  module Parser
    class << self
      include ::NewRelic::Agent::Instrumentation::ControllerInstrumentation
      add_transaction_tracer :prepare_parse, :category => :task
    end
    def self.prepare_parse(filename)
        Mongoid.load!("#{File.dirname(__FILE__)}/../mongoid.yml", :development)
        Core.prepare_parse(filename)

      # Force the agent to prepare data before we shutdown
      ::NewRelic::Agent.load_data
      # NOTE: Ideally you'd want to shut down the agent just before the process exits... not every time you call Fms::Parser#prepare_parse
      ::NewRelic::Agent.shutdown(:force_send => true)
    end
  end
end

У меня такое чувство, что это, вероятно, связано с запуском вашего кода драгоценного камня в демонизированном процессе, который запускает bluepill. В идеале мы хотели бы запустить агент NewRelic в процессе, как только процесс демона будет раздвоен, как мы можем получить. Положив его после того, как ваша библиотека потребует, нужно сделать это, когда требуется файл.

Мы также, скорее всего, хотим остановить агент NewRelic непосредственно перед тем, как процесс фоновой задачи выйдет, а не каждый раз, когда вызывается метод Fms::Parser#prepare_parse. Однако для наших целей это позволит получить достаточную информацию об отладке для продолжения, чтобы вы могли убедиться, что задача связывается с New Relic при первом запуске. Мы также можем попробовать использовать :force_send => true, чтобы обеспечить отправку данных.

Ссылки:

• Сообщение в блоге: Инструмент проверки вашего контроля с помощью новой реликвии