Board Platform Logs: Other Logs (2 of 2) and Log Encryption

Board Support

Other Logs (continued)

3.12 Connector Log

Scope: It logs any action of connector type datareader, you can check it when the connector datareader is not working as expected or the connection itself does not work

Accessibility: The log is active by default on the Board Server machine. The log file is located in the following path: ‘’Board_Path\Dataset\’Connector.log’. Available up to Board 10.xx

Usability: The log is unique per each Board environment. The Connector.log file size could potentially increase.

Highlights: It contains exceptions such as wrong username or password or expired token.

File structure (example): 

Log

4 22 Sep 2017 Fri 90 74 Thunderstorms 0 0 1 2017-09-21T08:17:51Z en-US 0 0 Yahoo! Weather - Austin, TX, US http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-2357536/ Yahoo! Weather for Austin, TX, US en-us Thu, 21 Sep 2017 03:17 AM CDT 60 mi in mph F Austin United States TX 81 165 18 83 990.0 0 16.1 7:19 am 7:29 pm Yahoo! Weather 142 18 http://weather.yahoo.comhttp://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif 30.30637 -97.752762 Thu, 21 Sep 2017 02:00 AM CDT <![CDATA[<img src="http://l.yimg.com/a/i/us/we/52/27.gif"/><BR /><b>Current Conditions:</b><BR />Mostly Cloudy<BR /><BR /><b>Forecast:</b><BR /> Thu - Thunderstorms. High: 91Low: 77<BR /> Fri - Thunderstorms. High: 90Low: 74<BR /> Sat - Partly Cloudy. High: 90Low: 73<BR /> Sun - Partly Cloudy. High: 89Low: 72<BR /> Mon - Scattered Thunderstorms. High: 89Low: 73<BR /><BR /> <a href="http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-2357536/">Full Forecast at Yahoo! Weather</a><BR /><BR /><BR />]]> 27 Thu, 21 Sep 2017 02:00 AM CDT 80 Mostly Cloudy false[Rec.002] Error : RBT1825 New Item Found on column 1 [0] 30 23 Sep 2017 Sat 90 73 Partly Cloudy 0 0 1 2017-09-21T08:17:51Z en-US 0 0 Yahoo! Weather - Austin, TX, US http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-2357536/ Yahoo! Weather for Austin, TX, US en-us Thu, 21 Sep 2017 03:17 AM CDT 60 mi in mph F Austin United States TX 81 165 18 83 990.0 0 16.1 7:19 am 7:29 pm Yahoo! Weather 142 18 http://weather.yahoo.comhttp://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif 30.30637 -97.752762 Thu, 21 Sep 2017 02:00 AM CDT <![CDATA[<img src="http://l.yimg.com/a/i/us/we/52/27.gif"/><BR /><b>Current Conditions:</b><BR />Mostly Cloudy<BR /><BR /><b>Forecast:</b><BR /> Thu - Thunderstorms. High: 91Low: 77<BR /> Fri - Thunderstorms. High: 90Low: 74<BR /> Sat - Partly Cloudy. High: 90Low: 73<BR /> Sun - Partly Cloudy. High: 89Low: 72<BR /> Mon - Scattered Thunderstorms. High: 89Low: 73<BR /><BR /><a href="http://us.rd.yahoo.com/dailynews/rss/weather/Country__Country/*https://weather.yahoo.com/country/state/city-2357536/">Full Forecast at Yahoo! Weather</a><BR /><BR /><BR />]]> 27 Thu, 21 Sep 2017 02:00 AM CDT 80 Mostly Cloudy false[Rec.003] Error : RBT1825 New Item Found on column 1 [0]

3.13 Client Error Log

Scope: Logs the exceptions that send the client in faulted state

Accessibility: The log is active by default on the Board client and it’s placed under the Board options tab, just click on open error log file. Available up to Board 10.xx

Usability: The Log is generated when there is an handled exception and the client goes in faulted state.

Highlights: It only tracks exception from the client, it’s useful to understand which action throws exception.

Log

****************************************************************** **********************EXCEPTION*********************************** ****************************************************************** Date: 17/07/2017 15:48:11 Exception Source: BoardServerInterface Assembly: BoardWinClient, Version=10.1.0.40310, Culture=neutral, PublicKeyToken=null Exception type: BoardSharedStructures.BoardClientException Exception Message: Cannot Save Capsule. Exception stack: at BoardServerInterface.BoardServerInterface.SaveCapsule(Capsule cps) at BoardCapsuleManager.CapsuleManager.SaveCps(Capsule cps) at BoardCapsuleManager.CapsuleManager.SaveCapsule(Capsule cps) at BoardWorkspaceControl.BoardWorkspace.OpenBlackBoardCapsule() at BoardWorkspaceControl.BoardWorkspace.<.ctor>b__7(ServerConnectedMessage p) Current Principal: System.Security.Principal.GenericPrincipal Date: 20/09/2017 15:53:31 Exception Source: PresentationCore Assembly: BoardWinClient, Version=10.1.2.40810, Culture=neutral, PublicKeyToken=null Exception type: System.OutOfMemoryException Exception Message: Insufficient memory to continue the execution of the program. Exception stack: at System.Windows.Media.Composition.DUCE.Channel.SyncFlush() at System.Windows.Interop.HwndTarget.UpdateWindowSettings(Boolean enableRenderTarget, Nullable`1 channelSet) at System.Windows.Interop.HwndTarget.UpdateWindowPos(IntPtr lParam) at System.Windows.Interop.HwndTarget.HandleMessage(WindowMessage msg, IntPtr wparam, IntPtr lparam) at System.Windows.Interop.HwndSource.HwndTargetFilterMessage(IntPtr hwnd, Int32 msg, IntPtr wParam, IntPtr lParam, Boolean& handled) at MS.Win32.HwndWrapper.WndProc(IntPtr hwnd, Int32 msg, IntPtr wParam, IntPtr lParam, Boolean& handled) at MS.Win32.HwndSubclass.DispatcherCallbackOperation(Object o) at System.Windows.Threading.ExceptionWrapper.InternalRealCall(Delegate callback, Object args, Int32 numArgs) at System.Windows.Threading.ExceptionWrapper.TryCatchWhen(Object source, Delegate callback, Object args, Int32 numArgs, Delegate catchHandler) Current Principal: System.Security.Principal.GenericPrincipal ****************************************************************** **********************EXCEPTION*********************************** ******************************************************************

Log Encryption

The following logs can be encrypted:
User logs
Capsule log
Database log

To activate encryption of the log files, open the Board Server Configuration program, go in the Security tab and enable the check-box and type your encryption pass-phrase as shown in the picture below

Notes:
The pass-phrase is also necessary to de-crypt the files, make sure you keep a safe copy of your pass-phrase accessible only to authorized personnel.
Once the encryption is enabled, the prefix "encrypted" is added to the file name: for example the log file Login.log becomes encryptedLogin.log
The encryption pass-phrase is saved locally on the server using DPAPI encryption.

To de-crypt the log files you may use the utility program BoardLogDecrypter.exe which is found in the folder
c:\Program Files\Board\Board Server\Tools\BoardLogDecrypter

The syntax of the command to de-crypt a log file is the following:

BoardLogDecrypter EncFile="[Encrypted File]" DestFile="[Destnation File]" Password="[Password]"

EncFile: the encrypted log that you want to decrypt
DestFile: The destination file that will contain the Decrypted Log
Password: the password you set up in the step before.
Note that the de-crypter generates a new file in clear text without altering the original encrypted file.