개요
- Foward
- 포워드
Forward는 Fluent Bit와 Fluentd에서 피어 간에 메시지를 라우팅하는 데 사용하는 프로토콜입니다. 이 플러그인은 Forward 메시지를 수신하는 입력 서비스를 구현합니다.
설정 파라미터
플러그인은 다음의 설정 파라미터를 지원합니다.
| 키 | 설명 | 기본값 |
|---|---|---|
| Listen | 리스너 네트워크 인터페이스. | 0.0.0.0 |
| Port | 들어오는 연결을 수신하는 TCP 포트 | 24224 |
| Unix_Path | Forward 메시지를 수신할 유닉스 소켓의 경로를 지정합니다. 설정된 경우 Listen과 Port는 무시됩니다.
|
|
| Unix_Perm | Unix 소켓 파일의 권한을 설정합니다. Unix_Path가 설정되지 않은 경우, 이 파라미터는 무시됩니다.
|
|
| Buffer_Max_Size | Forward 메시지를 수신하는 데 사용되는 최대 버퍼 메모리 크기를 지정합니다. 값은 단위 크기 사양을 따라야 합니다. | 6144000 |
| Buffer_Chunk_Size | 기본적으로 들어오는 Forward 메시지를 저장하는 버퍼는 허용되는 최대 메모리를 할당하지 않고 필요할 때 메모리를 할당합니다. 할당 라운드는 Buffer_Chunk_Size에 의해 설정됩니다. 값은 단위 크기 사양을 따라야 합니다. | 1024000 |
| Tag_Prefix | 수신 태그 앞에 정의된 값을 붙입니다. | |
| Tag | 정의된 값으로 전달된 이벤트의 태그를 재정의(override)합니다. |
시작하기
Forward 메시지를 받으려면 다음 예시에 표시된 대로 명령줄이나 설정 파일을 통해 플러그인을 실행할 수 있습니다.
명령줄
명령줄에서 다음 옵션을 사용하여 Fluent Bit가 Forward 메시지를 수신하도록 할 수 있습니다.
$ fluent-bit -i forward -o stdout
기본적으로 서비스는 TCP 포트 24224를 통해 모든 인터페이스(0.0.0.0)를 수신합니다. 선택적으로 이를 직접 변경할 수 있습니다.
$ fluent-bit -i forward -p listen="192.168.3.2" -p port=9090 -o stdout
이 예시에서 Forward 메시지는 192.168.3.2 주소와 TCP 포트 9090 아래의 네트워크 인터페이스를 통해서만 받게 됩니다.
설정 파일
메인 설정 파일에 다음과 같은 입력 및 출력 섹션을 추가합니다.
[INPUT]
Name forward
Listen 0.0.0.0
Port 24224
Buffer_Chunk_Size 1M
Buffer_Max_Size 6M
[OUTPUT]
Name stdout
Match *
테스트
Fluent Bit가 실행되면, fluent-cat 도구(이 도구는 Fluentd에서 제공합니다)를 사용하여 메시지를 보낼 수 있습니다.
$ echo '{"key 1": 123456789, "key 2": "abcdefg"}' | fluent-cat my_tag
Fluent Bit에서는 다음과 같은 출력이 표시됩니다.
$ bin/fluent-bit -i forward -o stdout
Fluent-Bit v0.9.0
Copyright (C) Treasure Data
[2016/10/07 21:49:40] [ info] [engine] started
[2016/10/07 21:49:40] [ info] [in_fw] binding 0.0.0.0:24224
[0] my_tag: [1475898594, {"key 1"=>123456789, "key 2"=>"abcdefg"}]