---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Fluentd
url: https://docs.influxdata.com/telegraf/v1/input-plugins/fluentd/
estimated_tokens: 1543
product: Telegraf
version: v1
---

-   Telegraf v1.4.0+

# 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.

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
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Fluentd Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/fluentd/README.md)