컨텍스트의 Python 에이전트 로그

이것은 가장 간단한 접근 방식이며, 로그 전달자 설정에 대한 액세스 권한이나 관심이 없는 개발자 또는 앱 컨텍스트에서 로그 및 기타 연결 메타데이터의 힘을 확인하려는 계정에 탁월한 선택입니다. 많은 오버 헤드.

이 옵션을 사용하여 에이전트는 span.id , trace.id , hostname , entity.guid 및 entity.name 를 추가합니다. 로그 전달 제한에 대해 알아보세요.

로그 전달 기능이 있는 에이전트 버전(Python 에이전트 7.12.0.176 이상)을 설치하기만 하면 됩니다. 전달이 비활성화된 경우 다음 구성을 사용할 수 있습니다.

newrelic.ini:

application_logging.enabled=true
application_logging.forwarding.enabled=true

환경 변수:

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

이 옵션은 에이전트 버전 7.16.0.178 부터 기본적으로 켜져 있습니다.

Optional adjustments:

이 기능이 활성화되면 1분마다 New Relic에 전송되는 최대 로그 수를 제어할 수 있습니다. 기본값은 10,000입니다. 60초 동안 10,000개 이상의 로그가 수신되면 로그 샘플링이 시작됩니다.

더 많은 로그를 수신하려면 더 높은 숫자로 설정하십시오. 더 적은 수의 로그를 수신하려면 더 낮은 숫자로 설정하십시오. 100,000까지의 모든 정수가 유효합니다.

newrelic.ini:

접착제 에이전트 버전 11.0.0+의 경우:

application_logging.forwarding.max_samples_stored=10000

끌어 당기는 에이전트 버전 10.17.0 이하의 경우:

event_harvest_config.harvest_limits.log_event_data=10000

환경 변수:

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000

기존 로그 포워딩 솔루션이 있고 컨텍스트에서 자동 로그인을 사용하도록 에이전트를 업데이트하는 경우 disable your manual log forwarder 를 확인하세요. 그렇지 않으면 앱이 이중 로그 라인을 전송하게 됩니다. 귀하의 계정에 따라 이중 청구가 발생할 수 있습니다. 자세한 내용을 보려면 특정 로그 전달자를 비활성화하는 절차를 따르십시오.

이미 마음에 드는 로그 포워더가 있습니까? 우리는 당신을 덮었습니다! 언어 에이전트는 자동 로그인 컨텍스트 기능에 대한 액세스를 제공하는 데 필요한 연결 메타데이터로 로그를 장식할 수 있습니다.

이 옵션은 에이전트 내 전달과 함께 사용하면 안 됩니다. 에이전트 내 전달이 활성화된 상태에서 외부 로그 전달자 를 사용하여 New Relic에 로그를 전송하면 로그가 New Relic에 최대 두 번 전송됩니다. 계정에 따라 이중 청구가 발생할 수 있습니다.

이 옵션은 수동 로그 데코레이팅 포맷터 와 함께 사용하면 안 됩니다. 코드베이스에 수동 포맷터에 대한 참조가 있는 경우 이 옵션을 활성화하기 전에 제거하십시오.

1. 이 옵션을 사용하려면 에이전트 내 전달 구성 옵션을 비활성화해야 합니다.

   newrelic.ini:

   application_logging.forwarding.enabled=false

   카피

2. 구성에서 로그 데코레이션을 활성화한 다음 에이전트를 다시 시작하여 로그 데코레이션을 시작합니다.

   newrelic.ini:

   application_logging.enabled=true
   application_logging.forwarding.enabled=false
   application_logging.local_decorating.enabled=true

   카피

   환경 변수:

   NEW_RELIC_APPLICATION_LOGGING_ENABLED: "true"
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED: "false"
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED: "true"

   카피

   우리의 데코레이터는 모든 로그 메시지에 entity.guid , entity.name , hostname , trace.id 및 span.id 5가지 속성을 추가합니다. 예시:

   This is my log message. NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|

   카피

   로그 메시지가 비어 있거나 공백인 경우, 출력 메시지도 비어 있게 됩니다. 예:

   NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|.

   카피

   출력 로그 메시지는 빈 문자열입니다.

   로그가 트랜잭션 외부에서 발생했거나 애플리케이션 컨텍스트에 적용할 수 없는 경우 일부 속성은 비어 있을 수 있습니다.

   수동 데코레이션 포맷터( NewRelicContextFormatter )보다 이 옵션을 사용하는 것이 좋습니다.

수동 설치 옵션을 사용하여 Python에서 모니터링하는 APM앱에 대한 컨텍스트에서 로그를 활성화할 수도 있습니다.

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

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

3. 로그 처리기에 대한 컨텍스트에서 로그를 구성합니다. 언어 에이전트가 로그를 전달하고 장식할 수 있기 전에는 로그 포맷터를 인스턴스화하고 로그 처리기에 추가하여 컨텍스트에서 로그를 활성화할 수 있었습니다. 이 예에서는 기본적으로 sys.stderr 에 로그를 기록하는 StreamHandler 을 사용하지만 모든 핸들러를 사용할 수 있습니다. 로그 처리기 구성에 대한 자세한 내용은 Python.org 설명서 를 참조하십시오.

   # Import the logging module and the New Relic log formatter
   import logging
   from newrelic.agent import NewRelicContextFormatter
    
   # Instantiate a new log handler
   handler = logging.StreamHandler()
    
   # Instantiate the log formatter and add it to the log handler
   formatter = NewRelicContextFormatter()
   handler.setFormatter(formatter)
    
   # Get the root logger and add the handler to it
   root_logger = logging.getLogger()
   root_logger.addHandler(handler)

   카피

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

   모든 것이 올바르게 구성되고 데이터가 강화된 메타데이터와 함께 New Relic으로 전달되는 경우 이제 로그가 JSON으로 내보내지고 trace.id 및 span.id 필드가 포함되어야 합니다. UI에 로그 데이터가 표시되지 않으면 문제 해결 절차 를 따르세요.