From 3620c0d2d01c24acf9cb4c9b8fc4fa7e4d4cd202 Mon Sep 17 00:00:00 2001 From: infra Date: Tue, 23 Sep 2025 11:27:49 -0400 Subject: [PATCH 1/6] docs: add troubleshooting step for clickhouse and aquasec --- src/langsmith/troubleshooting.mdx | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index 5d2e4e171..dcc65fe8a 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -176,3 +176,29 @@ langchain-clickhouse: docker compose down --volumes docker compose up ``` + +### *ClickHouse Fails to Startup 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. +This is generally 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 + +1. Edit your `langsmith_config.yaml` (or corresponding config file) and set the `AQUA_SKIP_LD_PRELOAD` environment variable. This might look something like this: + +```yaml +clickhouse: + statefulSet: + extraEnv: + - name: AQUA_SKIP_LD_PRELOAD + value: "true" +``` + +#### Docker +1. Edit your `docker-compose.yaml` and set the `AQUA_SKIP_LD_PRELOAD` environment variable. This might look something like this: + +```yaml +langchain-clickhouse: + environment: + - AQUA_SKIP_LD_PRELOAD=true +``` From abc237115294ebb26174d2cafd4874b2dd1b1f8a Mon Sep 17 00:00:00 2001 From: langchain-infra Date: Tue, 23 Sep 2025 11:43:48 -0400 Subject: [PATCH 2/6] Update src/langsmith/troubleshooting.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- src/langsmith/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index dcc65fe8a..70ad37feb 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -180,7 +180,7 @@ docker compose up ### *ClickHouse Fails to Startup 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. -This is generally 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: +This is generally 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 From dd85604d93c71ea7e8b8360df7afd7244c5afef6 Mon Sep 17 00:00:00 2001 From: langchain-infra Date: Tue, 23 Sep 2025 11:52:55 -0400 Subject: [PATCH 3/6] Update src/langsmith/troubleshooting.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index 70ad37feb..3d08d40c4 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -180,7 +180,7 @@ docker compose up ### *ClickHouse Fails to Startup 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. -This is generally 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: +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 From bc7da5a509fa7fddf1e3c72abd86f48dfd61e5a6 Mon Sep 17 00:00:00 2001 From: langchain-infra Date: Tue, 23 Sep 2025 11:53:02 -0400 Subject: [PATCH 4/6] Update src/langsmith/troubleshooting.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index 3d08d40c4..581e90f8d 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -177,7 +177,7 @@ docker compose down --volumes docker compose up ``` -### *ClickHouse Fails to Startup when running a Cluster with AquaSec* +### *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: From d3a4f9028f55f10d118569ba446db59d5cf4155b Mon Sep 17 00:00:00 2001 From: langchain-infra Date: Tue, 23 Sep 2025 11:53:08 -0400 Subject: [PATCH 5/6] Update src/langsmith/troubleshooting.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index 581e90f8d..b94ac458f 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -184,7 +184,7 @@ Generally this is due to `LD_PRELOAD` being set by AquaSec, which interferes wit #### Kubernetes -1. Edit your `langsmith_config.yaml` (or corresponding config file) and set the `AQUA_SKIP_LD_PRELOAD` environment variable. This might look something like this: +Edit your `langsmith_config.yaml` (or corresponding config file) and set the `AQUA_SKIP_LD_PRELOAD` environment variable: ```yaml clickhouse: From bbf9fef89929af5339d240a438965c391ca28ecb Mon Sep 17 00:00:00 2001 From: langchain-infra Date: Tue, 23 Sep 2025 11:53:17 -0400 Subject: [PATCH 6/6] Update src/langsmith/troubleshooting.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/troubleshooting.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/langsmith/troubleshooting.mdx b/src/langsmith/troubleshooting.mdx index b94ac458f..7ecb60081 100644 --- a/src/langsmith/troubleshooting.mdx +++ b/src/langsmith/troubleshooting.mdx @@ -195,7 +195,8 @@ clickhouse: ``` #### Docker -1. Edit your `docker-compose.yaml` and set the `AQUA_SKIP_LD_PRELOAD` environment variable. This might look something like this: + +Edit your `docker-compose.yaml` and set the `AQUA_SKIP_LD_PRELOAD` environment variable: ```yaml langchain-clickhouse: