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

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

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

기본 프로세스

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

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

다음 사항이 있는지 확인하십시오.
- A 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에서 New Relic의 Fluent Bit 플러그인 저장소로 이동합니다.
리포지토리 페이지에서 리포지토리를 복제하거나 다운로드합니다 .
다음 명령을 실행하여 플러그인을 빌드합니다.

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

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

팁

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

Fluent Bit 플러그인 구성

Fluent Bit는 New Relic 플러그인의 위치와 New Relic 라이센스 키를 알아야 New Relic에 데이터를 출력할 수 있습니다. 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 파일 하단에 다음을 추가하여 입력 및 출력 필터를 설정합니다. 자리 표시자 텍스트를 New Relic 라이선스 키로 교체합니다.

[INPUT]
    Name tail
    Path /PATH/TO/YOUR/LOG/FILE

[OUTPUT]
    Name newrelic
    Match *
    licenseKey YOUR_LICENSE_KEY

# Optional
maxBufferSize 256000
maxRecords 1024

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

Fluent Bit 플러그인 테스트

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

다음 명령을 실행하여 테스트 로그 메시지를 로그 파일에 추가합니다.
```
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
```
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` 둘 다 사용하지 마십시오.

로그 데이터 보기

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

New Relic의 로그 UI
NRQL 조회를 실행하는 새 도구. 예를 들어, 다음과 같은 쿼리를 실행할 수 있습니다.

SELECT * FROM Log

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

다음은 뭐지?

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

컨텍스트에서 로그 기능을 사용하여 로그를 전달하여 애플리케이션 및 플랫폼 성능 데이터 모두에 대한 가시성을 확보하십시오.
경보를 설정하십시오.
데이터를 조회 하고 대시보드를 작성하십시오.

로그 전달 사용 안함

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

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