본문으로 건너뛰기

Fluentd

정보

설치 가이드 문서는 별도로 분리되어 있습니다.

References

Fluentd​

https://kubesphere.io/blogs/deep-dive-into-kubernetes-logging/

설정​

Input -> filter 1 -> ... -> filter N -> Output
  • <source>: 어떤 정보를 입력받을지 설정
    • @type이 필수 입니다.
  • <filter <tag pattern>>: 발생한 이벤트를 어떻게 처리할지 설정
  • <match <tag pattern>>: 처리된 값을 어떻게 사용할지 설정
  • <system>: 시스템 설정
  • <label>: 내부 라우팅을 위해 필터와 출력 그룹 설정
  • @include path|glob|url: 다른 설정파일 호출
경고

filter와 match는 선언 순서가 중요합니다. match 지시문의 패턴에 걸린 경우 그 다음 선언된 지시문은 실행되지 않습니다.

Tag pattern​

  • tag는 .으로 구분 됩니다.
  • *: 태그 한 파트에 대한 glob입니다.
    • a.*는 a.b, a.c와 매치되지만 a, a.b.c는 매치되지 않습니다.
  • **: 태그 0 개 이상 파트에 대한 glob입니다.
    • a.**는 a, a.b, a.b.c 등과 매치됩니다.
  • {X, Y}: X 또는 Y입니다.
    • a.{b, c} {a, b.*} 등으로 사용할 수 있습니다.
  • /regex/
  • #{...}: ruby 표현식으로 문자열을 나타낼 수 있습니다.

Common Parameters​


  • @type: 사용할 플러그인
  • @id: 식별자
  • @log_level
  • @label
경고

conf 파일을 수정하면 fluentd를 재시작 해주세요.

source(input)​

forward​

fluentd-values.yaml
kind: "Deployment"

service:
  ports:
    - name: "forwarder"
      protocol: TCP
      containerPort: 24224
# https://docs.fluentd.org/input/forward
<source>
    @type forward
    port 24224
    bind 0.0.0.0
</source>

buffer​

<buffer>
    flush_at_shutdown true
    flush_interval 10s
    flush_thread_count 4
    retry_max_interval 30s
</buffer>

output​

copy​

동일한 tag 패턴을 갖는 match는 먼저 선언된 것만 실행되기 때문에, 여러 output을 사용하고 싶다면 copy를 사용합니다.

<match pattern>
    @type copy
    <store>
        @type <output>
        ...
    </store>
    <store>
        @type <output>
        ...
    </store>
    <store>
        @type <output>
        ...
    </store>
</match>