From 05e4a733f2141995181a551854d5df929f084adf Mon Sep 17 00:00:00 2001
From: Michael Biebl <biebl@debian.org>
Date: Wed, 9 Aug 2023 21:55:35 +0200
Subject: New upstream version 1.44.0

---
 man/nm-cloud-setup.xml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

(limited to 'man/nm-cloud-setup.xml')

diff --git a/man/nm-cloud-setup.xml b/man/nm-cloud-setup.xml
index 976fc647..74ec0400 100644
--- a/man/nm-cloud-setup.xml
+++ b/man/nm-cloud-setup.xml
@@ -173,7 +173,9 @@
         <para><literal>NM_CLOUD_SETUP_LOG</literal>: control the logging verbosity. Set it
           to one of <literal>TRACE</literal>, <literal>DEBUG</literal>, <literal>INFO</literal>,
           <literal>WARN</literal>, <literal>ERR</literal> or <literal>OFF</literal>. The program
-          will print message on stdout and the default level is <literal>WARN</literal>.</para>
+          will print message on stdout and the default level is <literal>WARN</literal>. When
+          run as systemd service, the log will be collected by journald can can be seen with
+          <command>journalctl</command>.</para>
       </listitem>
       <listitem>
         <para><literal>NM_CLOUD_SETUP_AZURE</literal>: boolean, whether Microsoft Azure support is enabled. Defaults
@@ -195,6 +197,16 @@
 
   </refsect1>
 
+  <refsect1 id="debugging">
+    <title>Debugging</title>
+    <para>Enable debug logging by setting <literal>NM_CLOUD_SETUP_LOG</literal> environment variable to <literal>TRACE</literal>.</para>
+    <para>In the common case where nm-cloud-setup is running as systemd service, this can be done via <command>systemctl edit nm-cloud-setup.service</command>
+    and add <literal>Environment=NM_CLOUD_SETUP_LOG=TRACE</literal> to the <literal>[Service]</literal> section. Afterwards, the log can
+    be found in syslog via <literal>journalctl</literal>. You may also want to enable debug logging in NetworkManager as descibed
+    in the DEBUGGING section in <link linkend='NetworkManager'><citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>
+    manual. When sharing logs, it's best to share complete logs and not preemptively filter for NetworkManager or nm-cloud-setup logs.</para>
+  </refsect1>
+
   <refsect1 id="deploy">
     <title>Example Setup for Configuring and Predeploying nm-cloud-setup</title>
 
-- 
cgit 1.3.0-6-gf8a5