---
title: ''
description: Telegraf plugin for collecting metrics from Fluentd
url: https://docs.influxdata.com/telegraf/v1/input-plugins/fluentd/
estimated_tokens: 970
product: Telegraf Controller
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/fluentd/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.4.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.0/plugins/inputs/fluentd/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.0/plugins/inputs/fluentd/sample.conf)

# Fluentd Input Plugin

This plugin gathers internal metrics of a [fluentd](https://www.fluentd.org/) instance provided
by fluentd’s [monitor agent plugin](https://docs.fluentd.org/input/monitor_agent). Data provided
by the `/api/plugin.json` resource, `/api/config.json` is not covered.

> [!Important]
> This plugin might produce high-cardinality series as the `plugin_id` value is
> random after each restart of fluentd. You might need to adjust your fluentd
> configuration, in order to reduce series cardinality in case your fluentd
> restarts frequently by adding the `@id` parameter to each plugin.
> See [fluentd’s documentation](https://docs.fluentd.org/configuration/config-file#common-plugin-parameter) for details.

**Introduced in:** Telegraf v1.4.0**Tags:** server**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Read metrics exposed by fluentd in_monitor plugin
[[inputs.fluentd]]
  ## This plugin reads information exposed by fluentd (using /api/plugins.json endpoint).
  ##
  ## Endpoint:
  ## - only one URI is allowed
  ## - https is not supported
  endpoint = "http://localhost:24220/api/plugins.json"

  ## Define which plugins have to be excluded (based on "type" field - e.g. monitor_agent)
  exclude = [
    "monitor_agent",
    "dummy",
  ]
```

## Metrics

### Measurements & Fields

Fields may vary depending on the plugin type

* fluentd
  * retry\_count (float, unit)
  * buffer\_queue\_length (float, unit)
  * buffer\_total\_queued\_size (float, unit)
  * rollback\_count (float, unit)
  * flush\_time\_count (float, unit)
  * slow\_flush\_count (float, unit)
  * emit\_count (float, unit)
  * emit\_records (float, unit)
  * emit\_size (float, unit)
  * write\_count (float, unit)
  * buffer\_stage\_length (float, unit)
  * buffer\_queue\_byte\_size (float, unit)
  * buffer\_stage\_byte\_size (float, unit)
  * buffer\_available\_buffer\_space\_ratios (float, unit)

### Tags

* All measurements have the following tags:
  * plugin\_id (unique plugin id)
  * plugin\_type (type of the plugin e.g. s3)
    * plugin\_category (plugin category e.g. output)

## Example Output

```text
fluentd,host=T440s,plugin_id=object:9f748c,plugin_category=input,plugin_type=dummy buffer_total_queued_size=0,buffer_queue_length=0,retry_count=0 1492006105000000000
fluentd,plugin_category=input,plugin_type=dummy,host=T440s,plugin_id=object:8da98c buffer_queue_length=0,retry_count=0,buffer_total_queued_size=0 1492006105000000000
fluentd,plugin_id=object:820190,plugin_category=input,plugin_type=monitor_agent,host=T440s retry_count=0,buffer_total_queued_size=0,buffer_queue_length=0 1492006105000000000
fluentd,plugin_id=object:c5e054,plugin_category=output,plugin_type=stdout,host=T440s buffer_queue_length=0,retry_count=0,buffer_total_queued_size=0 1492006105000000000
fluentd,plugin_type=s3,host=T440s,plugin_id=object:bd7a90,plugin_category=output buffer_queue_length=0,retry_count=0,buffer_total_queued_size=0 1492006105000000000
fluentd,plugin_id=output_td, plugin_category=output,plugin_type=tdlog, host=T440s buffer_available_buffer_space_ratios=100,buffer_queue_byte_size=0,buffer_queue_length=0,buffer_stage_byte_size=0,buffer_stage_length=0,buffer_total_queued_size=0,emit_count=0,emit_records=0,flush_time_count=0,retry_count=0,rollback_count=0,slow_flush_count=0,write_count=0 1651474085000000000
```