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

### Command Line

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

### Configuration File

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

```yaml
[INPUT]
    Name   docker_events

[OUTPUT]
    Name   stdout
    Match  *
```