From 467620f0944c45c27015f8f99c1b99d74fb2321b Mon Sep 17 00:00:00 2001
From: guillaume <guillaume.derouville@gmail.com>
Date: Tue, 12 Apr 2022 18:40:03 +0200
Subject: [PATCH] docs: guide - logs options in Dagger

Signed-off-by: guillaume <guillaume.derouville@gmail.com>
---
 docs/guides/1228-better-logs.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 docs/guides/1228-better-logs.md

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"
+```