From fcda4e87d982b055e73bd5f8c070d23c2b2721e3 Mon Sep 17 00:00:00 2001 From: Felipe Colussi-oliva Date: Thu, 28 Sep 2023 13:45:50 -0300 Subject: [PATCH] [Backport 2.7] Add cattle-cluster-agent trace/debug logs (#880) * add cattle-cluster-agent trace/debug logs * Update docs/troubleshooting/other-troubleshooting-tips/logging.md Co-authored-by: Marty Hernandez Avedon * Update docs/troubleshooting/other-troubleshooting-tips/logging.md Co-authored-by: Marty Hernandez Avedon * Update docs/troubleshooting/other-troubleshooting-tips/logging.md Co-authored-by: Marty Hernandez Avedon * Update docs/troubleshooting/other-troubleshooting-tips/logging.md Co-authored-by: Marty Hernandez Avedon --------- Co-authored-by: Marty Hernandez Avedon --- .../other-troubleshooting-tips/logging.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/troubleshooting/other-troubleshooting-tips/logging.md b/docs/troubleshooting/other-troubleshooting-tips/logging.md index d4d6353442e..6d0e6dd9b4f 100644 --- a/docs/troubleshooting/other-troubleshooting-tips/logging.md +++ b/docs/troubleshooting/other-troubleshooting-tips/logging.md @@ -78,3 +78,19 @@ possible to enable debug logs in `rancher-machine` when provisioning RKE1, RKE2 Just like the `trace` log level above, `rancher-machine` debug logs can contain sensitive information. ::: + + +## Cattle-cluster-agent debug logs + +The `cattle-cluster-agent` log levels can be set when you initialize downstream clusters. + +When you create a cluster under **Cluster Configuration > Agent Environment Vars** you can set variables to define the log level. +- Trace-level logging: Set `CATTLE_TRACE` or `RANCHER_TRACE` to `true` + +- Debug-level logging: Set `CATTLE_DEBUG` or `RANCHER_DEUBG` to `true` + +:::caution + +The `cattle-cluster-agent` debug logs may contain sensitive information. + +:::