• /
  • EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

인프라 에이전트를 사용하여 로그 전달

로그를 뉴렐릭으로 전달하면 모든 로깅 데이터를 한 위치에서 사용할 수 있으며 애플리케이션과 플랫폼 성능 데이터 모두에 대한 더 깊은 가시성을 확보할 수 있습니다. 로그를 한 곳에서 수집, 처리, 탐색, 쿼리하고 로그 데이터에서 발견된 오류 또는 이상에 대해 알림을 제공할 수 있습니다.

Screenshot of logs in context for a host

호스트의 UI에서, 선택된 기간 동안의 이벤트의 로그가 문맥으로 표시됩니다. 강조 표시된 속성에 대한 데이터를 세부적으로 검토할 수 있습니다.

인프라 에이전트가 로그 전달 기능을 활성화하므로, 로그를 전달하는 방법은 인프라 에이전트를 설치한 방법에 따라 다를 수 있습니다. 다음을 통해 인프라 에이전트를 설치할 수 있습니다.

  • 안내 설치(대부분의 사용자에게 권장됨)
  • 수동 설치
  • Linux tarball

중요

Linux 버전의 인프라 에이전트, 특히 버전 1.42.0은 td-agent-bit 패키지 사용에서 fluent-bit 패키지로 전환되었습니다. 주요 버전 2.x 업데이트 후 fluent-bit가 더 이상 td-agent-bit 플레이버에 배포되지 않는다는 사실 때문에 이러한 변경이 필요했습니다.

원활한 작동을 보장하고, fluent-bit 패키지에 문제가 있는 경우 td-agent-bit로 되돌릴 수 있는 옵션을 제공하기 위해 인프라 에이전트는 이제 두 패키지(td-agent-bit 및 fluent-bit)를 모두 설치합니다. 기본적으로 에이전트는 fluent-bit를 사용하도록 설정됩니다.

롤백 방법에 대한 자세한 내용은 Fluent Bit 1.9로 롤백하는 방법을 참조하십시오.

로그가 많이 있으신가요? 로그 최적화 및 관리 방법에 대한 튜토리얼을 확인하십시오.

시스템 요구 사항

안내 설치를 통해 자동으로 로그 전달

안내 설치를 사용해 인프라 에이전트를 설치하면 설치 프로세스 중에 로그 전달 기능이 자동으로 설정됩니다.

설치를 시작하려면 배포 방법을 선택합니다.

Amazon Linux
Amazon Linux
Ansible
Ansible
CentOS
CentOS
Debian
Debian
Red Hat
RHEL
SLES
SLES
Ubuntu
Ubuntu
Windows
Windows

중요

도커 컨테이너에서 로그를 전달하려면 이 도커 이미지를 쿠버네티스 로그인 통합과 사용할 기본 이미지로 사용하거나, 다양한 환경에 대해 설정을 맞춤화하여 자체 컨테이너를 구축할 수 있습니다.

수동으로 설치된 에이전트에서 로그 전달을 활성화하는 방법

인프라 에이전트를 수동으로 설치하려면 튜토리얼에 따라 패키지 관리자를 설치하거나 MSI 설치 프로그램 (Windows)을 확인합니다.

1단계. 인프라 에이전트 구성

구성 파일은 뉴렐릭에 표시하려는 로그 소스를 전달하도록 시스템에 지시합니다. 원하는 만큼 구성 파일을 추가할 수 있습니다. 인프라 에이전트는 .yml 파일을 사용하여 로깅을 구성합니다. UI에서 통합 및 에이전트를 통해 인프라 에이전트를 설치하면 logging.yml 파일이 자동으로 생성됩니다.

로그 전달 기능에 대한 새 구성 파일을 추가하려면:

  1. 로그 전달자 구성 폴더로 이동합니다.

    • Linux: /etc/newrelic-infra/logging.d/
    • Windows: C:\Program Files\New Relic\newrelic-infra\logging.d\
  2. logging.yml 구성 파일을 만들고 필요한 매개변수를 추가합니다. logging.d 디렉터리에는 참조 또는 시작점으로 사용할 수 있는 다양한 .yml.example 파일이 있습니다. Windows 예제는 Github 저장소를 참조하십시오.

    # Log forwarder configuration file example
    # Source: file
    # Available customization parameters: attributes, max_line_kb, pattern
    logs:
    # Basic tailing of a single file
    - name: basic-file
    file: /var/log/logFile.log
    # File with spaces in its path. No need to use quotes.
    - name: file-with-spaces-in-path
    file: /var/log/folder with spaces/logFile.log
    # Specify a list of custom attributes, as key-value pairs, to be included
    # in each log record
    - name: file-with-attributes
    file: /var/log/logFile.log
    attributes:
    application: tomcat
    department: sales
    maintainer: example@mailprovider.com
    # Use wildcards to refer to multiple files having a common extension or
    # prefix. Newly generated files will be automatically detected every 60
    # seconds.
    #
    # WARNING: avoid using wildcards that include the file extension, since
    # it'll cause logs to be forwarded repeatedly if log rotation is enabled.
    - name: log-files-in-folder
    file: /var/log/logF*.log
    # Lines longer than 128 KB will be automatically skipped. Use 'max_line_kb'
    # to increase this limit.
    - name: log-file-with-long-lines
    file: /var/log/logFile.log
    max_line_kb: 256
    # Use 'pattern' to filter records using a regular expression
    - name: only-records-with-warn-and-error
    file: /var/log/logFile.log
    pattern: WARN|ERROR

