로그 전달을 위한 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. 다음 명령을 실행하여 플러그인을 빌드합니다.

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

   카피

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

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 인스턴스를 다시 시작합니다.

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

   카피

Fluent Bit 플러그인 테스트

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

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

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

   카피

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

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

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

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

로그 데이터 확인

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

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

SELECT * FROM Log

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

다음 단계는?

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

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

로그 전달 비활성화

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