conf.yaml.example

init_config:

instances:
  - service_id: "<your-service-uuid>"          # required – ClickHouse Cloud service UUID
    key_id: "<your-api-key-id>"                 # required – Cloud API key ID
    key_secret: "<your-api-key-secret>"         # required – Cloud API key secret

    # Cluster / service identity
    cluster_name: "<your-cluster-name>"         # used as the "service" field in Datadog Logs
                                                # (default: "clickhouse")

    # Log collection toggles
    collect_query_logs: true                    # default: true
    collect_text_logs: true                     # default: true

    # Tuning
    log_batch_size: 1000                        # rows per check run (1–10000)
    slow_query_threshold_ms: 5000              # marks query logs as warning (0–3600000)
    initial_backfill_minutes: 60               # lookback window on first run (1–1440)
    query_timeout_seconds: 30                  # HTTP timeout per query (5–300)

    # Applied to all logs shipped
    tags:
      - "env:prod"
      - "clickhouse_cluster:<your-cluster-name>"

logs:
  - type: integration
    source: clickhouse