From c53df923b55152672ac76f198bf8646735f02a3b Mon Sep 17 00:00:00 2001 From: Robin Han Date: Sun, 10 May 2026 09:58:19 +0800 Subject: [PATCH] docs(devkit): document in-container broker logs --- devkit/README.md | 11 +++++++++++ devkit/justfile | 2 +- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/devkit/README.md b/devkit/README.md index 20e6d3d587..138e2902b0 100644 --- a/devkit/README.md +++ b/devkit/README.md @@ -83,6 +83,17 @@ just logs 0 | head -20 # oldest entries just logs 0 | tail -20 # newest entries ``` +`just logs` only shows container stdout/stderr. Kafka component logs are written +inside the node container under `/tmp/kafka-logs`, for example +`/tmp/kafka-logs/server.log`, `controller.log`, `s3-object.log`, and +`s3stream-threads.log`. Use `just exec` when checking detailed broker logs: + +```bash +just exec 0 grep -R ERROR /tmp/kafka-logs +just exec 0 grep -R LOGCACHE_VERIFY /tmp/kafka-logs +just exec 0 tail -200 /tmp/kafka-logs/server.log +``` + ## Topic Operations ```bash diff --git a/devkit/justfile b/devkit/justfile index dcf817a06d..d821f56813 100644 --- a/devkit/justfile +++ b/devkit/justfile @@ -45,7 +45,7 @@ ensure-cluster-id: # Override to skip or replace the Java build step, e.g.: # DEVKIT_BUILD_CMD="echo skipped" just start-build -JAVA_BUILD_CMD := env_var_or_default("DEVKIT_BUILD_CMD", "./gradlew :core:build :tools:build :shell:build -x test") +JAVA_BUILD_CMD := env_var_or_default("DEVKIT_BUILD_CMD", "./gradlew build -x test") [private] build: