Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 5. Aggregating Container Logs

5.1. Overview
링크 복사

As an OpenShift administrator, you may want to view the logs from all containers in one user interface. The currently supported method for aggregating container logs in OpenShift Enterprise is using a centralized file system. Additional supported methods are planned for inclusion in future releases.

Note

As packaging improvements are made, these instructions will be simplified.

5.2. Using a Centralized File System
링크 복사

This method reads all container logs and forwards them to a central server for storage on the file system.

5.2.1. Installing fluentd (td-agent) on Nodes
링크 복사

Perform the following steps on each node to install and configure fluentd (td-agent):

  1. Run the following commands: 

    # export RPM=td-agent-2.2.0-0.x86_64.rpm
# curl https://packages.treasuredata.com/2/redhat/7/x86_64/$RPM \
    -o /tmp/$RPM
# yum localinstall /tmp/$RPM
# /opt/td-agent/embedded/bin/gem install fluent-plugin-kubernetes
# mkdir -p /etc/td-agent/config.d
# chown td-agent:td-agent /etc/td-agent/config.d
    Copy to Clipboard Toggle word wrap

  2. Create a directory to house the logs: 

    # mkdir -p /var/log/td-agent/tmp
# chown td-agent:td-agent /var/log/td-agent/tmp
    Copy to Clipboard Toggle word wrap

    To allow td-agent access to the containers logs, create the /etc/sysconfig/td-agent file and ensure it contains the following: 

    DAEMON_ARGS=
TD_AGENT_ARGS="/usr/sbin/td-agent --log /var/log/td-agent/td-agent.log --use-v1-config"
    Copy to Clipboard Toggle word wrap

  3. Add the following line to the /etc/td-agent/td-agent.conf file: 

      @include config.d/*.conf
    Copy to Clipboard Toggle word wrap

  4. Create the /etc/td-agent/config.d/kubernetes.conf file with the following contents: 

        <source>
      type tail
      path /var/lib/docker/containers/*/*-json.log
      pos_file /var/log/td-agent/tmp/fluentd-docker.pos
      time_format %Y-%m-%dT%H:%M:%S
      tag docker.*
      format json
      read_from_head true
    </source>

    <match docker.var.lib.docker.containers.*.*.log>
      type kubernetes
      container_id ${tag_parts[5]}
      tag docker.${name}
    </match>

    <match kubernetes>
      type copy
      <store>
        type forward
        send_timeout 60s
        recover_wait 10s
        heartbeat_interval 1s
        phi_threshold 16
        hard_timeout 60s
        log_level trace
        require_ack_response true
        heartbeat_type tcp
        <server>
          name logging_name
    1 
    
          host host_name
    2 
    
          port 24224
          weight 60
        </server>

        <secondary>
          type file
          path /var/log/td-agent/forward-failed
        </secondary>
      </store>

      <store>
        type file
        path /var/log/td-agent/containers.log
        time_slice_format %Y%m%d
        time_slice_wait 10m
        time_format %Y%m%dT%H%M%S%z
        compress gzip
        utc
      </store>
    </match>
    Copy to Clipboard Toggle word wrap
    1
    The name for the master that will be used during logging.
    2
    The IP or a DNS resolvable name used to access the master.
  5. Enable fluentd: 
# systemctl enable td-agent
# systemctl start td-agent
Copy to Clipboard Toggle word wrap
Tip

Any errors are logged in the /var/log/td-agent/td-agent.log file.

5.2.2. Optional Method to Verify Working Nodes
링크 복사

You can optionally set up the master to be the aggregator to test and verify that the nodes are working properly.

  1. Install fluentd (td-agent) on the master: 

    # export RPM=td-agent-2.2.0-0.x86_64.rpm
# curl https://packages.treasuredata.com/2/redhat/7/x86_64/$RPM \
    -o /tmp/$RPM
# yum localinstall /tmp/$RPM
# mkdir -p /etc/td-agent/config.d
# chown td-agent:td-agent /etc/td-agent/config.d
    Copy to Clipboard Toggle word wrap
  2. Ensure port 24224 is open on the master’s firewall to allow the nodes access.

  3. Configure fluentd to aggregate container logs by adding the following line to the /etc/td-agent/td-agent.conf file: 

      @include config.d/*.conf
    Copy to Clipboard Toggle word wrap

  4. Create the /etc/td-agent/config.d/kubernetes.conf file with the following contents: 

        <match kubernetes.**>
        type file
        path /var/log/td-agent/containers.log
        time_slice_format %Y%m%d
        time_slice_wait 10m
        time_format %Y%m%dT%H%M%S%z
        compress gzip
        utc
    </match>
    Copy to Clipboard Toggle word wrap

  5. Enable fluentd: 

    # systemctl enable td-agent
# systemctl start td-agent
    Copy to Clipboard Toggle word wrap
    Tip

    Any errors are logged in the /var/log/td-agent/td-agent.log file.

You should now find all the containers' logs available on the master in the /var/log/td-agent/containers.log file.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat