Working with log files

As background, the "Debugging printf Style" section discussed the use of AE environment variable NZAE_LOG_DIR. When this variable is not set, the log files are created in the NPS temporary directories on the host and SPUs (which are different than the Linux /tmp directory). Because the SPUs are not directly accessible, utilities are provided to manage log files.

Log files can be used to help troubleshoot AEs. As mentioned in General Common Variables, NZAE_DEBUG (the register_ae --level option) and NZAE_LOG_IDENTIFIER can be used to control the creation of log files, which reside in the temporary directory on either the host or the SPU. These log files can be listed, viewed, or deleted using the listlogs, viewlog, and cleanlogs functions provided as part of the Admin Utilities cartridge. When using register_ae NZAE_LOG_IDENTIFIER, the default is to the function name. In the descriptions below, the value of NZAE_LOG_IDENTIFIER is shown as IDENTIFIER.