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

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

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

기본 프로세스

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

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

다음 사항이 있는지 확인합니다.
- New Relic
- Fluent Bit 1.0 이상(권장), v0.12 이상
- Fluent Bit Windows 설치 지침은 여기에서 찾을 수 있습니다.
- Fluent Bit Linux 설치 지침은 여기에서 찾을 수 있습니다.
Fluent Bit 플러그인을 설치합니다.
Fluent Bit 플러그인을 구성합니다.
Fluent Bit 플러그인을 테스트합니다.
트래픽을 생성하고 몇 분 정도 기다린 다음, 계정에서 데이터를 확인합니다.

Fluent Bit 플러그인 설치

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

GitHub에서 뉴렐릭의 Fluent Bit 플러그인 리포지토리로 이동합니다.
리포지토리 페이지에서 리포지토리를 복제하거나 다운로드합니다.
다음 명령을 실행하여 플러그인을 빌드합니다.

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

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

팁

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

Fluent Bit 플러그인 구성

Fluent Bit는 뉴렐릭플러그인과 뉴렐릭의 위치를 알아야 합니다. 데이터를 뉴렐릭으로 출력합니다. Fluent Bit 플러그인을 구성하려면:

중요

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

플러그인 디렉터리에서 plugins.conf 파일을 찾거나 생성합니다.
plugins.conf 파일에서 fluent-bit.conf 파일 옆에 out_newrelic.so에 대한 참조를 추가합니다.
```
[PLUGINS]
    Path /PATH/TO/newrelic-fluent-bit-output/out_newrelic.so
```

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

fluent-bit.conf 파일 하단에 다음을 추가하여 입력, 필터, 출력 섹션을 설정합니다. 자리표시자 텍스트를 로 교체합니다.

[INPUT]
    Name tail
    Tag my.tag
    Path /PATH/TO/YOUR/LOG/FILE

# having multiple [FILTER] blocks allows one 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

다음 명령을 사용하여 Fluent Bit 인스턴스를 다시 시작합니다.
```
fluent-bit -c /PATH/TO/fluent-bit.conf
```

이 문서가 설치에 도움이 되었습니까?

Fluent Bit 플러그인 테스트

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

다음 명령을 실행하여 테스트 로그 메시지를 로그 파일에 추가합니다.
```
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
```
test message에 대한 로그 UI를 검색합니다.

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

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

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

키	설명
`licenseKey`	. `licenseKey`(권장됨) 또는`apiKey` 중 하나만 사용합니다. 기본값: `none`
`maxBufferSize`	페이로드가 보낸 최대 크기(바이트)입니다. 기본: `256000`
`maxRecords`	한 번에 보낼 최대 레코드 수입니다. 기본: `1024`
`apiKey`	더 이상 사용되지 않습니다. 뉴렐릭 Insights 삽입 키를 사용해도 되지만 `licenseKey` 속성을 사용하는 것을 권합니다. `licenseKey` 또는 `apiKey` 중 하나를 사용하고, 둘 다 사용하지는 마십시오.

로그 데이터 확인

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

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

SELECT * FROM Log

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

다음 단계는?

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

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

로그 전달 비활성화

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