diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index 5d2e4e171..7ecb60081 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -176,3 +176,30 @@ langchain-clickhouse: docker compose down --volumes docker compose up ``` + +### *ClickHouse fails to start up when running a cluster with AquaSec* + +In some environments, AquaSec may prevent ClickHouse from starting up correctly. This may manifest as the ClickHouse pod not emitting any logs and failing to get marked as ready. +Generally this is due to `LD_PRELOAD` being set by AquaSec, which interferes with ClickHouse. To resolve this, you can add the following environment variable to your ClickHouse deployment: + +#### Kubernetes + +Edit your `langsmith_config.yaml` (or corresponding config file) and set the `AQUA_SKIP_LD_PRELOAD` environment variable: + +```yaml +clickhouse: + statefulSet: + extraEnv: + - name: AQUA_SKIP_LD_PRELOAD + value: "true" +``` + +#### Docker + +Edit your `docker-compose.yaml` and set the `AQUA_SKIP_LD_PRELOAD` environment variable: + +```yaml +langchain-clickhouse: + environment: + - AQUA_SKIP_LD_PRELOAD=true +```