Subscribing is a smart move!
You can subscribe to this forum after you log in or create your free account.
Configure Appropriate Logging
Geo SCADA Knowledge Base
Access vast amounts of technical know-how and pro tips from our community of Geo SCADA experts.
Invite a Co-worker
Send a co-worker an invite to the Exchange portal.Just enter their email address and we?ll connect them to register. After joining, they will belong to the same company.
Send Invite Cancel
📖 Home Back
The content you are looking at may be outdated.
This article is a brief summary of several detailed articles about configuring ClearSCADA logging that can be found in the Logging and Log File Analysis section. It should be understood that in most cases the default logging settings in ClearSCADA are only sufficient to capture a time window of a few minutes. One should always make sure that ClearSCADA logging is configured to capture events over a sufficient time window in order for log files be useful when troubleshooting issues.
The information provided below will explain how to increase the number of log files for ClearSCADA server, drivers and clients.
For more information about each type of ClearSCADA logging please go over the dedicated articles in the Logging and Log File Analysis section.
To configure server logging, please right click on the ClearSCADA Server Icon and select Configuration. Once the Server Configuration dialog is displayed, navigate to the page shown in the screen capture below and change Maximum Size Of Each File, Maximum Number of Files and Number of Old Files to Keep to sufficient values. The location of the server log files is shown in File Base.
Pic1.PNG
Sometimes a Schneider Electric engineer might ask you to enable/disable certain server logging options. To do such, please right click on the ClearSCADA Server Icon and select Status for the Status dialog to get displayed. Once the dialog is displayed, navigate to the section below for a list of all server side logging options available in ClearSCADA. To enabled/disable an option, right click on the option and select Enable/Disable respectively.
Pic2.PNG
To configure driver logging, please right click on the ClearSCADA Server Icon and select Status. In the Status dialog, navigate to the section below for a list of all ClearSCADA drivers installed on the server. Right click on the particular driver and select "_Logging..._". Under the Configuration tab, increase Maximum Size of Each File, Maximum Number of Files and Number of Old Files to keep to sufficient values. File Base shows the location of the driver log files.
Pic3.PNG
Sometimes a Schneider Electric engineer might ask you to enable/disable certain driver logging options. To do such, navigate to the Current Options tab in the Driver Logging dialog as per the screen capture below. To enable (disable) additional logging options, select (deselect) the required option from the Options list and apply the change.
Pic4.PNG
On some occasions a Schneider Electric engineer might ask you to increase the amount of ClearSCADA snapshot log files. To do that please right click on the ClearSCADA Server Icon and select Configuration. Navigate to the Registry section (shown in the screen shot below) and increase LogMaxFile, LogMaxSize and LogOldFiles to the requested amount. The location of the DBSnapshot log files is shown in LogFileBase.
Pic5.PNG
To configure DBClient logging, open up Windows Registry and navigate to \HKEYCURRENT_USER\Software\Schneider Electric\ClearSCADA\DBClientNamed_. Make sure the logging is enabled and increase LogMaxFiles, LogMaxSize and LogOldFiles values. The location of the DBClientNamed log files is shown in LogFileBase.
ViewX in CS2014 R1 onwards uses WPF and .NET technologies. The configuration of this new ViewX application uses SE.Scada.ViewX.exe.config XML files located adjacent to the SE.Scada.ViewX.exe application itself (_%ProgramFiles(x86)%\Schneider Electric\ClearSCADA\ SE.Scada.ViewX.exe.config_).
In File Browser, with no visible extensions:
NewViewXDBClient_1.png
In command line or with file extensions visible:
NewViewXDBClient_3.png
And the SchneiderElectric.Scada.ViewX.Properties.Settings element defines its configuration. Specifically, to control logging, the following elements' values need changing:
NewViewXDBClient_2.png
It is likely that the SE.Scada.ViewX.exe.config file will require administrator permissions to edit the settings. To edit settings, open the editor (e.g. Notepad) as administrator and then open the XML configuration file from within the editor.
Note that an upgrade of ClearSCADA will overwrite the existing XML configuration file with the default configuration. The XML configuration file will need to be re-configured after an upgrade of ClearSCADA takes place.
When the maximum number of log files that ClearSCADA generates is reached, the oldest log files get overwritten and information they contain gets lost. Therefore one should always make sure the log files of interest get collected before they get overwritten. The number of log files to keep is specific to each application as the amount of information logged depends on the nature of the application, the size of the database, drivers used, logging options enabled etc. Ideally one would want ClearSCADA log files to at least capture a time window of several days to cover weekends, long weekends and other long holidays to make sure the log files do not get overwritten when there is no one available to collect them. To check how much time is captured by a certain type of ClearSCADA log files, one could simply locate the set of these log files using their File Base and check Date Modified of the first and of the last log file of the same type.
Pic7.PNG
Be aware that enabling (_disabling_) additional server or driver logging options will reduce (_increase_) the time window captured by ClearSCADA logging. This means that the amount of log files of a particular type that ClearSCADA generates will need to be adjusted accordingly to capture the same time window.
Please be mindful of the space available on your hard drive. For example, if _Maximum Size Of Each File_ is set to 5000KB, _Maximum Number of Files_ is set to 25 and _Number of Old Files to Keep_ is set to 2, the required space on the hard drive is going to be:
Maximum Size Of Each File x Maximum Number of Files x (1 current set + _Number of Old Files to Keep_) or_
5000KB x 25 x (1 + 2) = 375000KB
Where 375000 / 1024 = 366MB
Planning which disk / partition is going to store log files is important, to avoid impacting other ClearSCADA file-relate operations -- e.g. consider using a separate disk for log files.
The content you are looking at may be outdated.
http://www.schneider-electric.ca/sites/canada/en/support/faq/faq_main.page?page=content&country=CA〈=...
A searchable archive can be accessed from:
http://www.schneider-electric.ca/sites/canada/en/support/faq/faq_main.page
This article is a brief summary of several detailed articles about configuring ClearSCADA logging that can be found in the Logging and Log File Analysis section. It should be understood that in most cases the default logging settings in ClearSCADA are only sufficient to capture a time window of a few minutes. One should always make sure that ClearSCADA logging is configured to capture events over a sufficient time window in order for log files be useful when troubleshooting issues.
The information provided below will explain how to increase the number of log files for ClearSCADA server, drivers and clients.
For more information about each type of ClearSCADA logging please go over the dedicated articles in the Logging and Log File Analysis section.
Setting up Server Logging
To configure server logging, please right click on the ClearSCADA Server Icon and select Configuration. Once the Server Configuration dialog is displayed, navigate to the page shown in the screen capture below and change Maximum Size Of Each File, Maximum Number of Files and Number of Old Files to Keep to sufficient values. The location of the server log files is shown in File Base.
Pic1.PNG
Sometimes a Schneider Electric engineer might ask you to enable/disable certain server logging options. To do such, please right click on the ClearSCADA Server Icon and select Status for the Status dialog to get displayed. Once the dialog is displayed, navigate to the section below for a list of all server side logging options available in ClearSCADA. To enabled/disable an option, right click on the option and select Enable/Disable respectively.
Pic2.PNG
Setting up Driver Logging
To configure driver logging, please right click on the ClearSCADA Server Icon and select Status. In the Status dialog, navigate to the section below for a list of all ClearSCADA drivers installed on the server. Right click on the particular driver and select "_Logging..._". Under the Configuration tab, increase Maximum Size of Each File, Maximum Number of Files and Number of Old Files to keep to sufficient values. File Base shows the location of the driver log files.
Pic3.PNG
Sometimes a Schneider Electric engineer might ask you to enable/disable certain driver logging options. To do such, navigate to the Current Options tab in the Driver Logging dialog as per the screen capture below. To enable (disable) additional logging options, select (deselect) the required option from the Options list and apply the change.
Pic4.PNG
Setting up Snapshot Logging
On some occasions a Schneider Electric engineer might ask you to increase the amount of ClearSCADA snapshot log files. To do that please right click on the ClearSCADA Server Icon and select Configuration. Navigate to the Registry section (shown in the screen shot below) and increase LogMaxFile, LogMaxSize and LogOldFiles to the requested amount. The location of the DBSnapshot log files is shown in LogFileBase.
Pic5.PNG
Setting up DBClient Logging
To configure DBClient logging, open up Windows Registry and navigate to \HKEYCURRENT_USER\Software\Schneider Electric\ClearSCADA\DBClientNamed_. Make sure the logging is enabled and increase LogMaxFiles, LogMaxSize and LogOldFiles values. The location of the DBClientNamed log files is shown in LogFileBase.
Setting up ViewX Logging (for ClearSCADA 2014 R1 onwards)
ViewX in CS2014 R1 onwards uses WPF and .NET technologies. The configuration of this new ViewX application uses SE.Scada.ViewX.exe.config XML files located adjacent to the SE.Scada.ViewX.exe application itself (_%ProgramFiles(x86)%\Schneider Electric\ClearSCADA\ SE.Scada.ViewX.exe.config_).
In File Browser, with no visible extensions:
NewViewXDBClient_1.png
In command line or with file extensions visible:
NewViewXDBClient_3.png
And the SchneiderElectric.Scada.ViewX.Properties.Settings element defines its configuration. Specifically, to control logging, the following elements' values need changing:
NewViewXDBClient_2.png
It is likely that the SE.Scada.ViewX.exe.config file will require administrator permissions to edit the settings. To edit settings, open the editor (e.g. Notepad) as administrator and then open the XML configuration file from within the editor.
Note that an upgrade of ClearSCADA will overwrite the existing XML configuration file with the default configuration. The XML configuration file will need to be re-configured after an upgrade of ClearSCADA takes place.
How Much Logging is Sufficient?
When the maximum number of log files that ClearSCADA generates is reached, the oldest log files get overwritten and information they contain gets lost. Therefore one should always make sure the log files of interest get collected before they get overwritten. The number of log files to keep is specific to each application as the amount of information logged depends on the nature of the application, the size of the database, drivers used, logging options enabled etc. Ideally one would want ClearSCADA log files to at least capture a time window of several days to cover weekends, long weekends and other long holidays to make sure the log files do not get overwritten when there is no one available to collect them. To check how much time is captured by a certain type of ClearSCADA log files, one could simply locate the set of these log files using their File Base and check Date Modified of the first and of the last log file of the same type.
Pic7.PNG
Be aware that enabling (_disabling_) additional server or driver logging options will reduce (_increase_) the time window captured by ClearSCADA logging. This means that the amount of log files of a particular type that ClearSCADA generates will need to be adjusted accordingly to capture the same time window.
Please be mindful of the space available on your hard drive. For example, if _Maximum Size Of Each File_ is set to 5000KB, _Maximum Number of Files_ is set to 25 and _Number of Old Files to Keep_ is set to 2, the required space on the hard drive is going to be:
Maximum Size Of Each File x Maximum Number of Files x (1 current set + _Number of Old Files to Keep_) or_
5000KB x 25 x (1 + 2) = 375000KB
Where 375000 / 1024 = 366MB
Planning which disk / partition is going to store log files is important, to avoid impacting other ClearSCADA file-relate operations -- e.g. consider using a separate disk for log files.
Planning and configuring log file collection at the time deployment of the system is planned is important. For instance, reserving insufficient disk space and switching 'off' many of the default categories of logging for normal operation of the system will be a problematic position: when a problem is detected and logs are required to investigate the problem, little information will be in the logs and re-dimensioning disks/partitions may be necessary to get the logging required to investigate the problem on a subsequent occurrence. Whereas, well planned and sufficient, default logging, will hopefully provide sufficient information to investigate a single occurrence of a problem.
Go: Home Back
Author
Create your free account or log in to subscribe to the forum - and gain access to more than 10,000+ support articles along with insights from experts and peers.