# influxdb

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

---
title: influxdb
latest-connect-version: 4.93.0
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-redpanda-tag: v26.1.9
docname: metrics/influxdb
page-component-name: connect
page-version: master
page-component-version: master
page-component-title: Connect
page-relative-src-path: metrics/influxdb.adoc
page-edit-url: https://github.com/redpanda-data/rp-connect-docs/edit/main/modules/components/pages/metrics/influxdb.adoc
page-git-created-date: "2024-05-24"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/connect/components/metrics/influxdb.md -->

**Available in:** Self-Managed

Send metrics to InfluxDB 1.x using the `/write` endpoint.

Introduced in version 3.36.0.

#### Common

```yml
metrics:
  influxdb:
    url: "" # No default (required)
    db: "" # No default (required)
```

#### Advanced

```yml
metrics:
  influxdb:
    url: "" # No default (required)
    db: "" # No default (required)
    tls:
      enabled: false
      skip_cert_verify: false
      enable_renegotiation: false
      root_cas: ""
      root_cas_file: ""
      client_certs: []
    username: ""
    password: ""
    include:
      runtime: ""
      debug_gc: ""
    interval: 1m
    ping_interval: 20s
    precision: s
    timeout: 5s
    tags: {}
    retention_policy: "" # No default (optional)
    write_consistency: "" # No default (optional)
```

See [https://docs.influxdata.com/influxdb/v1.8/tools/api/#write-http-endpoint](https://docs.influxdata.com/influxdb/v1.8/tools/api/#write-http-endpoint) for further details on the write API.

## [](#fields)Fields

### [](#db)`db`

The name of the database to use.

**Type**: `string`

### [](#include)`include`

Optional additional metrics to collect, enabling these metrics may have some performance implications as it acquires a global semaphore and does `stoptheworld()`.

**Type**: `object`

### [](#include-debug_gc)`include.debug_gc`

A duration string indicating how often to poll and collect GC metrics. Leave empty to disable this metric.

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
debug_gc: 1m
```

### [](#include-runtime)`include.runtime`

A duration string indicating how often to poll and collect runtime metrics. Leave empty to disable this metric

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
runtime: 1m
```

### [](#interval)`interval`

A duration string indicating how often metrics should be flushed.

**Type**: `string`

**Default**: `1m`

### [](#password)`password`

A password (when applicable).

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

**Default**: `""`

### [](#ping_interval)`ping_interval`

A duration string indicating how often to ping the host.

**Type**: `string`

**Default**: `20s`

### [](#precision)`precision`

\[ns|us|ms|s\] timestamp precision passed to write api.

**Type**: `string`

**Default**: `s`

### [](#retention_policy)`retention_policy`

Sets the retention policy for each write.

**Type**: `string`

### [](#tags)`tags`

Global tags added to each metric.

**Type**: `string`

**Default**: `{}`

```yaml
# Examples:
tags:
  hostname: localhost
  zone: danger
```

### [](#timeout)`timeout`

How long to wait for response for both ping and writing metrics.

**Type**: `string`

**Default**: `5s`

### [](#tls)`tls`

Custom TLS settings can be used to override system defaults.

**Type**: `object`

### [](#tls-client_certs)`tls.client_certs[]`

A list of client certificates to use. For each certificate either the fields `cert` and `key`, or `cert_file` and `key_file` should be specified, but not both.

**Type**: `object`

**Default**: `[]`

```yaml
# Examples:
client_certs:
  - cert: foo
    key: bar

# ---

client_certs:
  - cert_file: ./example.pem
    key_file: ./example.key
```

### [](#tls-client_certs-cert)`tls.client_certs[].cert`

A plain text certificate to use.

**Type**: `string`

**Default**: `""`

### [](#tls-client_certs-cert_file)`tls.client_certs[].cert_file`

The path of a certificate to use.

**Type**: `string`

**Default**: `""`

### [](#tls-client_certs-key)`tls.client_certs[].key`

A plain text certificate key to use.

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

**Default**: `""`

### [](#tls-client_certs-key_file)`tls.client_certs[].key_file`

The path of a certificate key to use.

**Type**: `string`

**Default**: `""`

### [](#tls-client_certs-password)`tls.client_certs[].password`

A plain text password for when the private key is password encrypted in PKCS#1 or PKCS#8 format. The obsolete `pbeWithMD5AndDES-CBC` algorithm is not supported for the PKCS#8 format.

Because the obsolete pbeWithMD5AndDES-CBC algorithm does not authenticate the ciphertext, it is vulnerable to padding oracle attacks that can let an attacker recover the plaintext.

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
password: foo

# ---

password: ${KEY_PASSWORD}
```

### [](#tls-enable_renegotiation)`tls.enable_renegotiation`

Whether to allow the remote server to repeatedly request renegotiation. Enable this option if you’re seeing the error message `local error: tls: no renegotiation`.

Requires version 3.45.0 or later.

**Type**: `bool`

**Default**: `false`

### [](#tls-enabled)`tls.enabled`

Whether custom TLS settings are enabled.

**Type**: `bool`

**Default**: `false`

### [](#tls-root_cas)`tls.root_cas`

An optional root certificate authority to use. This is a string, representing a certificate chain from the parent trusted root certificate, to possible intermediate signing certificates, to the host certificate.

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
root_cas: |-
  -----BEGIN CERTIFICATE-----
  ...
  -----END CERTIFICATE-----
```

### [](#tls-root_cas_file)`tls.root_cas_file`

An optional path of a root certificate authority file to use. This is a file, often with a .pem extension, containing a certificate chain from the parent trusted root certificate, to possible intermediate signing certificates, to the host certificate.

**Type**: `string`

**Default**: `""`

```yaml
# Examples:
root_cas_file: ./root_cas.pem
```

### [](#tls-skip_cert_verify)`tls.skip_cert_verify`

Whether to skip server side certificate verification.

**Type**: `bool`

**Default**: `false`

### [](#url)`url`

A URL of the format `[https|http|udp]://host:port` to the InfluxDB host.

**Type**: `string`

### [](#username)`username`

A username (when applicable).

**Type**: `string`

**Default**: `""`

### [](#write_consistency)`write_consistency`

\[any|one|quorum|all\] sets write consistency when available.

**Type**: `string`