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

지원되는 프레임워크를 사용하는 경우 앱의 로그 및 링크 메타데이터를 New Relic에 자동으로 보내도록 APM 에이전트를 구성할 수 있습니다. 컨텍스트에서 자동 로그에 대해 지원되는 프레임워크는 다음과 같습니다.

• 모노로그(버전 2 또는 3)

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

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

  중요

  에이전트 릴리스 10.3.0부터 로깅 메트릭 및 에이전트 로그 전달 기능이 기본적으로 활성화됩니다.

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

  구성 파일( newrelic.ini ):

  newrelic.application_logging.enabled = true
  newrelic.application_logging.metrics.enabled = true
  newrelic.application_logging.forwarding.enabled = true

  카피

  PHP 에이전트 구성 문서는 에이전트를 구성하는 방법을 자세히 설명하지만 여기에서는 PHP 로그 구성의 가장 중요한 측면 중 일부를 검토하고 링크합니다.

  핵심 로깅 기능이 활성 상태인지 여부를 제어하는 단일 옵션이 있습니다.

• newrelic.application_logging.enabled

  지원되는 로깅 프레임워크를 사용하는 경우 에이전트는 애플리케이션에서 생성하는 로그 메시지의 심각도 수를 측정하는 메트릭을 보낼 수 있습니다. newrelic.application_logging.metrics.enabled 구성을 사용하여 이 기능을 활성화할 수 있습니다.

  지원되는 로깅 프레임워크를 사용 중이고 에이전트를 사용하여 애플리케이션 로그를 New Relic으로 보내려는 경우 newrelic.application_logging.forwarding 접두사가 붙은 INI 설정 설정을 통해 이를 제어할 수 있습니다. 사용 가능한 옵션은 다음과 같습니다.

• enabled

• max_samples_stored

• log_level

  Monolog 로깅 라이브러리(버전 2 또는 3)를 사용하는 경우 로그 컨텍스트 속성을 활성화할 수도 있습니다. 이는 Monolog로 전달된 로깅 컨텍스트 데이터를 New Relic 속성으로 변환합니다. 설정 newrelic.application_logging.forwarding.context_data 접두사 INI 설정을 통해 이 기능을 제어할 수 있습니다. 사용 가능한 옵션은 다음과 같습니다.

• enabled

• include

• exclude

  중요

  기존 로그 전달 솔루션이 있고 컨텍스트에서 자동 로그를 사용하도록 에이전트를 업데이트하는 경우 수동 로그 전달기를 비활성화해야 합니다 . 그렇지 않으면 앱에서 두 배의 로그 데이터를 전송합니다. 계정에 따라 이중 청구가 발생할 수 있습니다. 자세한 내용 은 특정 로그 전달자를 비활성화하는 방법을 알아보세요 .

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

이 방법을 사용하려면 컨텍스트에서 로그를 활성화하기 전에 외부 로그 전달자를 설치해야 합니다. 로그 전달자가 없는 경우 New Relic UI는 인프라 에이전트를 사용하라는 메시지를 표시합니다.

기존 로그 전달 솔루션을 사용하기로 결정하고 나중에 컨텍스트에서 자동 로그를 사용하도록 에이전트를 업데이트하기로 결정한 경우 수동 로그 전달기를 비활성화해야 합니다 . 그렇지 않으면 앱에서 이중 로그 라인을 전송합니다. 계정에 따라 이중 청구가 발생할 수 있습니다. 자세한 내용은 절차에 따라 특정 로그 전달자 를 비활성화하십시오.

로그 데코레이션을 사용하여 PHP 컨텍스트에서 로그를 활성화하도록 선택한 경우 먼저 PHP 앱을 설정하세요.

1. New Relic 에서 이미 로그인을 설정 했는지 확인하세요. 여기에는 애플리케이션 로그를 수집하고 이를 New Relic에 전달하는 지원되는 로그 전달자 구성이 포함됩니다.

2. 최신 PHP 에이전트 버전을 설치하거나 업데이트 하고 분산 추적을 활성화합니다. 로그 데코레이션 지원을 위해서는 PHP 에이전트 버전 10.13.0.1 이상을 사용하세요.

3. Monolog 버전 2 또는 3을 설치합니다.

4. Monolog 확장을 사용하여 PHP용 로그 장식을 구성합니다.

   로컬 로그 장식을 활성화하려면:

   1. 자동 로그 전달을 비활성화합니다.

      newrelic.application_logging.forwarding.enabled = false

      카피

   2. PHP 에이전트에 의한 로컬 로그 장식을 활성화합니다.

      newrelic.application_logging.local_decorating.enabled = true

      카피

   3. 이제 PHP 에이전트는 각 Monolog 로그 기록에 연결 메타데이터를 추가합니다. 이 정보가 실제 로그 메시지에 표시되려면 메시지 끝에 %extra.NR-LINKING% 형식 사양을 포함하는 각 모노로그 핸들러에 대해 모노로그 포맷터를 설정해야 합니다. 이는 컨텍스트 내 로그가 작동하는 데 필요한 연결 데이터입니다.

      예를 들어:

      <?php
      use Monolog\Logger;
      use Monolog\Formatter\LineFormatter;
      use Monolog\Handler\StreamHandler;
      
      $logger = new Logger('log');
      $handler = new StreamHandler('php://stderr');
      $logfmt = "%channel%.%level_name%: %message% %extra.NR-LINKING%\n";
      $formatter = new LineFormatter($logfmt);
      $handler->setFormatter($formatter);
      $logger->pushHandler($handler);

      카피

      데코레이터는 모든 로그 message (일반 텍스트)에 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}|

      카피

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

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