• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 를 방문하시기 바랍니다.

문제 신고

컨텍스트의 APM 로그인

New Relic에 로그를 보고하는 방법에는 여러 가지가 있습니다 . APM 에이전트를 사용하는 것은 특히 다른 로그 관리 도구를 사용하지 않아도 되는 이점을 중시하는 소규모 팀과 DevOps 팀에 널리 사용되는 방법 중 하나입니다.

컨텍스트의 APM 로그인

APM 에이전트에는 컨텍스트에서 로그 라는 기능이 있습니다. 이 기능의 이점에 대한 자세한 내용 은 컨텍스트의 로그를 참조하십시오.

APM 에이전트의 경우 컨텍스트 로그인 기능은 다음 두 가지 작업을 수행합니다.

  • 다양한 New Relic UI 환경에서 로그 데이터를 볼 수 있는 중요한 New Relic 메타데이터(예: span.id , trace.id , hostname , entity.guid , entity.name )로 앱 로그를 장식합니다.
  • 로그를 New Relic에 직접 전달하므로 타사 도구가 필요하지 않습니다.

최신 APM 에이전트 버전에는 이러한 기능이 모두 기본적으로 활성화되어 있습니다.

이 기능의 한 측면 또는 두 측면 모두를 비활성화할 수 있습니다. 데코레이션 또는 로그 전달을 비활성화하려는 이유는 제한 사항 을 참조하십시오. 예를 들어 APM 에이전트가 New Relic 메타데이터를 추가하도록 하려면 로그 데코레이션 기능을 사용할 수 있지만 로그 전달을 비활성화하고 대신 다른 로깅 에이전트(예: 인프라 에이전트 또는 타사 로깅 에이전트)를 사용할 수 있습니다. .

구현 세부 정보 및 구성 지침은 에이전트마다 다릅니다( 에이전트 세부 정보 참조 ).

컨텍스트에서 로그의 기능에 대해 자세히 알아보려면 이 사용 사례 예 를 참조하십시오. 이 예에서는 엔지니어링 팀이 컨텍스트에서 로그를 사용하여 앱의 느린 응답 시간과 증가하는 오류율 문제를 해결하는 방법을 설명합니다.

상황에 맞는 로그인이 앱과 호스트에서 문제의 근본 원인을 찾는 데 어떻게 도움이 되는지 보려면 다음 짧은 비디오(약 3분 40초)를 시청하세요.

시작하다

컨텍스트에서 APM 로그를 설정하려면:

  1. 아직 계정이 없다면 New Relic 계정을 만드 십시오. 영원히 무료입니다.
  2. APM 에이전트를 설치하고 최신 APM 에이전트 버전 인지 확인합니다.
  3. 최신 버전의 APM 에이전트에는 기본적으로 활성화된 컨텍스트(메타데이터 추가 및 전달)의 로그가 있습니다. 로그가 올바르게 작동하도록 에이전트 구성 파일을 일부 업데이트해야 하는 경우가 있습니다. 이에 대한 자세한 내용은 에이전트에 대한 로그 활성화를 참조하십시오.

그게 다야! APM UI로 이동하고 관련 로그 데이터를 찾아 상황에 맞는 APM 로그로 애플리케이션 문제 해결을 시작하십시오.

New Relic의 APM 요약 페이지에서 로그, 추적 및 오류를 드릴다운하십시오.

APM 에이전트 API

로깅 프레임워크를 컨텍스트 솔루션의 기존 로그에서 사용할 수 없는 경우 로그에 주석을 추가 하는 API 호출을 사용하여 로깅 라이브러리를 구성 할 수 있습니다.

APM 에이전트 로그 구성

최신 APM 에이전트에는 기본적으로 활성화된 컨텍스트의 로그(로그 데코레이션 및 로그 전달)가 있습니다. 다음은 로그 인 컨텍스트 및 로그 전달을 지원하는 APM 에이전트에 대한 정보입니다.

APM 로그 전달을 사용할 수 없거나 사용하지 않으려면 다른 솔루션을 사용하여 로그를 전달할 수 있습니다 .

제한 사항

APM 로그인 컨텍스트 기능은 기본적으로 활성화되어 있습니다. 이는 보안, 규정 준수, 청구 또는 시스템 성능에 부정적인 영향을 미칠 수 있습니다.

