Page Comparison

The Add Logs Directory wizard enables users to add to XpoLog, XPLG multiple logs that are located in a local or remote directory. The user can capture logs from a log directory, by scanning scan their local or remote directory for log directories, and selecting the log directory and the log files inside the log directory that they want to place in XpoLog. dded Logs Directory appear from which they want to capture logs into XPLG. The added Logs Directory appears under Folders and Logs in the left panel. You can click a log in the added Logs Directory to view it.In order

Note: The Add Logs Directory feature described here enables adding a single logs directory to XPLG. It is also possible to add multiple logs that are located under a directory to XpoLog, use

the ‘Add Logs Directory’ wizard:

·

Specify the following details:

Select the location type of the directory - 'Local, Windows Network or

over SSH (Windows Network and SSH requires a connectivity account).

Enter the path to the directory that contains the log files.

Advanced Settings

o

Files Filters: which types of files to exclude/include as part of the

process and how many sub-directories to scan.

o

Scan Method: the automatic patterns that matched to the logs are

taken from existing configuration based on log names, contents and

automatically patterns generator. You may select which type of

mechanism to use; by default all mechanisms are active.

o

Files Name Pattern: by default, XpoLog will apply generic name

patterns to files with the same name convention. You may set the

wizard to capture each file separately.

Click the ´next’ button to perform the scan.

Page 44 of 180

XpoLog will present a list of folders and logs that were detected. You

can specify the parent folder of the new folders and logs and tag the

folders and logs to an application.

Click the ‘Save’ button to create the selected folders and logs.

Add Log

In order to add a new log to XpoLog, you can use

To add a log directory to XpoLog:

1. Open the XpoLog tab, and in XpoLog Manager, click Add Logs Directory
   OR
   Open the XpoLog tab, and in the Administration menu, select Add Logs Directory
   OR
   In the XpoLog homepage, in the left pane under More Actions, click Add logs directory
   OR
   In the XpoLog homepage, in the left pane under More Actions, click Quick start wizard, and in the Quick Start Wizard that opens, click Add Logs Directory.
   The Add Logs Directory Wizard opens.
2. In Select Directory Location, select one of the following:
   Local - follow the procedure in Adding a Local Logs Directory
   Windows Network - follow the procedure in Adding a Windows Network Directory to XpoLog
   Over SSH - follow the procedure in Adding an SSH Log Directory to XpoLog 
   Hadoop HDFS - follow the procedure in Adding a Hadoop HDFS Log Directory to XpoLog 

...

directories and automate a single or multiple logs directory, by adding an Add Logs Directory task (see Adding an Add Logs Directory Task).

Adding a logs directory to XPLG is performed in the following stages:

1. Selecting the directory location type, and defining connectivity settings accordingly.
2. Selecting the folders and logs in the logs directory to add to XPLG.
3. Optional - setting advanced settings.
4.  Pressing Scan Directory and choosing the relevant sub directories and logs to add.
5. Specifying the location of the added logs directory in XPLG.
6. Specifying the collection policy used for the newly added logs.
7. Tagging the newly added log directory to application(s) (optional).

As logs are written in free format, XPLG uses its built-in mechanism to guess the structure of the log, also called a pattern. For example, XPLG guesses which is the date field, the time field, and more, parses the data, and then adds the log records as bulk. Users can normalize or tune the results of parsing. For example, if the results of parsing data is a log with columns Date, Text2, and Text3, the user can open the log under Folders and Logs, and click the log to open it and tune the parsing results. For example, Text2 column heading can be changed to Host, and Text3 column heading to Server Name. Next time you add a log of a similar type to the one that you edited, it uses the last structure that you applied to the new log.  

To add a logs directory to XPLG:

1. Open the PortX tab, click Add Data
   PortX tab, and in the PortX  > Left Navigation Panel > Data select Add Data
   OR
   PortX  > Left Navigation Panel > Folders And Logs, click Add Log
   
   
2. Select Data Source.
3. Set the connectivity details to the logs directory (see Defining Connectivity Settings).
4. Set the log path to the directory.
5. Optional - Configuring Advanced Settings
6. Press Scan Directory.
   A Progress box displays the status of the system as it scans the directory for logs, a process that can take several minutes. When the scan completes, the Add Logs Directory Wizard presents the General and Folders and Logs sections.
7. Define the general settings of the logs directory in XPLG (see Setting Logs Directory General Information).
8. Select the folders and logs of the logs directory to add to XPLG (see Selecting Logs Directory to Add to XPLG).
9. Click the Save button.
   The selected folders and logs are created and placed in XPLG. By default, they are indexed and Analytics is performed on them.
   The Log Viewer opens with the following message: Select a log from the Folders and Logs panel on the left or Create a New Log.