타사 계측

트랜잭션을 시작하는 가장 간단한 방법은 메서드에서 add_transaction_tracer 를 호출하는 것입니다. 이것은 NewRelic::Agent::Instrumentation::ControllerInstrumentation 이(가) 클래스에 포함되어 있다고 가정합니다.

class CustomBackgroundJob
  include NewRelic::Agent::Instrumentation::ControllerInstrumentation

  def transaction
    # execute a transaction
  end

  add_transaction_tracer :transaction
end

때때로 New Relic이 생성하는 트랜잭션을 약간 더 제어해야 합니다. 이 경우 perform_action_with_newrelic_trace 을 사용할 수 있습니다. 재정의할 수 있는 일부 매개변수에는 트랜잭션 이름 및 범주(웹 트랜잭션이든 백그라운드 트랜잭션이든)가 포함됩니다.

class CustomBackgroundJob
  include NewRelic::Agent::Instrumentation::ControllerInstrumentation

  def transaction
   perform_action_with_newrelic_trace(:name    => "custom_name",
                                     :category => :task) do
     # your work here...
   end
  end

end

자세한 파라미터, 변수 및 사용법은 perform_action_with_newrelic_trace의 전체 설명서를 참조하세요.

require 'new_relic/agent/method_tracer'
class Foo
  include ::NewRelic::Agent::MethodTracer

  def generate_image
    # ...
  end

  add_method_tracer :generate_image, 'Custom/generate_image'
end

위의 예에서는 'Custom/generate_image' 이름에 대한 측정항목이 기록되고 메서드 호출이 포함된 트랜잭션 추적 항목이 기록됩니다.

trace 메소드에 대한 Datastore를 기록하는 가장 간단한 방법입니다.

class FauxDB

 def find
   # FauxDB lookup
 end

 NewRelic::Agent::Datastores.trace self, :find, "FauxDB"

end

첫 번째 매개변수는 계측할 클래스, 두 번째 매개변수는 찾을 메서드, 세 번째 매개변수는 데이터 저장소 제품 이름입니다. 선택적 작업 이름이 최종 매개변수로 포함될 수 있습니다. 그렇지 않으면 메서드 이름이 메트릭에서 작업을 나타내는 데 사용됩니다.

이 인터페이스로 기록된 Datastore 측정항목은 컬렉션/테이블 이름 추가를 허용하지 않습니다. 이를 위해 아래의 wrap 메서드를 참조하세요.

wrap 측정항목 이름에 추가 컬렉션/테이블 정보가 포함된 Datastore 측정항목을 기록할 수 있습니다. 또한 느린 문을 알아차리는 것과 같은 작업에 대한 콜백을 제공합니다.

class FauxDB

  def find(table)
    NewRelic::Agent::Datastores.wrap("FauxDB", "find", table) do
    # FauxDB lookup
    end
  end

end

데이터 저장소 호출에 대한 추가 정보를 기록하려면 wrap 에서 선택적 콜백 매개변수를 사용할 수 있습니다.

class FauxDB

 def find(query)
   callback = Proc.new do |result, scoped_metric, elapsed|
     NewRelic::Agent::Datastores.notice_sql(query, scoped_metric, elapsed)
   end

   NewRelic::Agent::Datastores.wrap("FauxDB", "find", "items", callback) do
     # execute query
   end
 end

end

이 도우미 메서드는 트랜잭션 추적 및 느린 SQL 페이지에 표시하기 위해 느린 SQL 쿼리를 기록합니다. SQL은 사용자 설정에 따라 필터링되고 난독화됩니다.

NewRelic::Agent::Datastores.notice_sql(query, scoped_metric, elapsed)

비 SQL 쿼리는 notice_sql 를 통해 보내지 않아야 합니다. 대신 notice_statement 를 사용하세요.

이 도우미 메서드는 트랜잭션 추적에 대한 느린 데이터 저장소 호출에 대한 문을 기록합니다. 이것들은 난독화 되지 않습니다 .

