.TH IPLOGGER 1 "July 21, 2011" "" "" .\" Man page generated from reStructeredText. .SH NAME \fBiplogger \- IPython logger for parallel computing. .SH DESCRIPTION Start an IPython logger for parallel computing. .sp IPython controllers and engines (and your own processes) can broadcast log messages by registering a \fIzmq.log.handlers.PUBHandler\fP with the \fIlogging\fP module. The logger can be configured using command line options or using a cluster directory. Cluster directories contain config, log and security files and are usually located in your ipython directory and named as "profile_name". See the \fIprofile\fP and \fIprofile\-dir\fP options for details. .SH OPTIONS .sp IPython command\-line arguments are passed as \(aq\-\-\(aq, or \(aq\-\-=\(aq. .sp Arguments that take values are actually convenience aliases to full Configurables, whose aliases are listed on the help line. For more information on full configurables, see \(aq\-\-help\-all\(aq. .TP .B \-\-debug . set log level to logging.DEBUG (maximize logging output) .TP .B \-\-init . Initialize profile with default config files. This is equivalent to running \fIipython profile create \fP prior to startup. .TP .B \-\-log\-to\-file . send log output to a file .TP .B \-\-quiet . set log level to logging.CRITICAL (minimize logging output) .TP .B \-\-profile= (BaseIPythonApplication.profile) . Default: u\(aqdefault\(aq The IPython profile to use. .TP .B \-\-log\-to\-file= (BaseParallelApplication.log_to_file) . Default: False whether to log to a file .TP .B \-\-ipython\-dir= (BaseIPythonApplication.ipython_dir) . The name of the IPython directory. This directory is used for logging configuration (through profiles), history storage, etc. The default is usually $XDG_CONFIG_HOME/ipython. This options can also be specified through the environment variable IPYTHONDIR. .TP .B \-\-url= (LogWatcher.url) . Default: \(aq\fI\%tcp://127.0.0.1:20202\fP\(aq ZMQ url on which to listen for log messages .TP .B \-\-topics= (LogWatcher.topics) . Default: [\(aq\(aq] The ZMQ topics to subscribe to. Default is to subscribe to all messages .TP .B \-\-log\-level= (Application.log_level) . Default: 30 Choices: (0, 10, 20, 30, 40, 50, \(aqDEBUG\(aq, \(aqINFO\(aq, \(aqWARN\(aq, \(aqERROR\(aq, \(aqCRITICAL\(aq) Set the log level by value or name. .TP .B \-\-log\-url= (BaseParallelApplication.log_url) . Default: \(aq\(aq The ZMQ URL of the iplogger to aggregate logging. .TP .B \-\-clean\-logs= (BaseParallelApplication.clean_logs) . Default: False whether to cleanup old logfiles before starting .TP .B \-\-profile\-dir= (ProfileDir.location) . Default: u\(aq\(aq Set the profile location directly. This overrides the logic used by the \fIprofile\fP option. .TP .B \-\-work\-dir= (BaseParallelApplication.work_dir) . Set the working dir for the process. .SH SEE ALSO .BR ipython(1), .BR ipcontroller(1), .BR ipengine(1) .br .SH AUTHOR \fBiplogger\fP is a tool that ships with IPython, created by the IPython Development Team.