You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@guacamole.apache.org by jm...@apache.org on 2017/03/31 17:48:51 UTC

[1/2] incubator-guacamole-manual git commit: GUACAMOLE-259: Document use of the "trace" log level.

Repository: incubator-guacamole-manual
Updated Branches:
  refs/heads/master 5ae8e7feb -> 37d843ca8


GUACAMOLE-259: Document use of the "trace" log level.


Project: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/commit/8d22a6e0
Tree: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/tree/8d22a6e0
Diff: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/diff/8d22a6e0

Branch: refs/heads/master
Commit: 8d22a6e0502385fbe8b75dc3ca86d616553badb8
Parents: 6012d77
Author: Michael Jumper <mj...@apache.org>
Authored: Fri Mar 31 00:09:21 2017 -0700
Committer: Michael Jumper <mj...@apache.org>
Committed: Fri Mar 31 00:09:21 2017 -0700

----------------------------------------------------------------------
 src/chapters/configuring.xml | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/blob/8d22a6e0/src/chapters/configuring.xml
----------------------------------------------------------------------
diff --git a/src/chapters/configuring.xml b/src/chapters/configuring.xml
index 06d9656..660ed79 100644
--- a/src/chapters/configuring.xml
+++ b/src/chapters/configuring.xml
@@ -249,7 +249,20 @@ guacd-port:     4822</programlisting>
                 <listitem>
                     <para>Debug messages are highly detailed and oriented toward development. Most
                         debug messages will contain stack traces and internal information that is
-                        useful when investigating problems within code.</para>
+                        useful when investigating problems within code. It is expected that debug
+                        messages, though verbose, will not affect performance.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><indexterm>
+                        <primary>logging</primary>
+                        <secondary>trace</secondary>
+                    </indexterm><constant>trace</constant></term>
+                <listitem>
+                    <para>Trace messages are similar to debug messages in intent and verbosity, but
+                        are so low-level that they may affect performance due to their frequency.
+                        Trace-level logging is rarely necessary, and is mainly useful in providing
+                        highly detailed context around issues being investigated.</para>
                 </listitem>
             </varlistentry>
         </variablelist>
@@ -3573,9 +3586,10 @@ parameter3 = "c:\\windows\\path\\to\\file.txt"</programlisting>
                                 </indexterm>The maximum level at which guacd will log messages to
                                 syslog and, if running in the foreground, the console. If omitted,
                                 the default level of <constant>info</constant> will be used.</para>
-                            <para>Legal values are <constant>debug</constant>,
-                                    <constant>info</constant>, <constant>warning</constant>, and
-                                    <constant>error</constant>.</para>
+                            <para>Legal values are <constant>trace</constant>,
+                                    <constant>debug</constant>, <constant>info</constant>,
+                                    <constant>warning</constant>, and
+                                <constant>error</constant>.</para>
                         </entry>
                     </row>
                     <row>
@@ -3668,9 +3682,10 @@ parameter3 = "c:\\windows\\path\\to\\file.txt"</programlisting>
                 <listitem>
                     <para>Sets the maximum level at which guacd will log messages to syslog and, if
                         running in the foreground, the console. Legal values are
-                            <constant>debug</constant>, <constant>info</constant>,
-                            <constant>warning</constant>, and <constant>error</constant>. The
-                        default value is <constant>info</constant>.</para>
+                            <constant>trace</constant>, <constant>debug</constant>,
+                            <constant>info</constant>, <constant>warning</constant>, and
+                            <constant>error</constant>. The default value is
+                            <constant>info</constant>.</para>
                     <para>This corresponds to the <parameter>log_level</parameter> parameter within
                         the <parameter>daemon</parameter> section of
                         <filename>guacd.conf</filename>.</para>


[2/2] incubator-guacamole-manual git commit: GUACAMOLE-259: Merge documentation for new TRACE log level.

Posted by jm...@apache.org.
GUACAMOLE-259: Merge documentation for new TRACE log level.


Project: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/commit/37d843ca
Tree: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/tree/37d843ca
Diff: http://git-wip-us.apache.org/repos/asf/incubator-guacamole-manual/diff/37d843ca

Branch: refs/heads/master
Commit: 37d843ca8d7c41ed0035a4e6631e54b0296b77bf
Parents: 5ae8e7f 8d22a6e
Author: James Muehlner <ja...@guac-dev.org>
Authored: Fri Mar 31 10:48:22 2017 -0700
Committer: James Muehlner <ja...@guac-dev.org>
Committed: Fri Mar 31 10:48:22 2017 -0700

----------------------------------------------------------------------
 src/chapters/configuring.xml | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)
----------------------------------------------------------------------