| Include Page | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
VersionDocument version: 1.1 7 - Published:
This document relates to Charon Log Monitor version 1.0 dated 02-May-2022. 4 dated 18-Oct-2022, version 1.5 dated 14-Nov-2022 and version 1.6 dated 18-Jan-2023. To get the download link, please contact us.
...
It can also send alerts in case of Charon emulator service state change, if the emulator log file is greater than a specified value and , if the virtual machine (emulator) configuration file has been updated and if the emulator executable file is not present (placed in quarantine by an antivirus software for example).
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.
...
1 - Open the Charon Log Monitor interface
2 - Install the service
| Div | ||
|---|---|---|
| ||
3 - Define the settings from the settings tabtabs: 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
| Div | ||
|---|---|---|
| ||
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.
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:
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..
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
| Div | ||
|---|---|---|
| ||
Example:
| Div | ||
|---|---|---|
| ||
HTML email example
To remove the "Notes" part in the email body, uncheck the related option from the "Email settings" tab.
...
Windows Application Events example
| Div | ||
|---|---|---|
| ||
|
Tips
- Right clicking anywhere but the virtual machine list box will display About and Release Notes
- Mouse hovering on virtual machines names, buttons and icons displays additional information and help
- It is also possible to export and import general and email settings for ease of deployment (
the email account password will not be exported)
...