# ltsv

The `ltsv` formatter plugin output an event as [LTSV](http://ltsv.org).

```
field1[label_delimiter]value1[delimiter]field2[label_delimiter]value2[newline]
```

## Parameters

* [Common Parameters](https://docs.fluentd.org/configuration/plugin-common-parameters)
* [Format section configurations](https://docs.fluentd.org/configuration/format-section)

### `delimiter`

| type   | default    | version |
| ------ | ---------- | ------- |
| string | `\t` (TAB) | 0.14.0  |

Delimiter for the fields.

### `label_delimiter`

| type   | default | version |
| ------ | ------- | ------- |
| string | `:`     | 0.14.0  |

Delimiter for the key-value field.

### `add_newline`

| type | default | version |
| ---- | ------- | ------- |
| bool | `true`  | 0.14.12 |

Adds `\n` to the result.

### `newline`

| type | default                                        | version |
| ---- | ---------------------------------------------- | ------- |
| enum | `lf (for non-Windows)` or `crlf (for Windows)` | 1.11.5  |

Specify newline characters.

### `replacement`

| type   | default      | version |
| ------ | ------------ | ------- |
| string | \`\` (SPACE) | 1.12.2  |

Safe replacement to substitute delimiters characters in records.

## Example

```
tag:    app.event
time:   1362020400
record: {"host":"192.168.0.1","size":777,"method":"PUT"}
```

This incoming event is formatted to:

In non-Windows:

```
host:192.168.0.1\tsize:777\tmethod:PUT\n
```

In Windows:

```
host:192.168.0.1\tsize:777\tmethod:PUT\r\n
```

If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation (CNCF)](https://cncf.io/). All components are available under the Apache 2 License.