Archived

This repository has been archived on 2025-07-31. You can view files and clone it, but cannot push or open issues or pull requests.

Files

Nikolaos Karaolidis 8ef7e13ce8 Update README

Signed-off-by: Nikolaos Karaolidis <nick@karaolidis.com>

2023-06-30 10:03:06 +03:00

telegraf-clickhouse-plugin

The ClickHouse output plugin saves Telegraf metric data to a ClickHouse database.

The plugin uses Golang's generic "database/sql" interface and third party drivers.

Getting started

To use the plugin, set the data source name (DSN). The user account must have privileges to insert rows and create tables.

When the plugin first connects it runs SQL from the init_sql setting, allowing you to perform custom initialization for the connection.

Before inserting a row, the plugin checks whether the table exists. If it doesn't exist, the plugin creates the table.

Currently, Telegraf's sql output plugin depends on clickhouse-go v1.5.4 which uses a different DSN format than its newer v2.* version.