Ruby 에이전트는 컨텍스트에 로그인합니다.

루비 APM에이전트를 사용하면 다른 뉴렐릭 데이터의 컨텍스트에서 앱 로그를 볼 수 있는 logs in context(를) 얻을 수 있습니다. 이 기능에 대한 일반 정보는 컨텍스트의 APM 로그를 참조하세요.

컨텍스트 옵션의 자동 로그

앱의 로그인 및 연결 메타데이터를 뉴렐릭에 자동으로 보내도록 컨텍스트에 맞게 APM로그를 구성하는 세 가지 옵션이 있습니다.

application_logging:
  forwarding:
    enabled: true

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

application_logging:
  forwarding:
    max_samples_stored: 10000

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000

데이터 보호

로그에는 HIPAA 또는 기타 규정 준수 프로토콜로 보호되는 민감한 정보가 포함될 수 있습니다. 기본적으로 신용 카드 또는 사회 보장 번호와 같은 항목에 대해 표시되는 번호 패턴을 난독화하지만 추가 정보를 해시하거나 마스킹해야 할 수도 있습니다.

자세한 내용은 난독화 표현식 및 규칙 에 대한 설명서를 참조하세요. New Relic UI를 사용하거나 GraphQL API인 NerdGraph를 사용하여 로그 데이터를 해시하거나 마스킹할 수 있습니다.

데이터 탐색

로깅 데이터를 최대한 활용하려면:

• APM

  Summary

  페이지 에서

  Web transaction time

  차트를 클릭하면 특정 시점과 관련된 로그를 볼 수 있습니다.

• 오류와 관련된 로그를 보려면 앱의

  Errors inbox

  확인하세요.

• 분산 추적 을 사용하여 개별 추적과 연결된 로그를 확인합니다.

• 로그 UI를사용하여 플랫폼 전체에서 더 많은 로깅 데이터를 탐색하십시오.

• 로그 출력 및 심각도에 따라 경고 를 설정합니다.

• 로그 데이터용 특수 UI를 사용 하여 데이터를 쿼리 하고 결과가 포함된 대시보드를 만드 십시오.

문제 해결 팁

일반적으로 컨텍스트에서 APM로그를 활성화한 후 1분 이내에 로그가 표시되기 시작합니다. 앱의 Triage > Logs 섹션을 확인하세요. 또한 오류와 관련된 로그 패턴 도 표시되기 시작합니다.

오류 또는 추적에 대한 로그가 표시되지 않으면 앱에 대한 로그가 없을 수 있습니다. UI 페이지를 새로고침하거나 선택한 기간 을 변경하세요.

자동 로깅 비활성화

컨텍스트의 APM 로그인은 APM 에이전트 로그 데이터를 자동으로 전달하며 기본적으로 활성화되어 있습니다. 이는 보안, 규정 준수, 청구 또는 시스템 성능에 부정적인 영향을 미칠 수 있습니다. 자세한 내용을 확인하거나 기본 설정을 조정해야 하는 경우 절차에 따라 자동 로깅을 비활성화 합니다.

컨텍스트 옵션의 수동 로그인

Ruby에 대한 컨텍스트에서 로그를 설정하기 위해 수동 프로세스를 사용해야 하는 경우 다음 단계를 따르세요.

1. New Relic 에서 이미 로그인을 설정 했는지 확인하십시오. 여기에는 애플리케이션 로그를 수집하고 New Relic으로 전달되는 메타데이터를 확장하는 지원되는 로그 전달자 구성이 포함됩니다.

2. 최신 Ruby 에이전트 버전을 설치 하거나 업데이트 하고 분산 추적을 활성화합니다 . 컨텍스트의 로그에는 Ruby 에이전트 버전 6.7.0 이상 을 사용합니다.

3. Rails 애플리케이션의 경우 지원되는 Rails 버전 을 사용하십시오.

