diff --git a/docs/guides/1228-better-logs.md b/docs/guides/1228-better-logs.md
new file mode 100644
index 00000000..b9d33b10
--- /dev/null
+++ b/docs/guides/1228-better-logs.md
@@ -0,0 +1,23 @@
+---
+slug: /1228/better-logs
+displayed_sidebar: europa
+---
+
+# How can I have better logs ?
+
+Dagger exposes 2 logging format options:
+
+- `--log-format auto|plain|tty|json`
+
+The default mode is `auto`. If you want to keep each actions' logs, use the `plain` mode
+
+- `--log-level panic|fatal|error|warn|info|debug|trace`
+
+`debug` is useful to check whether an explicit dependency has been found between two actions.
+
+You can also export these options as env variables:
+
+```console
+export DAGGER_LOG_FORMAT="plain"
+export DAGGER_LOG_LEVEL="debug"
+```