---
title: Fluent Bit (Agent)
description: Collect Fluent Bit internal metrics for each running plugin.
breadcrumbs: Docs > Integrations > Fluent Bit (Agent)
---

# Fluent Bit (Agent)
Supported OS Integration version1.0.3
## Overview{% #overview %}

This check monitors [Fluent Bit](https://fluentbit.io) metrics through the Datadog Agent. To send logs to Datadog with Fluent Bit and to learn about the Datadog Fluent Bit output plugin, see the [Fluent Bit](https://docs.datadoghq.com/logs/guide/fluentbit.md) documentation.

## Fluent Bit configuration{% #fluent-bit-configuration %}

Fluent Bit doesn't expose its internal metrics by default. You need to enable the built-in HTTP server that exposes the metrics endpoint.

```
[SERVICE]
    http_server on
```

See the official [documentation](https://docs.fluentbit.io/manual/administration/monitoring) for more information.

## Setup{% #setup %}

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates](https://docs.datadoghq.com/agent/kubernetes/integrations.md) for guidance on applying these instructions.

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the Fluent Bit check on your host. See [Use Community Integrations](https://app.datadoghq.com/account/settings/agent/latest) to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   ```shell
   datadog-agent integration install -t datadog-fluentbit==<INTEGRATION_VERSION>
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/agent/kubernetes/integrations.md).

### Configuration{% #configuration %}

1. Edit the `fluentbit.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your fluentbit performance data.

   ```yaml
   init_config:
   
   instances:
       ## @param metrics_endpoint - string - required
       ## The URL to Fluent Bit internal metrics per loaded plugin in Prometheus format.
       #
     - metrics_endpoint: http://127.0.0.1:2020/api/v1/metrics/prometheus
   ```

See the [sample fluentbit.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/fluentbit/datadog_checks/fluentbit/data/conf.yaml.example) file for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `fluentbit` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **fluentbit.input.records.count**(count)           | Number of records processed by the input.*Shown as entry*                                      |
| **fluentbit.input.bytes.count**(count)             | Number of bytes processed by the input.*Shown as byte*                                         |
| **fluentbit.filter.add\_records.count**(count)     | Number of records added by the filter.*Shown as entry*                                         |
| **fluentbit.filter.drop\_records.count**(count)    | Number of records dropped by the filter.*Shown as entry*                                       |
| **fluentbit.output.proc\_records.count**(count)    | Number of records processed by the output.*Shown as entry*                                     |
| **fluentbit.output.proc\_bytes.count**(count)      | Number of bytes processed by the output.*Shown as byte*                                        |
| **fluentbit.output.errors.count**(count)           | Number of errors in the output.*Shown as error*                                                |
| **fluentbit.output.retries.count**(count)          | Number of retries in the output.*Shown as attempt*                                             |
| **fluentbit.output.retries\_failed.count**(count)  | Number of abandoned batches because the maximum number of retries was reached.*Shown as error* |
| **fluentbit.output.retried\_records.count**(count) | Number of records retried by the output.*Shown as entry*                                       |
| **fluentbit.output.dropped\_records.count**(count) | Number of records dropped by the output.*Shown as entry*                                       |
| **fluentbit.build\_info**(gauge)                   | Value is always 1. Release version and type are included as tags.                              |

### Events{% #events %}

The Fluent Bit integration does not include any events.

### Service Checks{% #service-checks %}

The Fluent Bit integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).