# Logger

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [cloud-data-platform-full.txt](https://docs.redpanda.com/cloud-data-platform-full.txt)

---
title: Logger
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
latest-redpanda-tag: v26.1.9
docname: connect/components/logger/about
page-component-name: cloud-data-platform
page-version: master
page-component-version: master
page-component-title: Cloud
page-relative-src-path: connect/components/logger/about.adoc
page-edit-url: https://github.com/redpanda-data/cloud-docs/edit/main/modules/develop/pages/connect/components/logger/about.adoc
page-git-created-date: "2024-09-09"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/cloud-data-platform/develop/connect/components/logger/about.md -->

Redpanda Connect logging prints to stdout (or stderr if your output is stdout) and is formatted as [logfmt](https://brandur.org/logfmt) by default. Use these configuration options to change both the logging formats as well as the destination of logs.

#### Common

```yaml
# Common config fields, showing default values
logger:
  level: INFO
  format: logfmt
  add_timestamp: false
  static_fields:
    '@service': redpanda-connect
```

#### Advanced

```yaml
# All config fields, showing default values
logger:
  level: INFO
  format: logfmt
  add_timestamp: false
  level_name: level
  timestamp_name: time
  message_name: msg
  static_fields:
    '@service': redpanda-connect
  file:
    path: ""
    rotate: false
    rotate_max_age_days: 0
```

## [](#fields)Fields

The schema of the `logger` section is as follows:

### [](#level)`level`

Set the minimum severity level for emitting logs.

**Type**: `string`

**Default**: `"INFO"`

Options: `OFF` , `FATAL` , `ERROR` , `WARN` , `INFO` , `DEBUG` , `TRACE` , `ALL` , `NONE`

### [](#format)`format`

Set the format of emitted logs.

**Type**: `string`

**Default**: `"logfmt"`

Options: `json` , `logfmt`

### [](#add_timestamp)`add_timestamp`

Whether to include timestamps in logs.

**Type**: `bool`

**Default**: `false`

### [](#level_name)`level_name`

The name of the level field added to logs when the `format` is `json`.

**Type**: `string`

**Default**: `"level"`

### [](#timestamp_name)`timestamp_name`

The name of the timestamp field added to logs when `add_timestamp` is set to `true` and the `format` is `json`.

**Type**: `string`

**Default**: `"time"`

### [](#message_name)`message_name`

The name of the message field added to logs when the `format` is `json`.

**Type**: `string`

**Default**: `"msg"`

### [](#static_fields)`static_fields`

A map of key/value pairs to add to each structured log.

**Type**: `object`

**Default**: `{"@service":"redpanda-connect"}`

### [](#file)`file`

Experimental: Specify fields for optionally writing logs to a file.

**Type**: `object`

### [](#file-path)`file.path`

The file path to write logs to, if the file does not exist it will be created. Leave this field empty or unset to disable file based logging.

**Type**: `string`

**Default**: `""`

### [](#file-rotate)`file.rotate`

Whether to rotate log files automatically.

**Type**: `bool`

**Default**: `false`

### [](#file-rotate_max_age_days)`file.rotate_max_age_days`

The maximum number of days to retain old log files based on the timestamp encoded in their filename, after which they are deleted. Setting to zero disables this mechanism.

**Type**: `int`

**Default**: `0`