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

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

Fluent Bit 로그를 뉴렐릭으로 전달하면 로그 데이터에 대한 수집, 처리, 탐색, 쿼리 및 알림하기 위한 향상된 로그 관리기능이 제공됩니다.

기본 프로세스

플러그인이 설치된 컨테이너가 게시되었습니다. 이 컨테이너는 쿠버네티스 통합에서 사용할 기본 이미지 역할을 합니다. 이 기본 이미지를 사용하고 고유한 커스텀 구성 파일을 계층화하길 권합니다.

Fluent Bit에서 뉴렐릭으로 로그를 전달하려면:

1. 다음 사항이 있는지 확인합니다.

   • 뉴렐릭

     라이선스 키

   • 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에서 뉴렐릭의 Fluent Bit 플러그인 리포지토리로 이동합니다. 2. 리포지토리 페이지에서 리포지토리를 복제하거나 다운로드합니다. 3. 다음 명령을 실행하여 플러그인을 빌드합니다.

   bash

   카피

   $
   cd newrelic-fluent-bit-output && make all

2. fluent-bit 데몬이 액세스할 수 있는 위치에 out_newrelic.so 또는 out_newrelic_winXX.dll을 저장합니다.

Fluent Bit 플러그인 업그레이드

Fluent Bit 플러그인을 업그레이드하기 전에, 다음 NRQL 쿼리를 실행하여 시스템에서 사용 중인 출력 플러그인의 현재 버전을 찾으십시오.

FROM K8sContainerSample 
    SELECT latest(containerImage) 
    WHERE podName like '%newrelic-logging%' 
    FACET clusterName

업그레이드하려면 설치 지침을 따르거나 GitHub 저장소에서 사전 컴파일된 최신 버전을 가져오십시오.

Fluent Bit 출력 플러그인 설치

뉴렐릭에는 사용자의 로그를 뉴렐릭 로그인 관리에 전달하기 위한 Fluent Bit 출력 플러그인이 있습니다. 이 플러그인은 DaemonSet 형태로 쿠버네티스 클러스터에 설치할 수 있는 독립 실행형 이미지로도 제공되며 쿠버네티스 플러그인이라고도 합니다.

두 가지 방법으로 Helm 차트를 사용하여 클러스터에 설치할 수 있습니다.

안내 설치 사용

newrelic-logging 차트는 독립적으로 작동하지만 nri-bundle 차트의 일부로 설치하는 것을 권장합니다.

가장 좋은 설치 방법은 안내 설치 프로세스를 따르는 것입니다. 이 안내 설치는 설치에 필요한 Helm 3 명령을 생성할 수 있습니다("Helm 3" 참조).

수동 설치

또는 Helm을 사용해 다음 명령을 실행하여 리포지터리를 수동 설치할 수 있습니다.

$
helm repo add newrelic https://helm-charts.newrelic.com

리포지터리를 업데이트하려면 다음을 실행할 수 있습니다.

$
helm repo update newrelic

제거 지침은 여기에서 확인할 수 있습니다.

Fluent Bit 플러그인 구성

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

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 파일 하단에 다음을 추가하여 입력, 필터, 출력 섹션을 설정합니다. 자리표시자 텍스트를 라이선스 키로 바꿉니다.

   [INPUT]
       Name tail
       Tag  my.tag
       Path /PATH/TO/YOUR/LOG/FILE
       
   # If you have multiple sources, just add another [INPUT] section like this:
   [INPUT] 
       Name tail 
       Tag  my.other.tag 
       Path /PATH/TO/SOME/OTHER/LOG/FILE 
   
   # Having multiple [FILTER] blocks allows you to control the flow of changes as they read top down. 
   [FILTER]
       Name modify
       # Here we only match on one tag, my.tag, defined in the [INPUT] section earlier
       Match  my.tag
       # Below, we're renaming the host.cpu attribute to CPU
       Rename host.cpu CPU
   
   [FILTER]
       Name   record_modifier
       # Match on all tags, *, so all logs get decorated per the Record clauses below. Record adds attributes + their values to each record.
       Match  *
       # Adding a logtype attribute ensures your logs will be automatically parsed by our built-in parsing rules
       Record logtype nginx
       # Add the server's hostname to all logs generated
       Record hostname ${HOSTNAME}
   
   [OUTPUT]
       Name       newrelic
       Match      *
       licenseKey YOUR_LICENSE_KEY

   카피

5. 다음 명령을 사용하여 Fluent Bit 인스턴스를 다시 시작합니다.

   bash

   카피

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

Fluent Bit 플러그인 테스트

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

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

   bash

   카피

   $
   echo "test message" >> /PATH/TO/YOUR/LOG/FILE

2. test message에 대한 로그 UI를 검색합니다.

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

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

Fluent Bit 플러그인을 설치하고 구성했으면 다음 속성을 사용하여 플러그인이 뉴렐릭에 데이터를 보내는 방법을 구성할 수 있습니다.

로그 데이터 확인

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

• 로그 UI
• NRQL 쿼리 실행을 위한 툴입니다.예를 들어 다음과 같은 쿼리를 실행할 수 있습니다.

SELECT * FROM Log

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

다음 단계는?

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

• 문맥적 로그 기능으로 로그를 전달하여 애플리케이션과 플랫폼 성능 데이터에 대한 더 깊은 가시성을 얻을 수 있습니다.
• 알림을 설정합니다.
• 데이터를 쿼리하고 대시보드를 만듭니다.

로그 전달 비활성화

로그 전달 기능을 비활성화하려면 Fluent Bit 문서에 포함된 표준 절차를 따르십시오. 뉴렐릭에서는 다른 작업을 수행할 필요가 없습니다.