GitHub-Proxy/signoz
1
0
Fork 0
mirror of https://git.mirrors.martin98.com/https://github.com/SigNoz/signoz synced 2025-08-02 11:20:40 +08:00
Code Issues Packages Projects Releases Wiki Activity
signoz/pkg/query-service/app/integrations/builtin_integrations/clickhouse/config/prerequisites.md
Raj Kamal Singh 5a778dcb18
Chore: integrations: populate updatedAt for integration dashboards (#5019) 
* chore: add test for updatedAt value being populated in integration dashboards and get it passing

* chore: also populate createdAt, createBy and updateBy for instaled integration dashboards

* chore: update clickhouse integration config instructions
2024-05-16 21:44:46 +05:30

2.2 KiB
Raw Blame History

Before You Begin

To configure metrics and logs collection for a Clickhouse server, you need the following.

Ensure Clickhouse server is prepared for monitoring

  • Ensure that the Clickhouse server is running a supported version
    Clickhouse versions v23 and newer are supported.
    You can use the following SQL statement to determine server version

    SELECT version();

  • If collecting metrics, ensure that Clickhouse is configured to export prometheus metrics If needed, please configure Clickhouse to expose prometheus metrics.

  • If collecting query_log, ensure that there is a clickhouse user with required permissions To create a monitoring user for clickhouse, you can run:

    CREATE USER monitoring IDENTIFIED BY 'monitoring_password';
GRANT SELECT ON system.query_log to monitoring;

-- If monitoring a clustered deployment, also grant privilege for executing remote queries
GRANT REMOTE ON *.* TO 'monitoring' on CLUSTER 'cluster_name';

Ensure OTEL Collector is running and has access to the Clickhouse server

  • Ensure that an OTEL collector is running in your deployment environment
    If needed, please install SigNoz OTEL Collector
    If already installed, ensure that the collector version is v0.88.0 or newer.
    If collecting logs from system.query_log table, ensure that the collector version is v0.88.23 or newer.

    Also ensure that you can provide config files to the collector and that you can set environment variables and command line flags used for running it.

  • Ensure that the OTEL collector can access the Clickhouse server
    In order to collect metrics, the collector must be able to reach clickhouse server and access the port on which prometheus metrics are being exposed.

    In order to collect server logs, the collector must be able to read the Clickhouse server log file.

    In order to collect logs from query_log table, the collector must be able to reach the server and connect to it as a clickhouse user with required permissions.