Fluent Bit에서 이미 로그 데이터를 모니터링하고 있는 경우, Fluent Bit 출력 플러그인을 사용하여 뉴렐릭에서 로그 데이터를 전달하고 보강할 수 있습니다.
Fluent Bit 로그를 뉴렐릭으로 전달하면 로그 데이터를 수집, 처리, 탐색, 쿼리 및 알림 설정할 수 있는 향상된 로그 관리 역량을 확보할 수 있습니다.
기본 프로세스
플러그인이 설치된 컨테이너가 게시되었습니다. 이 컨테이너는 쿠버네티스 통합에서 사용할 기본 이미지 역할을 합니다. 이 기본 이미지를 사용하고 고유한 커스텀 구성 파일을 계층화하길 권합니다.
Fluent Bit에서 뉴렐릭으로 로그를 전달하려면:
다음 사항이 있는지 확인합니다.
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.sofluent-bit.conf
파일에서service
블록 아래에 다음 줄을 추가합니다.[SERVICE]# This is the main configuration block for fluent bit.# Ensure the follow line exists somewhere in the SERVICE blockPlugins_File plugins.conffluent-bit.conf
파일 하단에 다음을 추가하여 입력, 필터 및 출력 스탠자를 설정합니다.자리 표시자 텍스트를 로 교체합니다.[INPUT]Name tailTag my.tagPath /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 earlierMatch my.tag# below, we're renaming the host.cpu attribute to CPURename 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 rulesRecord logtype nginx# add the server's hostname to all logs generatedRecord hostname ${HOSTNAME}[OUTPUT]Name newrelicMatch *licenseKey YOUR_LICENSE_KEY# OptionalmaxBufferSize 256000maxRecords 1024다음 명령을 사용하여 Fluent Bit 인스턴스를 다시 시작합니다.
fluent-bit -c /PATH/TO/fluent-bit.conf
이 문서가 설치하는데 도움이 되셨나요?
Fluent Bit 플러그인 테스트
Fluent Bit 플러그인이 로그 파일에서 입력을 수신하는지 테스트하려면:
다음 명령을 실행하여 테스트 로그 메시지를 로그 파일에 추가합니다.
echo "test message" >> /PATH/TO/YOUR/LOG/FILEtest message
에 대한 뉴렐릭의 Logs UI를 검색합니다.
더 많은 옵션은 Fluent Bit 수정 필터 문서와 인프라 에이전트를 사용한 로그 전달 문서를 참조하십시오.
선택 사항: 플러그인 속성 구성
Fluent Bit 플러그인을 설치하고 구성했으면 다음 속성을 사용하여 플러그인이 뉴렐릭에 데이터를 보내는 방법을 구성할 수 있습니다.
키 | 설명 |
---|---|
| . |
| 페이로드가 보낸 최대 크기(바이트)입니다. 기본: |
| 한 번에 보낼 최대 레코드 수입니다. 기본: |
| 더 이상 사용되지 않습니다. 뉴렐릭 Insights 삽입 키를 사용해도 되지만 |
로그 데이터 확인
모든 것이 올바르게 구성되고 데이터가 수집되는 경우 다음 두 위치에서 데이터 로그가 표시되어야 합니다.
- 뉴렐릭의 로그 UI
- NRQL 쿼리를 실행하기 위한 뉴렐릭의 툴. 예를 들어 다음과 같은 쿼리를 실행할 수 있습니다.
SELECT * FROM Log
로그 관리 기능을 활성화한 후에도 데이터가 나타나지 않으면 표준 로그 문제 해결 절차를 따르십시오.
다음 단계는?
로그 UI를 사용하여 플랫폼 전반에 걸쳐 로깅 데이터를 탐색합니다.
- 문맥적 로그 기능으로 로그를 전달하여 애플리케이션과 플랫폼 성능 데이터에 대한 더 깊은 가시성을 얻을 수 있습니다.
- 알림을 설정합니다.
- 데이터를 쿼리하고 대시보드를 만듭니다.
로그 전달 비활성화
로그 전달 기능을 비활성화하려면 Fluent Bit 문서에 포함된 표준 절차를 따르십시오. 뉴렐릭에서는 다른 작업을 수행할 필요가 없습니다.