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

Node.js APM 에이전트를 사용하면 컨텍스트에서 APM로그를 얻을 수 있으며, 이를 통해 다른 뉴렐릭 데이터의 컨텍스트에서 앱 로그를 볼 수 있습니다. 이 기능에 대한 일반 정보는 컨텍스트의 APM 로그를 참조하세요.

컨텍스트 옵션의 자동 로그

애플리케이션 로깅을 사용하면 APM 에이전트가 자동으로 로그를 수집하고 컨텍스트화합니다.

지원되는 프레임워크를 사용하는 경우 컨텍스트에서 APM 로그를 구성하여 앱의 로그를 보내고 메타데이터를 New Relic에 자동으로 연결하는 세 가지 옵션이 있습니다.

컨텍스트에서 자동 로그에 대해 지원되는 프레임워크는 다음과 같습니다.

• 윈스턴 3.0.0 또는 더 높게.
• 피노 7.0.0 이상.
• Bunyan 1.8.12 이상(에이전트 버전 9.3.0부터)

지원되는 프레임워크를 사용하지 않는 경우 대신 에이전트의 로그 전달 API 메서드를 사용하여 자체 계측을 수행할 수 있습니다. 자세한 내용은 Node.js 에이전트 API 문서 를 참조하세요.

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 에이전트 로그 데이터를 자동으로 전달합니다. 기본적으로 활성화되어 있습니다. 애플리케이션 로깅을 활성화하면 보안, 규정 준수, 청구 또는 시스템 성능에 부정적인 영향을 미칠 수 있습니다. 자세한 내용을 확인하거나 기본 설정을 조정해야 하는 경우 절차에 따라 자동 로깅을 비활성화 합니다.

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

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

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

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

3. 지원되는 프레임워크 를 설치하여 로그 데이터를 보강하거나 에이전트의 로그 전달 API를 직접 사용하세요.

4. 에이전트 구성에서 application_config.enabled 을 false 로 설정합니다. (그렇지 않으면 에이전트가 자동으로 로거를 계측하고 이러한 농축기를 직접 호출하면 아무 일도 하지 않습니다.)

5. 적절한 로그 확장을 사용하여 Node.js에 대한 컨텍스트에서 로그를 구성합니다.

   Winston을 사용한 Node.js 구성

   1. Winston 로그 농축기를 설치하려면 터미널 또는 명령줄 인터페이스에 다음 명령을 입력하십시오.

      bash

      카피

      $
      npm install @newrelic/winston-enricher

   2. 애플리케이션 코드에서 로깅 구성을 업데이트하여 newrelicFormatter 을 추가합니다.

      // index.js
      require('newrelic')
      const winston = require('winston')
      const newrelicFormatter = require('@newrelic/winston-enricher')(winston)

      카피

      New Relic 포맷터는 개별적으로 사용하거나 다른 포맷터와 결합하여 최종 포맷으로 사용할 수 있습니다.

      format: winston.format.combine(
        winston.format.label({label: 'test'}),
        newrelicFormatter()
      )

      카피

   Pino를 사용한 Node.js 구성

   1. Pino 로그 농축기를 설치하려면 터미널 또는 명령줄 인터페이스에 다음 명령을 입력하십시오.

      bash

      카피

      $
      npm install @newrelic/pino-enricher

   2. 애플리케이션 코드에서 로깅 구성을 업데이트하여 New Relic Pino 플러그인을 추가합니다.

      // index.js
      require('newrelic')
      const nrPino = require('@newrelic/pino-enricher')
      const pino = require('pino')
      const logger = pino(nrPino())

      카피

      New Relic 포맷터는 개별적으로 사용하거나 다른 포맷터와 결합하여 최종 포맷으로 사용할 수 있습니다.

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

모든 것이 올바르게 구성되고 데이터가 강화된 메타데이터와 함께 New Relic으로 전달되는 경우 이제 로그가 JSON으로 내보내지고 trace.id 및 span.id 필드가 포함되어야 합니다. UI에 로그 데이터가 표시되지 않으면 문제 해결 절차 를 따르세요. 컨텍스트에서 작동하는 로그의 예를 보려면 예제 애플리케이션 을 살펴보십시오.

다음은 뭐지?

컨텍스트에 맞게 APM로그를 설정한 후 로깅 데이터를 최대한 활용하세요.

• 로그 UI를사용하여 플랫폼 전체에서 로깅 데이터를 탐색합니다.
• APM UI 의 앱 성능 컨텍스트에서 로그를 확인합니다. 분산 추적 , 스택 추적, 애플리케이션 로그 등으로 오류 를 해결합니다.
• 인프라 에이전트를 통해 로그를 전달하여 애플리케이션과 플랫폼 성능 데이터에 대한 더 깊은 가시성을 확보하세요. UI에서 인프라 로그를 검토하세요.
• 경보를 설정하십시오.
• 데이터를 조회 하고 대시보드를 작성하십시오.