에이전트는 인프라 모니터링 서비스를 다시 시작할 필요 없이 새 구성 파일을 자동으로 처리합니다. 이에 대한 유일한 예외는 커스텀 Fluent Bit 구성을 하는 경우입니다.

2단계. 로그 전달 파라미터 설정

로그 전달 .yml 구성 파일에서 name 및 로그 소스 파라미터를 설정해야 합니다. 시작하려면 뉴렐릭에 전달할 로그의 name을 정의합니다.

로그 소스에 무엇을 사용하는지는 로그 소스 위치에 따라 다릅니다. 로그 소스에 사용 가능한 옵션은 다음과 같습니다.

3단계. 키 속성 정의

이러한 구성 파라미터는 필수는 아니지만 로그 전달을 최대한 활용할 수 있도록 이러한 구성을 logging.yml 파일에 적용하는 것이 좋습니다.

샘플 구성 파일

다음은 YAML 형식의 logging.d 구성 파일의 예입니다. 더 많은 구성 예는 인프라 에이전트 저장소를 참조하십시오.

4단계. 로그 데이터 보기

모든 것이 올바르게 구성되고 데이터가 수집되는 경우 다음 위치에서 로그 및 관련 텔레메트리 데이터를 확인해야 합니다.

  • 로그 UI
  • 인프라 UI의 호스트 테이블에서 특정 호스트에 대한 아이콘을 클릭한 다음 View logs를 클릭합니다.
  • NRQL 쿼리 실행을 위한 툴입니다.예를 들어 다음과 같은 쿼리를 실행할 수 있습니다.
SELECT * FROM Log

온-호스트 통합의 로깅 활성화

인프라 에이전트를 설치하면 가장 널리 사용되는 온-호스트 통합에 대한 자동 로그 구문 분석 및 전달을 한 단계로 활성화할 수 있습니다. 이 기능을 활성화하려면 on-host-log.yml.example 파일의 이름을 on-host-log.yml로 바꿉니다. 완료되면 통합 로그가 자동으로 구문 분석되어 뉴렐릭으로 전송됩니다.

이 옵션은 지원되는 Linux 플랫폼에서 사용할 수 있습니다.

호스트 내 통합 로그 전달 기능을 활성화하려면:

Linux tarball을 사용하여 설치된 에이전트에서 로그 전달 활성화

인프라 모니터링을 위한 맞춤형 Linux 설치 프로세스를 통해 설치 프로세스의 모든 측면을 조정하고 시스템에 파일과 폴더를 배치할 수 있습니다. 지원 또는 수동 tarball 설치 프로세스를 선택한 경우, 다음 단계에 따라 로그 전달자 기능을 구현합니다.

  1. 다음 디렉터리를 만듭니다.

    • /var/db/newrelic-infra/newrelic-integrations/logging
    • /etc/newrelic-infra/logging.d
  2. 다음과 유사한 명령을 실행하여 뉴렐릭의 fluent-bit-package(RPM)를 다운로드하고 설치합니다.

    bash
    $
    yum localinstall fluent-bit-<some-version>.rpm
  3. 뉴렐릭의 fluentbit 플러그인을 다운로드하고 /var/db/newrelic-infra/newrelic-integrations/logging/out_newrelic.so로 저장합니다.

  4. 이 Github 저장소에서 parsers.conf 파일을 다운로드하거나 복사하고 /var/db/newrelic-infra/newrelic-integrations/logging/parsers.conf에 저장합니다.

이 문서가 설치하는데 도움이 되셨나요?

문제 해결

로그 전달자를 구성하는 데 문제가 발생하면 다음 문제 해결 팁을 시도하십시오.

다음 단계는?

로그 UI를 사용하여 플랫폼 전반에 걸쳐 로깅 데이터를 탐색합니다.

로그 전달 비활성화

로그 전달 기능을 비활성화하려면 logging.d 디렉터리로 이동하여 구성 프로세스 중에 원래 추가된 확장명이 .yml인 파일을 제거합니다.

  • Linux: /etc/newrelic-infra/logging.d/
  • Windows: C:\Program Files\New Relic\newrelic-infra\logging.d\
Copyright © 2024 New Relic Inc.

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