• 로그인지금 시작하세요

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

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

문제 신고

로그 전달을 위한 Fluent Bit 플러그인

Fluent Bit 에서 이미 로그 데이터를 모니터링하고 있는 경우 Fluent Bit 출력 플러그인을 사용하여 New Relic에서 로그 데이터를 전달하고 강화할 수 있습니다.

Fluent Bit 로그를 New Relic에 전달하면 로그 데이터를 수집, 처리, 탐색, 쿼리 및 경고할 수 있는 향상된 로그 관리 기능이 제공됩니다.

기본 프로세스

플러그인이 설치된 컨테이너를 게시했습니다. Kubernetes 통합에서 사용할 기본 이미지 역할을 합니다. 이 기본 이미지를 사용하고 고유한 사용자 지정 구성 파일을 계층화하는 것이 좋습니다.

Fluent Bit에서 New Relic으로 로그를 전달하려면:

  1. 다음 사항이 있는지 확인하십시오.

    • A New Relic 라이센스 키
    • Fluent Bit 1.0 이상(권장), v0.12 이상이 지원되지만
    • Fluent Bit Windows 설치 지침은 여기 에서 찾을 수 있습니다.
    • Fluent Bit Linux 설치 지침은 여기 에서 찾을 수 있습니다.
  2. Fluent Bit 플러그인을 설치 합니다.

  3. Fluent Bit 플러그인을 구성 합니다.

  4. Fluent Bit 플러그인을 테스트 합니다.

  5. 일부 트래픽을 생성하고 몇 분 동안 대기한 다음 데이터에 대해 계정을 확인 하십시오.

Fluent Bit 플러그인 설치

Fluent Bit 플러그인을 설치하려면:

  1. GitHub에서 New Relic의 Fluent Bit 플러그인 저장소로 이동합니다.
  2. 리포지토리 페이지에서 리포지토리를 복제하거나 다운로드합니다 .
  3. 다음 명령을 실행하여 플러그인을 빌드합니다.
cd newrelic-fluent-bit-output && make all
  1. fluent-bit 데몬이 액세스할 수 있는 위치에 out_newrelic.so 또는 out_newrelic_winXX.dll 을 저장합니다.

플러그인을 직접 컴파일하지 않으려면 GitHub 리포지토리의 릴리스 페이지 에서 사전 컴파일된 버전을 다운로드할 수 있습니다.

Fluent Bit 플러그인 구성

Fluent Bit는 New Relic 플러그인의 위치와 New Relic 라이센스 키를 알아야 New Relic에 데이터를 출력할 수 있습니다. Fluent Bit 플러그인을 구성하려면:

중요

구성 파일을 편집할 때 공백에 주의하십시오. 들여쓰기에 4개의 공백을 사용하고 키와 값 사이에 1개의 공백을 사용해야 합니다.

  1. 플러그인 디렉토리에서 plugins.conf 파일을 찾거나 만듭니다.

  2. plugins.conf 파일에서 fluent-bit.conf 파일 옆에 out_newrelic.so 에 대한 참조를 추가합니다.

    [PLUGINS]
        Path /PATH/TO/newrelic-fluent-bit-output/out_newrelic.so
  3. fluent-bit.conf 파일에서 service 블록 아래에 다음 줄을 추가합니다.

    [SERVICE]
    # This is the main configuration block for fluent bit.
    # Ensure the follow line exists somewhere in the SERVICE block
    Plugins_File plugins.conf
  4. fluent-bit.conf 파일 하단에 다음을 추가하여 입력 및 출력 필터를 설정합니다. 자리 표시자 텍스트를 New Relic 라이선스 키로 교체합니다.

    [INPUT]
        Name tail
        Path /PATH/TO/YOUR/LOG/FILE
    
    [OUTPUT]
        Name newrelic
        Match *
        licenseKey YOUR_LICENSE_KEY
    
    # Optional
    maxBufferSize 256000
    maxRecords 1024
  5. 다음 명령을 사용하여 Fluent Bit 인스턴스를 다시 시작합니다.

    fluent-bit -c /PATH/TO/fluent-bit.conf

Fluent Bit 플러그인 테스트

Fluent Bit 플러그인이 로그 파일에서 입력을 수신하는지 테스트하려면:

  1. 다음 명령을 실행하여 테스트 로그 메시지를 로그 파일에 추가합니다.

    echo "test message" >> /PATH/TO/YOUR/LOG/FILE
  2. test message 에 대한 New Relic의 로그 UI 를 검색합니다.

항목과 로그 연결

로그 줄을 인프라 호스트와 같은 항목 과 연결하려면 FILTER 블록을 추가합니다.

[FILTER]
Name modify
Match * # Or specify a match
Add entity.guids <Your Entity GUID ID> # Optional
Add hostname <Your hostname> # Optional

더 많은 옵션은 Fluent Bit 수정 필터 문서인프라 에이전트를 사용하여 로그를 전달 하는 문서를 참조하십시오.

선택 사항: 플러그인 속성 구성

Fluent Bit 플러그인을 설치구성한 후에는 다음 속성을 사용하여 플러그인이 New Relic에 데이터를 보내는 방법을 구성할 수 있습니다.

열쇠

설명

licenseKey

New Relic 라이센스 키 . licenseKey ( 권장 ) 또는 apiKey 둘 다 사용하지 마십시오. 기본: none

maxBufferSize

페이로드가 보낸 최대 크기(바이트)입니다. 기본: 256000

maxRecords

한 번에 보낼 최대 레코드 수입니다. 기본: 1024

apiKey

더 이상 사용되지 않습니다. New Relic Insights 삽입 키 를 사용하지만 licenseKey 속성을 사용하는 것이 좋습니다. licenseKey 또는 apiKey 둘 다 사용하지 마십시오.

로그 데이터 보기

모든 것이 올바르게 구성되고 데이터가 수집되는 경우 다음 두 위치에서 데이터 로그가 표시되어야 합니다.

SELECT * FROM Log

로그 관리 기능을 활성화한 후에도 데이터가 나타나지 않으면 표준 로그 문제 해결 절차 를 따르십시오.

다음은 뭐지?

로그 UI 를 사용하여 플랫폼 전반에 걸쳐 로깅 데이터를 탐색하십시오.

로그 전달 사용 안함

로그 전달 기능을 비활성화하려면 Fluent Bit 설명서 의 표준 절차를 따르세요. New Relic에서는 다른 작업을 수행할 필요가 없습니다.

Copyright © 2022 New Relic Inc.