| Include Page | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Version: 1.1 - Published:
This document relates to Charon Log Monitor version 1.0 dated 02-May-2022.
...
The Charon Log Monitor is a utility that monitors the Charon emulator session log files and that sends alerts in case a warning or error message is detected. It can also send alerts for informational messages when the emulator is started or properly stopped, when a CPU BUGCHECK or a CPU Halted message is detected or even if someone connects or disconnects from the emulator console.
It can also send alerts in case of Charon emulator service state change or , if the emulator log file is greater than a specified value and if the virtual machine (emulator) configuration file has been updated.
Alerts can either be an entry added in the Windows Application Events log file (source = CharonLogMonSVC), an email or a .BAT or .PS1 custom script. A mechanism can be set in place to stop sending alerts in case too many alerts are sent during a specified interval.
...
- Charon versions before 4.8 are not supported.
- The utility must be started with "Run as Administrator"
- During upgrade, it is possible the first attempt to stop the service will fail (due to timeout). If this occurs, just retry stopping the CharonLogMonSVC service and its installation will continue normally
- Powershell 4.0 minimum, 5.1 recommended*
To get the update, please open the page:
https://docs.microsoft.com/en-us/powershell/scripting/windows-powershell/install/installing-windows-powershell - .NET Framework 4.6 minimum installed, 4.8 recommended. Installed by default on Windows 10, 11, 2016, 2019 and 2022. For older versions of Windows, this has to be installed manually.
For more, see:
https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/versions-and-dependencies
...
If it is installed on Windows 7 or Windows Server 2008 R2, storing the email account password will not work , use due to missing features with these old versions of Windows. Use custom script in this case.
...
Once installed, by default in "C:\Program Files\CHARON\Charon Log Monitor", a Charon Log Monitor shortcut is placed on the desktop and in the Windows start menu.
| Div | ||
|---|---|---|
| ||
1 - Open the Charon Log Monitor interface
...
| class | pagebreak |
|---|
...
If a .BAT or .PS1 script needs to be executed, a button will appear to edit the script. If the script does not exist, a skeleton one script will be created. This script It is located in the Charon Log Monitor installation folder.
...
4 - If needed, you can use the Email settings tab to specify who you want to send emails to + and from who. If the sender account needs a password, you'll need to click the "Save" button (does not work with PowerShell 4.0, 5.1 only). It is recommended to use the "Test email alert" button to ensure emails are correctly sent. If the test email is not received, please check the service log from the "Service log" tab.
...
The password is encrypted and saved in the registry. It is valid for the local machine only. If it needs to be updated, you'll need to empty the password text box and type it again.
If the email mode is HTML, the email footer can contain HTML tags
...
5 - Go to the Virtual Machines tab , and select one virtual machine: . Note mouse hovering on the virtual machine name displays several information:
Virtual machines must exist and be have been created using the Charon Virtual Machine Manager utility.
...
Right click on one of them to either enable/disable log monitoring or start/stop the emulator, show the console, edit the .cfg file (if notepad++ is installed, it will use it otherwise it's notepad), open the log file, explore the home directory, etc..
Notes:
- Double clicking A double click on a virtual machine name opens the latest log file
- Double clicking A double click on the "Notes" box for a virtual machine opens the "Edit notes" option
- A circle icon in the details box means the log file is using the log rotation mechanism (highly recommended). Mouse hovering on this icon shows the max file size and rotation period if defined.
- Other warning icons can be displayed if:
- The log counters are enabled or
- The log file size is greater than the limit specified or
- The log method is set to overwrite (not recommended) or
- The configuration file has been updated after the emulator was started (an emulator restart is required for the changes to be taken into account)
- If alerts have been suspended, either manually or due to the limit reached, resuming sending alerts must be done manually
...