Adding a Local Log

On a Windows machine, you can bring into XpoLog local logs that reside on either of the following:

• The same Windows machine, provided that XpoLog has Read permissions on these logs.  Example: My Computer > C > Logs Directory.

• A remote server to which you have direct access. This requires providing a UNC path (\\hostname\dir_name\) through which XpoLog can locate the files on these servers. Example: \\qaserver\c$.

In cases where you want to view or search an archived log, you can restore it by adding it as a local log.

Note: To access a remote Windows server that requires authentication, see Adding a Windows Network Log.

To add a local log to XpoLog:

1. In Add Data pane click on Local Network. The Source and Collection Setting wizard opens.

   • To change a log source, near Source Type, click on the Change button.

2. IF this is NOT a Windows machine you may skip to action item #2. 
   ELSE IF  this is a WINDOWS machine then enter Connection Details and choose account. For local log the default localhost. Otherwise, select the authentication account required to connect to the remote location where the log resides, or click the new link to add an authentication account  to the system (see Address Book).

3. In Log Path or Directory, type the path to the log's location 
   OR
   Click Browse and in the System Files Browser that opens, expand the folders to get to the desired log, and then click Select to display the log location in Log Path.

4. Optionally, append to the log path a name pattern to capture multiple files from the same log. (For pattern syntax, see XpoLog Patterns Language.) The log name is displayed in the left pane in its selected location under Folders and Logs. If you put in the log path a {string} pattern, the various files of the log appear in the left pane. Otherwise, only one file appears. You can perform regular actions on this log. 

5. Optionally, click on Collection Settings to define advanced settings for the local log – Files Attributes, Files Filters, and/or Regional Settings (see Configuring Advanced Log Settings). 

6. Click Add Log. A progress box displays the status of the system as it scans the selected path for log. When the scan completes, the Patterns Administration Wizard screen opens.

7. Optionally, Apply patterns on the log data and save the log in XpoLog (see Applying Patterns on the Log).
   
   

8. Click Save – XpoLog applies an automated pattern on the incoming log. Log Collection Settings wizard opens.

9. Optionally, defining the basic information of the new log (see Setting Log General Information).

10. Click one of the following:
    Save & Close – XpoLog saves the new log and points to the logs tree. locate the log in the logs tree and enter the viewer in order to view the log.
    Save & Add Another – XpoLog saves the new log and points to Add Log screen so that you may another log.

Comments:

• On a Unix machine, you can bring into XpoLog local logs that reside on the same machine or in a mounted directory to which you have direct access.

• On a Windows machine, you can define zipped logs (single/multiple files) without extracting them:
  If you have a file archive.zip/archive.gz/archive.tar, which contains inside a single file, it should be defined directly on that archive file.
  If you have a file archive.zip/archive.tar, which contains inside multiple files (log-name.log, log-name.log.1, log-name.log.2, ..., log-name.log.N) it should be defined using the name pattern: archive.zip?log-name.log{string}/archive.gz?log-name.log{string}/archive.tar?log-name.log{string}
  If you have a file archive.zip/archive.tar, which contains inside directories and files multiple files (log-name.log, log-name.log.1, log-name.log.2, ..., log-name.log.N) it should be defined using the name pattern: archive.zip?PATH/TO/FILES/archive.tar?PATH/TO/FILES/log-name.log{string}