다음은 몇 가지 알려진 추가 제한 사항입니다.

  • Node.js 에이전트를 제외하고 APM 로그 전달은 전체 로그를 보내지 않습니다. 로그 전달 세부 정보에 대해 알아보세요.
  • 에이전트가 로드될 때까지 시작 로그를 사용할 수 없습니다.
  • Kubernetes를 사용하는 경우 Kubernetes API가 아닌 계측을 통해 로그를 장식한다는 점에 유의하십시오. 이것은 파일 시스템에 로그아웃하는 것과 별개입니다. 로그는 절대 호스트에 닿지 않거나 API를 호출할 수 있는 위치에 존재합니다.
  • 애플리케이션에서 예외가 발생하면 현재 Java 또는 .NET 에이전트에 대한 컨텍스트의 관련 로그에 스택 추적이 표시되지 않습니다. 해결 방법으로 드롭 필터 규칙을 변경할 수 있습니다.
  • Fluentd는 로그를 생성한 엔티티에서 processID 을 추가할 수 있지만 APM 로그는 이를 볼 수 없습니다. 또한 Kubernetes에서는 메타데이터를 추가하기 위해 API를 호출하지만 이 데이터는 애플리케이션 내에서 볼 수 없습니다. 엔터티 메타데이터가 필요한 경우 컨텍스트에서 자동 로그를 사용하는 것이 좋지만 애플리케이션에서 로그를 전송하지 않는 것이 좋습니다. 대신 Fluentd, Fluent Bit 또는 다른 솔루션을 계속 사용하여 로그 파일을 전달하세요.

기본 설정을 조정해야 하는 경우 자동 로깅 비활성화 를 참조하십시오.

데이터 프라이버시 보장

주의

New Relic으로 전송되는 로그 데이터는 사용자가 제어하므로 PII(개인 식별 정보), PHI(보호 건강 정보) 또는 기타 민감한 데이터 전송을 마스킹, 난독화 또는 방지하기 위해 조직의 보안 지침을 따라야 합니다.

당사의 로그 수집 파이프라인은 신용 카드, 주민등록번호, 주민등록번호 등을 자동으로 마스킹합니다. 자세한 내용은 로그 관리에 대한 보안 문서 를 참조하십시오.

난독화 기능을 사용하여 로그의 민감한 데이터를 마스킹하거나 해시하는 사용자 지정 규칙을 생성할 수도 있습니다. 이는 민감한 데이터에 대한 액세스를 제한하는 것이 비실용적이거나 불가능한 경우 또는 일부 데이터를 New Relic에 의해 저장해서는 안 되는 경우에 중요합니다. 자세한 내용은 난독화 문서 를 읽어보세요.

로그 전달에 대한 세부 정보

모든 APM 에이전트(Node.js 제외)의 경우 로그 전달 옵션은 전체 로그를 전달하지 않습니다. 로그 전달로 전송되는 항목에 대한 자세한 내용은 아래 축소기를 참조하십시오.

보고된 로그가 더 필요한 경우 옵션은 다음과 같습니다.

  • 특정 로그 데이터를 포함하도록 APM 에이전트를 구성합니다.
  • 로그 장식 은 그대로 유지하되 APM 에이전트 로그 전달을 비활성화하고 대신 자체 로그 전달 솔루션을 사용하십시오.

이러한 옵션에 대한 자세한 내용은 상담원별 로그인 컨텍스트 문서를 참조하세요.

중복 로그 방지

컨텍스트 기능에서 로그를 사용하면 데이터 수집이 증가합니다. 계정의 가격 모델에 따라 수집 한도 및 청구에 영향을 미칠 수 있습니다.

주의

APM 에이전트를 사용하여 애플리케이션에서 직접 로그를 보내려면 현재 해당 애플리케이션에서 로그를 수집하고 있는 로그 전달 솔루션을 비활성화하거나 수정해야 합니다. 그렇지 않으면 중복 로그가 전송되어 이중 청구가 발생합니다.

중복 로그 전송을 방지하는 방법에 대해 자세히 알아보려면 업그레이드 가이드 를 확인하세요.

자세한 내용은 절차에 따라 특정 로그 전달자 를 비활성화하십시오.

수집 한도 관리

예: 엔지니어링 팀이 앱 문제를 해결하고 있으므로 APM 에이전트가 수집하는 로그 볼륨을 일시적으로 늘려 더 세분화된 로깅을 제공합니다. 그러나 더 높은 한도를 며칠 동안 계속 실행하면 불필요한 데이터가 전송되어 청구서가 증가할 수 있습니다.

예상치 못한 상황을 방지하려면 NRQL 쿼리 를 사용하여 수집 제한을 추적하는 경고 조건 을 만드는 것이 좋습니다. 예를 들어:

예: 컨텍스트에서 로그의 힘

다음은 문제의 근본 원인을 파악하기 위해 컨텍스트에서 APM 로그를 사용하는 자세한 사용 사례입니다.

예제 시나리오: 대기 중인 엔지니어는 앱에 대한 응답 시간이 느리고 오류율이 증가한다는 New Relic 경고 알림을 받습니다. 그들은 오류 및 지연 시간 증가의 근본 원인을 찾아야 하므로 문제가 있는 호스트를 로드 밸런싱에서 교체할지 아니면 최신 릴리스를 롤백할지 결정할 수 있습니다.

문제 해결을 시작하려면 New Relic UI로 이동합니다.

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.