How to create an automatic Environment Analysis? - Knowledge Base & Support Center

Support Center » Knowledgebase » How to create an automatic Environment Analysis?

	How to create an automatic Environment Analysis?

Solution 1. Download and install XpoLog
Download XpoLog from the download section of www.xplg.com and follow the installation wizard to install.
Open a browser to the machine you installed XpoLog on, connect on port 30303 (for example: http://localhost:30303/).

2. Click on Environment Analysis Icon
Open a browser to the machine you installed XpoLog on, connect on port 30303 (for example: http://localhost:30303/) and you will see XpoLog's home page. Click on Environment Analysis icon.

3. Click on 'New Environment Analysis' Button
Click on 'New Environment Analysis' Button to start the definition wizard, the next steps on this page will explain step by step how to complete the wizard and run a report.

4. Select the type of the Environment (General/Testing/Etc) and Click Continue
The first step is to select the type of environment - select the type of the environment and click on Continue. Name the Environment Analysis.

5. Directories tab
Directories - Click on Add Directory and select the location of the directory containing the logs. It can be local or remote; in that case you can access it over SSH for UNIX/Linux machines or Windows Network. You may add several directories to the analysis.

6. Environment Info tab
Specify Meta data information on the analysis - depends on the analysis type, some parameters like type, version and build help to compare between different executions and manage the results easier. These parameters may be saved as part of the environment analysis and/or may be provided when executing the report.

7. Time Filter tab
Specify dynamic or specific time frame that you would like to run the analysis on, or run on all data to analyze everything. The time filter may be saved as part of the environment analysis and/or may be provided when executing the report.

8. Schedule tab
Specify the frequency that you wish XpoLog to run the report automatically or leave as never to run it manually.

9. Emailing tab
Enter the email addresses that the result of the report will be mailed to.

10. Save and Generate
Click on 'Save and Generate' at the bottom of the screen. When completed you will be redirected to the result. This process will scan all the specified logs and might take a few minutes (the result will be available at XpoLog at all time).

11. View Results
Under each Environment Analysis you can see the list of results that were generated on it. Select one and click on the View Result button to view the result (you may also double click or right click on a result to view it). As part of the result you will see all the errors that were found and their source logs, as well as unique messages of each log.
The first tab is "Content Analysis":
This table presents a list of unique messages and errors, that XpoLog semantic search found and sort them according to the estimated risk level. The first column indicate in which Log the error was found, the second present the actual message and the Type column identify if it belongs to known errors or it's just a semantic analysis, the summery present the nature of the errors, Risk is the level of error estimated by XpoLog algorithms, the Total indicates how many errors of this nature were found in that log. Click on the error message will open the original log filtered in those events, you may want to zoom in for problem diagnostics need.

The "Unique messages" tab of the report summarizes all unique messages formats that were found in each log. Unique message is a message in the log that contained text and changing execution data, like Thread ID, Instance or User session. XpoLog identifies the message and aggregates similar message format ignoring the changing data in the log message. Therefore, users can get a summary of unique log messages that exist in the code/logs. The Total column presents how many messages of this format were present in the log.

12. Compare Results
The idea of comparing reports is very powerful. XpoLog presents messages that were removed, messages where added and common messages, allowing the users to gain visibility into R&D changes. Running the comparisons allow great insight to application different builds/versions and time frames behavior during and between tests or production. Comparing Production data with testing data is also a powerful way to ensure there are no surprises in the production environments.
Under each Environment Analysis you can see the list of results that were generated on it.
Select the Environment Analysis that you wish to compate it's results and click on Compare Results button, select the result to be compared and click on the compare button (you may also use the CTRL key to select multiple results and click on the compare button).

As part of the result you will see all the new errors that were found ('newest' result of the compared results), old errors ('oldest' result of the compared results) and errors that exist in all compared results.

Article Details

Article ID:

273

Created On:

17 Jun 2009 07:30 AM