• 로그인지금 시작하세요

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

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

문제 신고

컨텍스트의 APM 로그인

앱이나 호스트의 문제를 해결할 때 모든 New Relic 도구가 필요합니다. 그러나 UI 전체에서 컨텍스트 전환을 많이 하거나 사용 가능한 정보의 풍부함에 압도되는 것을 원하지 않습니다.

당사의 APM 에이전트는 애플리케이션 로그 데이터에 관련 속성을 자동으로 추가할 수 있습니다. 따라서 컨텍스트에서 로그를 매우 쉽게 사용할 수 있습니다. 응용 프로그램은 에이전트를 사용하여 로그 데이터를 New Relic에 직접 전달할 수도 있습니다.

로그는 속한 애플리케이션, 트랜잭션 또는 오류의 컨텍스트에서 더 가치가 있습니다. 컨텍스트 기능의 로그를 사용하면 애플리케이션의 로그, 분산 추적 및 APM에서 직접 오류를 볼 수 있으므로 문제 해결 방식이 변경됩니다.

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

컨텍스트에서 자동 로그의 기능에 대해 자세히 알아보세요. 이 예에서는 엔지니어링 팀이 앱의 응답 시간이 느리고 오류율이 높아지는 문제를 해결하기 위해 이를 어떻게 사용했는지 설명합니다.

시작하다

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

  1. 아직 계정이 없다면 New Relic 계정을 만드 십시오. 영원히 무료입니다.
  2. 앱 및 호스트에 대해 지원되는 에이전트 버전 으로 업데이트하십시오.
  3. 에이전트에 대한 로그를 활성화 하고 구성 파일을 약간 업데이트합니다.

그게 다야! New Relic의 컨텍스트에서 APM 로그를 사용하여 애플리케이션 문제 해결을 시작하십시오.

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

APM 에이전트 로그 구성

최신 APM 에이전트는 타사 소프트웨어를 설치하거나 유지 관리할 필요 없이 자동으로 컨텍스트 추가 및 로그 전달을 지원합니다! 로그에는 span.id , trace.id , hostname , entity.guid , entity.name 등과 같은 속성이 자동으로 포함됩니다. 이 메타데이터는 로그를 추적, 범위, 인프라 데이터 및 기타 원격 측정에 연결하므로 문제를 더 쉽게 해결할 수 있습니다.

일부 언어 또는 로깅 프레임워크는 아직 지원되지 않습니다. 다음은 언어별 문서에 대한 링크와 함께 현재 지원되는 환경입니다.

APM 에이전트가 컨텍스트 솔루션의 자동 로그를 아직 지원하지 않는 경우 컨텍스트 솔루션 에서 수동 로그를 계속 사용하고 인프라 에이전트 또는 지원되는 타사 전달자를 통해 로그를 전달할 수 있습니다.

알려진 제한 사항

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

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

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

데이터 프라이버시 보장

주의

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

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

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

중복 로그 방지

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

주의

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

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

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

수집 한도 관리

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

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

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

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

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

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

Copyright © 2022 New Relic Inc.

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