本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

fluent/fluentd-kubernetes-daemonset

自动构建

在Kubernetes集群中部署的Fluentd守护进程集，用于收集和处理节点日志。

67 收藏0 次下载activefluent镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Fluentd Kubernetes DaemonSet 镜像文档

镜像概述和主要用途

Fluentd Kubernetes DaemonSet 镜像是专为在Kubernetes集群中以DaemonSet方式部署Fluentd而设计的Docker镜像。Fluentd是一个开源的数据收集器，能够统一日志收集和处理流程，为Kubernetes集群提供集中式日志管理解决方案。

该镜像旨在简化Fluentd在Kubernetes环境中的部署和配置，支持多种日志输出目的地，并针对容器化环境进行了优化。

核心功能和特性

多架构支持：提供x86_64和arm64架构的镜像
多种输出目的地：支持Elasticsearch、Kafka、S3、Azure Blob、CloudWatch等多种日志存储和分析平台
Kubernetes原生集成：自动收集容器日志并附加Kubernetes元数据
灵活配置：通过环境变量和ConfigMap支持自定义配置
系统日志收集：支持收集系统日志和容器日志
监控支持：内置Prometheus指标导出功能
多格式解析：支持JSON、CRI（containerd/cri-o）等多种日志格式解析

使用场景和适用范围

Kubernetes集群日志收集：在Kubernetes集群中部署为DaemonSet，收集所有节点上的容器日志
集中式日志管理：将分散在多个容器和节点的日志集中发送到指定存储或分析平台
日志转发：将日志转发到Elasticsearch、Kafka、S3等后端系统
日志处理与转换：对原始日志进行解析、过滤和转换
混合云环境日志统一：在混合云或多云Kubernetes环境中实现统一日志收集

支持的标签和架构

Debian 版本

当前稳定版

自v1.17.0起，容器镜像构建流程已从hub.docker.com的自动构建迁移到GitHub Actions。这是因为hub.docker.com对自动构建数量有限制，而GitHub Actions则没有构建流水线数量的限制。

注意：v1.16.5或更早版本的DaemonSet镜像存在一些限制：

papertrail、syslog镜像（x86_64/arm64）不再发布

logentries、loggly、logzio、s3的arm64镜像不再发布（仅支持x86_64）如果需要使用上述未发布的镜像，请自行构建。Dockerfile仍在本仓库中维护。

多架构镜像

Azureblob
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-azureblob-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-azureblob-1
Elasticsearch8
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-elasticsearch8-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-elasticsearch8-1
Elasticsearch7
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-elasticsearch7-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-elasticsearch7-1
- docker pull fluent/fluentd-kubernetes-daemonset:v1-debian-elasticsearch
Opensearch
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-opensearch-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-opensearch-1
Loggly
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-loggly-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-loggly-1
Logentries
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-logentries-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-logentries-1
Cloudwatch
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-cloudwatch-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-cloudwatch-1
S3
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-s3-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-s3-1
Syslog
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-syslog-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-syslog-1
Forward
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-forward-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-forward-1
Gcs
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-gcs-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-gcs-1
Graylog
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-graylog-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-graylog-1
Papertrail
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-papertrail-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-papertrail-1
Logzio
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-logzio-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-logzio-1
Kafka
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-kafka-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-kafka-1
Kafka2
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-kafka2-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-kafka2-1
Kinesis
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-kinesis-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-kinesis-1
Datadog
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-datadog-1.1
- docker pull fluent/fluentd-kubernetes-daemonset:v1.19-debian-datadog-1

x86_64 架构镜像

各输出目的地的x86_64镜像标签格式为：v{版本}-debian-{目的地}-amd64-{修订号}，例如：

docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-elasticsearch8-amd64-1.1

arm64 架构镜像

各输出目的地的arm64镜像标签格式为：v{版本}-debian-{目的地}-arm64-{修订号}，例如：

