Skip to main content

 

Having read the Installation:LoggingContextFilter and the Installation:Useful Server Logging Configurations wiki articles, I’m still coming up short in regards to what I want to achieve. 

 

Context

I am asking from the context of a multi-server environment, with several assystEnterprise servers, each running in their separate windows VMs, with a load balanced URL facing our users, and our technicians.

 

I am trying to address some issues in regards to the %JBOSS_HOME%/standalone/log/server.log and how the logging of certain normal or foreseeable events caused by our users or IT-staff causes massive entries in the server.log. 

Having the added noise of errors from normal and foreseeable behavior in the main log file adds extra complexity and increases the time spent noticing patterns and determining the cause of reported issues. 

On the other hand, some error messages are not verbose enough to be of use as they lack critical information needed to investigate the issue, or for aggregation purposes to determine if additional training might be necessary for some of our support staff. 

Overarching goal

This is the first step in a larger picture of enabling automatic monitoring the system of our Assyst installation, as well as certain Assyst functionality, using a combination of SCOM, CheckMK, and Grafana. Any proposed solution would have to be compatible, or preferably synergistic with this overarching goal in mind.

 

Some examples: 

Too much information

In an instance where a user has been forwarded an email chain from a technician, where part of the email contains the AssystWEB link. This often cause some users to attempt to open said URL, which then fails as they do not have an assystUser, but also causes a set of error messages in the server log, such as:

… tAuthenticator] (default task-19869) getAccountUser 'prefix-xxxxxx' does not have an account.

oDate] eTime]

 

However, each such attempt causes a total of 12 Errors, and 4 Warnings relating to authenticating and downloading icon for that user. This results in ~ 1050 lines in the server.log, for each user attempt. 

 

 

Not enough information:

In the case of an assystUser performing a search it is foreseeable that some of them will hit the cap of allowable results (as set in the system parameters). However, when the error is logged there is no information regarding who performed the search, what the used search terms where, or what search parameters where selected when performing the search.

Searches failing due to system parameter limit is also mostly irrelevant in regards to the stability of the system, and could be better presented in a log dedicated to errors caused by users/IT-staff. 

Having more information regarding what caused errors could help us aggregate these error messages, and determine if it’s a repeat user, or if it’s a broader issue pertaining to certain search parameters that have been selected, etc. 

 

 

Questions, and request for input

  1. Does IFS, or any Customers using Assyst have any experience to share, or examples of how this or similar issues has been approached?
  2. Are there examples of how, and what log outputs should be written to the windows event log to enable automatic system and functionality monitoring by SCOM or similar software?
  3. What resources are recommended for further insights into the possibilities and pitfalls in this area in the in regards of Assyst?
  4. Are there for instance examples of how to make a more granular logging setup where certain events are written to a set of separate logs, where a «main log» such as server.log simply states that something was recorded to that separate log?
  5. Am I approaching this situation from the wrong angle, and if so, what steps would you recommend?

Dear customer

 

Thank you the questions raised 

 

with regards to assyst server logging configuration 

 

The log level is set in the standalone-full.xml 

its set as in the example below :

 

 

<console-handler name="CONSOLE">                <level name="INFO"/>                <formatter>                    <named-formatter name="COLOR-PATTERN"/>                </formatter>            </console-handler>

 

This log level can be changed as you require 

for example you can change this level from info to debug 

The debug log level will provide further entries and additional entries in the assyst log file which can be helpful in analysis and troubleshooting

this will be set as below :

 

<console-handler name="CONSOLE">                <level name="DEBUG"/>                <formatter>                    <named-formatter name="COLOR-PATTERN"/>                </formatter>            </console-handler>

 

please find more information in the wiki link below :

https://wiki.axiossystems.com/assyst11-8Wiki/index.php/Installation:How_the_assyst_Application_Interfaces_with_SMTP#Enabling_Debug_Logging

 

The standalone folder also contains an smtp file 

 

Moreover, an APM log can be enabled to investigate and troubleshoot any performance issues 

 

Please find more information in the wiki link below :

https://wiki.axiossystems.com/assyst11-8Wiki/index.php/Installation:WildFly_Performance_Measurement

 

Please see an example below of how to apm log level if required to analyse and investigate any performance issue which may occur

 

Specify the level of detail to which various assyst components should record their performance:

<logger category="trace.com.axiossystems.assyst" use-parent-handlers="false">    <level name="DEBUG"/>    <handlers>        <handler name="APM"/>    </handlers></logger>

 

Please note enabling additional logging will results in larger log files and will require additional diskspace 

Additional logging can be enabled temporarily to troubleshoot a specific issues and disable once issue no longer exist 

 

Note: This configuration will produce a new log file every day. Unless a mechanism is put in place to move, or remove, the log files on a regular basis the server will run out of disk space and assyst may stop functioning correctly.

 

Please find information with regards to search server log files in the wiki link below :

 

https://wiki.axiossystems.com/assyst11-8Wiki/index.php/Installation:Search_Engine_-_Trouble-shooting_and_Reporting_Errors#Checking_the_Search_Engine_Server_Log_File

 

Setting Logging output to DEBUG

Search Engine Server contains comprehensive DEBUG logging messages. To further aid diagnosing errors, it is very helpful to set logging threshold to DEBUG, as explained in the Configuring Search Engine Server Logging]] topic.

It should be noted that logging with a DEBUG threshold will result in significant logging output, which will affect Search Engine Server performance and result in very large log files.

 

https://wiki.axiossystems.com/assyst11-8Wiki/index.php/Installation:Configuring_Search_Engine_Server_Logging

 

I hope the above information helps answers your questions

 

Kind regards,


Thank you very much for the detailed reply.

Due to time constraints, I’ve not been able to look into and provide a reply before now.

The information provided is much appreciated, and some of the articles mentioned are new to me as they did not return as results in the Server logging category on the Wiki (Is there a reason as why they are not in this category, and are there other articles that sould be here?), nor turned up in my wiki searches during researching this topic.

However, the key issues presented in the origianl “Questions, and request for input section” remain unanswered, and does not help remedy the primary concern:

 

To use Assyst as a reliable product, the automatic monitoring of the system stability and functionality using dedicated software is a minimum in today’s IT landscape.

The default logging settings to a file, and modifications as presented on the wiki are not compatible with the need for automatic monitoring by a 3rd party monitoring software.

The wiki does not seem to provide any guidance or examples in how to go about making such modifications, nor what pitfalls to avoid.

Does IFS have any examples or guides on how to modify the standard installed logging parameters to facilitate automatic alerts by a 3rd party software?

  • Example scenarios that would be of interest to monitor are an unresponsive server, email issues, issues in regard to search-/report-/webswing-server, and on a more advanced level; alerts if certain functionality has been impacted.

Reply