com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'html' is unknown.

Adding a Logs Directory to XpoLog

The Add Logs Directory wizard enables users to add to XpoLog multiple logs that are located in a local or remote directory. The user can scan their local or remote directory for the log directory from which they want to capture logs into XpoLog. The added Logs Directory appears under Folders and Logs in the left panel.

Note: The Add Logs Directory feature described here enables adding a single logs directory to XpoLog. It is also possible to add multiple logs 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 XpoLog is performed in the following stages:

  1. Selecting the directory location type, and defining connectivity settings accordingly.
  2. Specifiying the location of the added logs directory in XpoLog.
  3. Tagging the newly added log directory to application(s) (optional).
  4. Selecting the folders and logs in the logs directory to add to XpoLog.

As logs are written in free format, XpoLog uses its built-in mechanism to guess the structure of the log, also called a pattern. For example, Xpolog 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 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 Manager page, 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
    OR
    Open the XpoLog tab, and in the Administration menu, select Folders and Logs, and in the Folders and Logs console that opens, click the New Logs Directory button.
    The Add Logs Directory Wizard opens.
  2. Set the connectivity details to the logs directory (see Defining Connectivity Settings).
  3. Click the Next button.
    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.
  4. Define the general settings of the logs directory in XpoLog (see Setting Logs Directory General Information).
  5. Select the folders and logs of the logs directory to add to XpoLog (see Selecting Logs Directory to Add to XPLG).
  6. Click the Save button.
    The selected folders and logs are created and placed in XpoLog. 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.