Main ✸ Source Code ✸ Downloads ✸ API Documentation ✸ Mailing Lists ✸ Bugs ✸ Developers
One of your best companions will sooner or later become the ns_log command. When NaviServer is running in the background certain events from notices to fatal errors are logged to the Server logfile along with the time of the event. Use ns_log for all kinds of debugging purposes or for tracking information from non-connection threads, e.g. scheduled procedures.
ns_log takes two arguments: A severity argument and the message. Severity may be one of
Examples of log statements (from NaviServer and from within command mode)
[30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: encoding: loaded: iso8859-1 [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nsmain: NaviServer/4.99.0 starting [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nsmain: security info: uid=503, euid=503, gid=8, egid=8 [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nsmain: max files: FD_SETSIZE = 1024, rl_cur = 1024, rl_max = 1024 [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: adp[server1]: mapped /*.adp [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: adp[server1]: mapped /*.u_adp [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: adp[server1]: mapped /*.gb_adp [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: adp[server1]: mapped /*.sjis_adp [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: modload: loading '/usr/local/ns/bin/nssock.so' [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: modload: loading '/usr/local/ns/bin/nslog.so' [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nslog: opened '/usr/local/ns/servers/server1/modules/nslog/access.log' [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: conf: [ns/server/server1]enabletclpages = 0 [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nsmain: NaviServer/4.99.0 running [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nsmain: security info: uid=503, euid=503, gid=8, egid=8 [30/Mar/2008:10:33:54][7540.1082407856][-sched-] Notice: sched: starting [30/Mar/2008:10:33:54][7540.1076887680][-main-] Notice: nssock: listening on 10.1.0.110:8000 [30/Mar/2008:10:33:54][7540.1084509104][-driver-] Notice: starting [30/Mar/2008:10:33:54][7540.1084509104][-driver-] Notice: driver: accepting connections
% ns_log Warning "server has to log a useless statement"
[30/Mar/2008:10:33:54][7540.1076887680][-main-] Warning: server has to log a useless statement
For configuration details take a look at Server Logfile configuration.
All HTTP requests to NaviServer are appended to the Access log. It stores lines like
10.0.1.111 - - [17/Jun/2005:09:00:45 +0200] "GET /intranet/mat/space.gif HTTP/1.1" 304 0 "" "Opera/8.0 (X11; Linux i686; U; en)" 0.125860 10.0.1.111 - - [17/Jun/2005:09:00:45 +0200] "GET /favicon.ico HTTP/1.1" 404 310 "" "Opera/8.0 (X11; Linux i686; U; en)" 0.004570
The command ns_accesslog allows to fetch the name of the current access logfile or to roll it. There are plenty of parameters available to configure what, when and how to log and roll.
For configuration details take a look at Access Log configuration.