docker pull fluent/fluentd-kubernetes-daemonset:v1.19.0-debian-elasticsearch8-arm64-1.1

详细使用方法和配置说明

基础配置

使用环境变量配置

该镜像支持通过环境变量进行基本配置：

环境变量	描述	默认值
`FLUENT_UID`	运行Fluentd的用户ID	`1000`
`FLUENT_CONTAINER_TAIL_PATH`	容器日志文件路径	`/var/log/containers/*.log`
`FLUENT_CONTAINER_TAIL_EXCLUDE_PATH`	排除的日志文件路径	无
`FLUENTD_SYSTEMD_CONF`	是否启用systemd日志收集	`enable`
`FLUENTD_PROMETHEUS_CONF`	是否启用Prometheus指标	`enable`
`FLUENT_POS_EXTRA_DIR`	额外的pos文件目录	无
`LD_PRELOAD`	预加载的库	无

权限设置

在Kubernetes默认配置下，Fluentd需要root权限才能读取/var/log目录下的日志并写入pos文件。可以通过设置环境变量FLUENT_UID=0来以root用户运行：

env:
  - name: FLUENT_UID
    value: "0"

高级配置

使用自定义配置

虽然镜像提供了默认配置，但用户可以通过Kubernetes ConfigMap来自定义配置。每个镜像包含以下配置文件：

fluent.conf: 目的地设置（Elasticsearch、Kafka等）
kubernetes.conf: Kubernetes特定设置，包括日志文件tail输入和元数据过滤
tail_container_parse.conf: 容器日志解析器配置
prometheus.conf: Prometheus监控插件配置
systemd.conf: systemd日志收集配置

可以通过ConfigMap覆盖这些配置文件，例如：

apiVersion: v1
kind: ConfigMap
metadata:
  name: fluentd-config
  namespace: kube-system
data:
  fluent.conf: |
    # 自定义输出配置
    <match **>
      @type elasticsearch
      host elasticsearch-master
      port 9200
      logstash_format true
      logstash_prefix fluentd
      include_tag_key true
      tag_key @log_name
      flush_interval 5s
    </match>
  tail_container_parse.conf: |
    <parse>
      @type cri
    </parse>

然后在DaemonSet中挂载此ConfigMap：

volumeMounts:
  - name: config-volume
    mountPath: /fluentd/etc/fluent.conf
    subPath: fluent.conf
  - name: config-volume
    mountPath: /fluentd/etc/tail_container_parse.conf
    subPath: tail_container_parse.conf
volumes:
  - name: config-volume
    configMap:
      name: fluentd-config

使用CRI解析器处理containerd/cri-o日志

默认情况下，镜像使用json解析器处理Docker格式的日志。对于使用containerd或cri-o的集群，需要使用cri解析器：

env:
  - name: FLUENT_CONTAINER_TAIL_PARSER_TYPE
    value: "cri"

或者通过ConfigMap覆盖tail_container_parse.conf：

<parse>
  @type cri
</parse>

排除特定容器日志

可以通过FLUENT_CONTAINER_TAIL_EXCLUDE_PATH环境变量排除特定日志：

env:
  - name: FLUENT_CONTAINER_TAIL_EXCLUDE_PATH
    value: '["/var/log/containers/fluentd-*", "/var/log/containers/kube-*"]'

启用jemalloc内存分配器

自v1.17.0-1.3/v1.16.5-1.3版本起，jemalloc内存分配器默认禁用。如果不使用systemd插件，可以通过以下方式启用：

env:
  - name: LD_PRELOAD
    value: "/usr/lib/libjemalloc.so.2"

禁用systemd输入

如果不需要收集systemd日志，可以通过环境变量禁用：

env:
  - name: FLUENTD_SYSTEMD_CONF
    value: "disable"

禁用Prometheus监控

如果不需要Prometheus监控，可以通过环境变量禁用：

env:
  - name: FLUENTD_PROMETHEUS_CONF
    value: "disable"

Kubernetes部署示例

