Fluentd 에서 이미 로그 데이터를 모니터링하고 있다면 Fluentd 통합을 사용하여 New Relic에서 로그 데이터를 전달하고 강화할 수 있습니다.
Fluentd 로그를 New Relic으로 전달하면 로그 데이터를 수집, 처리, 탐색, 쿼리 및 경고할 수 있는 향상된 로그 관리 기능이 제공됩니다.
기본 프로세스
로그 관리 기능을 활성화하려면:
- 다음 사항이 있는지 확인하십시오.
- A New Relic 라이센스 키
- Fluentd 1.0 이상
- Fluentd 플러그인을 설치 합니다.
- Fluentd 플러그인을 구성 합니다.
- 해당하는 경우 EU 끝점 구성
- Fluentd 플러그인을 테스트 합니다.
- 일부 트래픽을 생성하고 몇 분 동안 대기한 다음 데이터에 대해 계정을 확인 하십시오.
Fluentd 플러그인 설치
Fluentd 플러그인을 설치하려면:
Fluentd 플러그인 구성
팁
Fluentd를 처음 구성하는 경우 일반적인 사용 사례를 다루는 사전 빌드된 구성 파일 모음을 검토하는 것이 도움이 될 수 있습니다.
Fluentd 플러그인을 구성하려면:
fluent.conf
파일에서 또는 td-agent를 사용하는 경우td-agent.conf
에서 다음 데이터 블록을 추가하고 자리 표시자 텍스트를 New Relic 라이선스 키로 대체합니다.
#Tail one or more log files
<source>
@type tail
<parse>
@type none
</parse>
path /path/to/file
tag example.service
</source>
#Add hostname and service_name to all events with "example.service" tag
<filter example.service>
@type record_transformer
<record>
service_name ${tag}
hostname "#{Socket.gethostname}"
</record>
</filter>
#Forward all events to New Relic
<match **>
@type newrelic
license_key YOUR_LICENSE_KEY
</match>
- Fluentd 서비스를 다시 시작하여 변경 사항이 적용되었는지 확인하십시오.
EU 계정용 Fluentd 플러그인 구성
기본적으로 Fluentd 플러그인은 로그를 New Relic의 미국 엔드포인트 https://log-api.newrelic.com/log/v1
로 전달합니다. 계정이 New Relic의 EU 데이터 센터 에 있는 경우 base_uri
속성을 EU 엔드포인트로 수동으로 설정해야 합니다. 예를 들어:
#Tail one or more log files
<source>
@type tail
<parse>
@type none
</parse>
path /path/to/file
tag example.service
</source>
#Add hostname and service_name to all events with "example.service" tag
<filter example.service>
@type record_transformer
<record>
service_name ${tag}
hostname "#{Socket.gethostname}"
</record>
</filter>
#Forward all events to New Relic EU Endpoint
<match **>
@type newrelic
license_key YOUR_LICENSE_KEY
base_uri https://log-api.eu.newrelic.com/log/v1
</match>
Fluentd 플러그인 테스트
Fluentd 플러그인이 로그 파일에서 입력을 수신하는지 테스트하려면:
- 다음 명령을 실행하여 테스트 로그 메시지를 로그 파일에 추가합니다.
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
test message
에 대한 New Relic의 로그 UI 를 검색합니다.
로그 데이터 보기
모든 것이 올바르게 구성되고 데이터가 수집되는 경우 다음 두 위치에서 모두 로그가 표시되어야 합니다.
- New Relic의 로그 UI
- NRQL 조회를 실행하는 새 도구. 예를 들어, 다음과 같은 쿼리를 실행할 수 있습니다.
SELECT * FROM Log
로그 관리 기능을 활성화한 후에도 데이터가 나타나지 않으면 표준 로그 문제 해결 절차 를 따르십시오.
로그 Fluentd 버퍼 조정
기본적으로 플러그인은 5초마다 New Relic One에 로그를 보냅니다. 이 타이밍을 변경하려면 다음 예에 따라 구성에 <buffer>
블록을 추가하세요.
[...]
# Forward all events to New Relic EU Endpoint
<match **>
@type newrelic
license_key YOUR_LICENSE_KEY
<buffer time>
timekey 60s
</buffer>
</match>
자세한 내용 은 버퍼 구성에 대한 Fluentd 설명서를 참조하세요.
다음은 뭐지?
로그 UI 를 사용하여 플랫폼 전반에 걸쳐 로깅 데이터를 탐색하십시오.
- 컨텍스트에서 로그 기능을 사용하여 로그를 전달하여 애플리케이션 및 플랫폼 성능 데이터 모두에 대한 가시성을 확보하십시오.
- 경보를 설정하십시오.
- 데이터를 조회 하고 대시보드를 작성하십시오.
로그 전달 사용 안함
로그 전달 기능을 비활성화하려면 Fluentd 설명서 의 표준 절차를 따르세요. New Relic에서는 다른 작업을 수행할 필요가 없습니다.