Recommend adding #{File.dirname(element['pos_file'])} to the

Error message

Recommend adding #{File.dirname(element['pos_file'])} to the exclusion path of your antivirus software on Windows

What it means

Error "Recommend adding #{File.dirname(element['pos_file'])} to the exclusion path of your antivirus software on Windows" thrown in fluent/fluentd.

Source

Thrown at lib/fluent/supervisor.rb:835

      @system_config = build_system_config(@conf)

      # `<system> umask` sets the process umask, just like the `--umask` command
      # line option. The command line option takes precedence when both are given.
      if @system_config.umask && !@cl_opt.key?(:chumask)
        @chumask = @system_config.umask
      end

      $log.info :supervisor, 'parsing config file is succeeded', path: @config_path

      build_additional_configurations(parsed_files) do |additional_conf|
        @conf += additional_conf
      end

      if Fluent.windows?
        @conf.elements.each do |element|
          next unless element.name == 'source'
          if element['@type'] == 'tail' && element['pos_file']
            $log.warn("Recommend adding #{File.dirname(element['pos_file'])} to the exclusion path of your antivirus software on Windows")
          else
            storage = element.elements.find { |v| v.name == 'storage' and v['@type'] == 'local' }
            if storage
              $log.warn("Recommend adding #{File.dirname(storage['path'])} to the exclusion path of your antivirus software on Windows")
            end
          end
        end
      end

      @libs.each do |lib|
        require lib
      end

      @plugin_dirs.each do |dir|
        if Dir.exist?(dir)
          dir = File.expand_path(dir)
          Fluent::Plugin.add_plugin_dir(dir)
        end

View on GitHub (pinned to dd45c6e18d)

When it happens

Trigger: Thrown at lib/fluent/supervisor.rb:835 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of fluent/fluentd@dd45c6e18d (2026-08-21). Data as JSON: /api/errors/395925fc5530b9e6. Report an issue: GitHub.