DaemonSet部署示例（Elasticsearch输出）

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: fluentd-elasticsearch
  namespace: kube-system
  labels:
    k8s-app: fluentd-logging
spec:
  selector:
    matchLabels:
      name: fluentd-elasticsearch
  template:
    metadata:
      labels:
        name: fluentd-elasticsearch
    spec:
      tolerations:
      - key: node-role.kubernetes.io/master
        effect: NoSchedule
      containers:
      - name: fluentd-elasticsearch
        image: fluent/fluentd-kubernetes-daemonset:v1.19-debian-elasticsearch7-1
        resources:
          limits:
            memory: 200Mi
          requests:
            cpu: 100m
            memory: 200Mi
        env:
        - name: FLUENT_UID
          value: "0"
        - name: FLUENT_ELASTICSEARCH_HOST
          value: "elasticsearch-master"
        - name: FLUENT_ELASTICSEARCH_PORT
          value: "9200"
        - name: FLUENT_ELASTICSEARCH_SCHEME
          value: "http"
        - name: FLUENTD_SYSTEMD_CONF
          value: "disable"
        volumeMounts:
        - name: varlog
          mountPath: /var/log
        - name: varlibdockercontainers
          mountPath: /var/lib/docker/containers
          readOnly: true
      volumes:
      - name: varlog
        hostPath:
          path: /var/log
      - name: varlibdockercontainers
        hostPath:
          path: /var/lib/docker/containers

部署RBAC权限

apiVersion: v1
kind: ServiceAccount
metadata:
  name: fluentd-elasticsearch
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: fluentd-elasticsearch
rules:
- apiGroups: [""]
  resources:
  - namespaces
  - pods
  verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: fluentd-elasticsearch
subjects:
- kind: ServiceAccount
  name: fluentd-elasticsearch
  namespace: kube-system
roleRef:
  kind: ClusterRole
  name: fluentd-elasticsearch
  apiGroup: rbac.authorization.k8s.io

在OpenShift上部署

oc project kube-system
oc create -f [***]
oc adm policy add-scc-to-user privileged -z fluentd
oc patch ds fluentd -p "spec:
  template:
    spec:
      containers:
      - name: fluentd
        securityContext:
          privileged: true"
oc delete pod -l k8s-app=fluentd-logging

注意事项

多Fluentd实例部署

当在同一集群中部署多个Fluentd实例（例如需要将日志发送到多个目的地），需要设置FLUENT_POS_EXTRA_DIR环境变量来指定额外的pos文件目录，避免pos文件冲突：

env:
  - name: FLUENT_POS_EXTRA_DIR
    value: "/var/log/fluentd-pos-extra"

Kafka镜像不支持Zookeeper参数

由于Debian 10上的Zookeeper gem存在兼容性问题，Kafka镜像不包含Zookeeper gem。

Windows Kubernetes支持

本仓库不提供Windows Kubernetes DaemonSet支持，但有社区用户提供了相关实现：

[***]
[***]

Kafka镜像建议

推荐使用debian-kafka2或debian-kafka2-arm64镜像，这些镜像使用out_kafka2插件，而debian-kafka或debian-kafka-arm64使用已弃用的out_kafka_buffered插件。

维护者信息

部分镜像由社区贡献者维护，如遇特定镜像问题，请联系相应维护者：

azureblob: @elsesiy
papertrail

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

fluentd-kubernetes-daemonset Docker 镜像下载 - 轩辕镜像

fluentd-kubernetes-daemonset 镜像详细信息和使用指南

fluentd-kubernetes-daemonset 镜像标签列表和版本信息

fluentd-kubernetes-daemonset 镜像拉取命令和加速下载

fluentd-kubernetes-daemonset 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

fluentd-kubernetes-daemonset 镜像详细信息

fluentd-kubernetes-daemonset 镜像标签列表

fluentd-kubernetes-daemonset 镜像使用说明

fluentd-kubernetes-daemonset 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南