4. Ruby에 대한 컨텍스트에서 로그를 구성합니다.

   표준 Ruby on Rails 구성

   Rails 로깅은 두 가지 구성 요소에 의해 제어됩니다.

   • 설정하여 사용자 정의할 수 있는 로거 config.logger

   • config.log_formatter 을(를) 설정하여 사용자 정의할 수 있는 로그 포맷터

     대부분의 경우 Rails 애플리케이션에서 config.log_formatter 을 DecoratingFormatter 로 설정하여 컨텍스트에서 로그를 구성해야 합니다. Rails 구성에 대한 자세한 정보는 rubyonrails.org 문서 를 참조하십시오.

     애플리케이션 구성에서 newrelic_rpm 을 요구하고 다음 줄을 추가합니다.

     module ________
       class Application < Rails::Application
     
       ...
     
       config.log_formatter = ::NewRelic::Agent::Logging::DecoratingFormatter.new
       end
     end

     카피

     이 구성은 로그 메시지에 New Relic 포맷터를 사용하지만 나머지 구성은 다른 Rails 설정에서 제공합니다.

   호환되지 않는 보석

   New Relic의 장식 로거는 다음 보석과 호환되지 않는 것으로 알려져 있습니다.

   • 벌채 반출
   • 시맨틱 로거
   • rails_stdout_logger
   • rails_12factor

   Rails 고급 구성

   log_formatter 옵션을 설정해도 요구 사항이 충족되지 않으면 전체 Rails 로거를 New Relic 로거의 인스턴스로 교체하십시오. 다음과 같이 로거의 생성자에 매개변수를 제공합니다.

   module ________
     class Application < Rails::Application
   
       ...
   
       config.logger = ::NewRelic::Agent::Logging::DecoratingLogger.new(
       "log/application.log", #etc...
       )
     end
   end

   카피

   Rails가 없는 Ruby 구성

   비 Rails 애플리케이션의 경우 다음과 같이 Ruby 표준 ::Logger 대신 DecoratingLogger 을 사용합니다.

   logger = ::NewRelic::Agent::Logging::DecoratingLogger.new(
     'log/application.log', #etc...
   )
   ...
   
   logger.info(...)

   카피

   DecoratingLogger 은 Ruby 표준 ::Logger 에 대한 드롭인 대체입니다. 생성자는 동일한 매개변수를 허용합니다.

   로그지 구성

   lograge gem 을 사용하여 이 확장을 구성하려면 이 문서의 Ruby on Rails 구성에 대한 표준 절차를 따르십시오. lograge gem에는 추가 구성이 필요하지 않습니다.

   기타 로깅 확장

   다른 로깅 구현 또는 자체 사용자 정의 로거와 함께 로깅 확장 프로그램을 사용하려면 DecoratingFormatter 을 사용하십시오. 예를 들어:

   module ________
     class Application < Rails::Application
   
       ...
   
       config.logger = ::YourCustomLoggerImplementation.new(
         $stdout,
         formatter: ::NewRelic::Agent::Logging::DecoratingFormatter.new
       )
     end
   end

   카피

5. 로그 어펜더를 올바르게 구성했는지 확인하려면 애플리케이션을 실행한 다음 쿼리 연산자 has:span.id has:trace.id 를 사용하여 New Relic UI에서 로그 데이터를 확인하십시오.

모든 것이 올바르게 구성되고 데이터가 강화된 메타데이터와 함께 New Relic으로 전달되는 경우 이제 로그가 JSON으로 내보내지고 trace.id 및 span.id 필드가 포함되어야 합니다.

/config/application.rb 또는 /config/environments/development.rb 에서 로깅을 구성한 경우 로컬에서 애플리케이션을 실행하고 로깅 출력을 확인하십시오. 다음과 같은 출력이 표시되어야 합니다.

{"entity.name":"your_app_name","entity.type":"SERVICE","hostname":"79bcbf8d","trace.id":"79bcbf8d","span.id":"00fc7d46","timestamp":1567701375543,"message":"example log message one","log.level":"DEBUG"}
{"entity.name":"your_app_name","entity.type":"SERVICE","hostname":"79bcbf8d","trace.id":"79bcbf8d","span.id":"6754870b","timestamp":1567702843604,"message":"example log message two","log.level":"DEBUG"}