# Docker Events

The **docker events** input plugin uses the docker API to capture server events. A complete list of possible events returned by this plugin can be found [here](https://docs.docker.com/engine/reference/commandline/events/)

## Configuration Parameters

This plugin supports the following configuration parameters:

| Key                       | Description                                                                                                                         | Default              |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| Unix\_Path                | The docker socket unix path                                                                                                         | /var/run/docker.sock |
| Buffer\_Size              | The size of the buffer used to read docker events (in bytes)                                                                        | 8192                 |
| Parser                    | Specify the name of a parser to interpret the entry as a structured message.                                                        | None                 |
| Key                       | When a message is unstructured (no parser applied), it's appended as a string under the key name *message*.                         | message              |
| Reconnect.Retry\_limits   | The maximum number of retries allowed. The plugin tries to reconnect with docker socket when EOF is detected.                       | 5                    |
| Reconnect.Retry\_interval | The retrying interval. Unit is second.                                                                                              | 1                    |
| Threaded                  | Indicates whether to run this input in its own [thread](https://docs.fluentbit.io/manual/3.2/administration/multithreading#inputs). | `false`              |

### Command Line

```bash
$ fluent-bit -i docker_events -o stdout
```

### Configuration File

In your main configuration file append the following **Input** & **Output** sections:

{% tabs %}
{% tab title="fluent-bit.conf" %}

```yaml
[INPUT]
    Name   docker_events

[OUTPUT]
    Name   stdout
    Match  *
```

{% endtab %}

{% tab title="fluent-bit.yaml" %}

```yaml
pipeline:
    inputs:
        - name: docker_events

    outputs:
        - name: stdout
          match: '*'
```

{% endtab %}
{% endtabs %}