Differences

This shows you the differences between two versions of the page.

--- developers:debug_messages:start [2012/07/23 23:29]
127.0.0.1 external edit
+++ developers:debug_messages:start [2015/05/06 22:40] (current)
geojames [List of Common Debug Types]
@@ Line 11: / Line 11: @@
   - When you are done, be sure to disable the debug addon, as any debugging addon will add a small amount of overhead to each page load.
-===== List of Common Debug Types =====
+==== List of Common Debug Types ====
 This is a list of the most commonly used or useful debug types.
-  * **all** - //[SPECIAL]//: shows all debug output.  There is not actually any debug messages that use "all" as the keyword (or at least that is not the intent).
+  * **all+stats** - //[SPECIAL]//: shows all debug output.  There is not actually any debug messages that use "all" as the keyword (or at least that is not the intent).
   * **stats** - Most common & useful type, it shows statistic geared messages.  We've placed debug messages at common bottlenecks as well, since each debug message has the time it allows looking for where slow-downs occur.  //[SPECIAL]//: This will also display a table of DB queries used in the software, along with execution time for each query.
   * **sql** - show sql messages and errors.
@@ Line 23: / Line 23: @@
   * **index** - show output from index page.  (possibly not used much)
   * **cache** - messages relating to cache.
+===== Debug Output in the Page =====
+When the above is turned on the software will display lines of output beyond the bottom of each page loaded.  To see it once debug display has been turned on you only need to scroll down the page to see it.  There could be quite a lot of it so if you know the type of message you are looking for you can choose it from the above list to narrow the output down a bit.  The output will look something like that below though the color may change from page load to page load:
+{{ :developers:debug_messages:debug_messages1.png?800 }}
+Within that output you'll notice:
+  - This is the timestamp for that line.  That is the time in microseconds from the beginning of that page load to that point in the script run time.  This number will only grow as you go down the page until you get to the end of the output. This is a good way to see the full amount of time the software takes to build the page requested.  If this says 1.5 seconds at the end of all output and it takes a total of 10 seconds for your page to load this stat should help you narrow down page load issues.  This stat is also useful in finding out if there is a particular section of the page load is slow.  You can scan these values as you go down the page and see if there are any points where there is a lot of time between one line or another.  You should be able to narrow down the possible section of a slowdown.
+  - This the memory used by the script up to that point in the page load.  This value may go up AND down in processing.  The debug output does produces a stat at the end where it provides the highest memory usage during processing of that request so you don't need to search the page for the highest memory usage.
+  - This is the output displayed by coding.  Whatever message the coder wanted to output is there and sometimes includes sql queries, variable values at given steps of processing,...etc anything that might help building or debugging a feature.
+  - This is the file the output was generated from.
+  - This is the line number that output was generated from. Note that this value may not be the EXACT line as files include files and code from different sources and line counts may not be accurate.
+Note that the software doesn't "output debug" for EVERYTHING the software does.  So if you see a jump in time there just may not be much debug output in the particular section of code.  We try not to put output in the middle of a loop that will iterate hundreds of times producing hundreds of lines of mainly useless output.
 ===== Debug Message Syntax =====
-In the code, use the following:
+If you want to edit the base php code and insert your own debug output for your own feature creation or debugging use the folllowing in creating those **debug triggers** :
 **Debug message** : just a general message.

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools