Custom Logs: Difference between revisions

304 bytes added ,  15:01, 11 October 2023
m
Line 7: Line 7:
=== '''IMPORTANT''' ===
=== '''IMPORTANT''' ===
'''NOTE: The formatting of the datafiles is important as the Custom Logs are basically free format: you can put into the file any text and numbers with any separator you wish. CUtils will NOT handle that Free Format in general. The user has to take care the information in the resulting datafiles is as follows:'''
'''NOTE: The formatting of the datafiles is important as the Custom Logs are basically free format: you can put into the file any text and numbers with any separator you wish. CUtils will NOT handle that Free Format in general. The user has to take care the information in the resulting datafiles is as follows:'''
  '''1) There MUST be at least one space between the numbers; '''
  '''1) There MUST be at least one space of your local separator between the webtags; '''
  '''2) There cannot be any plain text in the logfile'''
  '''2) There cannot be any plain text in the logfile'''
  '''The date/time will be untouched i.e. the format is: dd-mm-yy;hh:mm;'''
  '''The date/time will be untouched i.e. the format is the local date format e.g. dd-mm-yy;hh:mm;'''


If there is free  text in the definition of the log, the CustomLogs module should ignore that and parse only the webtags which result in a number.
If there is free  text in the definition of the log, the CustomLogs module should ignore that and parse only the webtags which result in a number.
Strange effects may occur if this is not obeyed.


'''NOTE: Be aware that for every webtag an entry in the datafile will be created for the period of number of hours you have defined for the charts. This may lead to large datafiles being transferred every interval, data duplication (data already present in the standard datafiles of CMX or CUtils) and high memory use and performance of your server while displaying the charts may be the result. So the user is warned to think about what he really wants to log and view.
'''NOTE: Be aware that for every webtag an entry in the datafile will be created for the period of number of hours you have defined for the charts. This may lead to large datafiles being transferred every interval, data duplication (data already present in the standard datafiles of CMX or CUtils) and high memory use and performance of your server while displaying the charts may be the result. So the user is warned to think about what he really wants to log and view.
'''
'''
'''If you use PHP upload: If you change your CustomLogs definition such that you get a 500 error in while uploading the datafile, please delete the datafile on the server and let the system try again.'''


=== Dependency ===
=== Dependency ===