VersionDocument version: 1.4 5 - Published: 17 Jun 18 Oct 2022 

This document relates to Charon Log Monitor version 1.3 4 dated 1718-JunOct-2022. To get the download link, please contact us.

...

1 - Open the Charon Log Monitor interface

2 - Install the service

Image RemovedImage Added

3 - Define the settings from the settings tab: what you want to monitor and if you want Windows Application Events to be generated and/or a customer .PS1 or .BAT script to be executed + several other options you can activate

Image Modified

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 script will be created. 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.

Image RemovedImage Added

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.

...

5 - Go to the Virtual Machines tab and select one virtual machine. Note mouse hovering on the virtual machine name displays several information:

Image RemovedImage Added

Virtual machines must 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..

Image RemovedImage Added

Notes:

• A double click on a virtual machine name opens the latest log file
• 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

Example:

Image RemovedImage Added

HTML email example

Image RemovedImage Added

To remove the "Notes" part in the email body, uncheck the related option from the "Email settings" tab.

...