NewRelic::Agent::Datastores.notice_statement(statement, elapsed)

SQL 쿼리는 notice_statement 를 통해 전송되어서는 안 됩니다. 대신 notice_sql 을(를) 사용하십시오.

이 섹션에 설명된 테스트 메서드는 테스트 코드(가장 일반적으로 test_helper.rb 파일)에서 이를 호출하여 액세스할 수 있습니다.

NewRelic::Agent.require_test_helper

이 방법은 예상 메트릭이 Ruby 에이전트에 의해 기록되도록 하는 기본 방법입니다. refute_metrics_recorded 도 사용할 수 있습니다.

가장 간단한 형태로 assert_metrics_recorded 은 다음과 같이 호출할 수 있습니다.

assert_metrics_recorded(["MetricA", "MetricB"])

특정 값이 있는 메트릭은 다음 구문을 통해 어설션될 수 있습니다.

assert_metrics_recorded('MetricA' => {
                         :call_count => 1,
                         :total_call_time => 1.0 })

이러한 메서드는 웹 또는 백그라운드 트랜잭션에서 실행을 시뮬레이션합니다.

in_web_transaction do
  # Perform work to test behavior in transaction
end

with_config 을(를) 통해 테스트를 위해 에이전트 구성을 변경할 수 있습니다. 에이전트의 다른 구성 값에 적용되는 해시를 취합니다.

with_config(:enabled => false) do
  # Check what happens when agent's disabled
end

여러 gem 버전에 대해 확장을 테스트해야 하는 경우 Ruby 에이전트 자체 테스트 코드의 일부인 Multiverse를 사용할 수 있습니다. 다중 우주 테스트의 예 는 에이전트 파일의 suites 디렉토리를 참조하십시오.

자신의 gem에 대해 Multiverse를 구성하려면:

1. Require tasks/multiverse in Rakefile. rake test:multiverse 명령을 활성화하려면 Rakefile에 다음을 추가하세요.

   require "tasks/multiverse"

   카피

2. Create the Multiverse test directory. 다중 우주 테스트에는 특정 파일 레이아웃이 필요합니다. 다음 파일 위치를 사용하여 test/multiverse/YOUR_PROJECT 이라는 디렉터리를 만듭니다.

   test/multiverse/YOUR_PROJECT
   test/multiverse/YOUR_PROJECT/Envfile
   test/multiverse/YOUR_PROJECT/config/newrelic.yml
   test/multiverse/YOUR_PROJECT/FILE_WITH_A_TEST.rb

   카피

3. Configure your Envfile. Multiverse 테스트를 위해 gem 의존성/종속성 세트를 선언하려면 Envfile 를 사용하세요. 예를 들어, Envfile 은 다음과 같습니다.

   gemfile <-RB
     gem 'your-project', '~> 1.0.0'
     gem 'rack'
     gem 'newrelic_rpm'
     gem 'newrelic_your-project', path: '../../..'
   RB
   
   gemfile <-RB
     gem 'your-project', '~> 2.1.0'
     gem 'rack'
     gem 'newrelic_rpm'
     gem 'newrelic_your-project', path: '../../..'
   RB

   카피

   팁

   Multiverse 테스트가 작동하는지 확인하려면 newrelic_rpm 및 rack 에 대해 gem 줄을 포함합니다.

4. Detect dependencies. 필요한 경우 Multiverse 테스트에서 추가 의존성/종속성 감지를 실행하여 확장 프로그램의 리소스가 로드되었는지 확인하세요.

   require 'newrelic/your-project'
   
   DependencyDetection.detect!
   
   class YourProjectTest > Minitest::Test
   end

   카피

   Envfile 의 gem 의존성/종속성에 대해 Multiverse 테스트를 실행하려면 다음을 수행하세요.

• Gem에 대해 Multiverse를 설정한 후 rake test:multiverse 을 실행하여 디렉터리에서 테스트를 실행합니다.