Setting Up Event Log Entry Notifications

You can configure an email to be sent when informational messages, errors, and/or warnings from the iSupport services, Desktop, and mySupport portal are logged. (For example, you could enable an email to be sent whenever an error occurs during a scheduled asset scan.) The message will be included in the body of the email. If you wish to send view contents in an email on a scheduled basis regardless of any entries in the view, configure a view subscription for an Event Log view in the Desktop View component.

To configure the email to be sent, you’ll need to enable the event via the iSupport Configuration Utility in the <directory in which iSupport is installed>\Utilities folder and change variables in the LoggingManagement section in the web.config file in the directories in which the Desktop and mySupport portal functionality are installed (Rep and User by default).

Replace the variables in bold below:

emailToAddress="[email protected]"

emailSubject="Desktop/iSupport Service" (Note that a different variable may be included depending on the web.config you are editing.)

emailPriority="High" />

• The emailSubject, includeServerNameInSubject, and includeFirstLineInSubject variables affect the subject line of the email. By default all are enabled, separated by colons - the server is listed first, then the emailSubject variable, and then the first line of the log entry. An example is shown below:

LBL-00: Desktop: System.Web.UI.ViewStateException Occurred

• • Change the emailSubject="Desktop/iSupport Service" variable if you wish to enter custom text for the subject line.

  • Change the includeServerNameInSubject="true" variable to "false" if you wish to omit the server name from the subject line of the email.

  • Change the includeFirstLineInSubject="true" variable to "false" if you wish to omit the first line of the log entry from the subject line of the email.

• Enter applicable email addresses for the emailToAddress variable. You can include multiple email addresses; separate each with a comma.

• Change emailPriority="High" to reflect the priority at which the email should be sent.

• If you wish to send the email through a different email provider than what is specified in your default outbound mail settings, add a publisher element to the logging management section of the web.config file in the Desktop is installed (Rep by default):

 <module name="iSupportDesktop" mode="on">

 For rep desktop logging, add the following and replace the variables in bold:

<publisher mode="on" assembly="GWICommon" type="Gwi.LoggingManagement.SmtpEmailPublisher" smtpServer="mailserver" emailFromAddress="fromAddress" emailToAddress="toAddress" emailSubject="iSupport Desktop" includeServerNameInSubject="true" includeFirstLineInSubject="true" supportedLogLevels="*" emailPriority="high" />

       </module>

       <module name="iSupportService" mode="on">

      For iSupport Agent logging, add the following and replace the variables in bold:

<publisher mode="on" assembly="GWICommon" type="Gwi.LoggingManagement.SmtpEmailPublisher" smtpServer="mailserver" emailFromAddress="fromAddress" emailToAddress="toAddress" emailSubject="iSupport Desktop" includeServerNameInSubject="true" includeFirstLineInSubject="true" supportedLogLevels="*" emailPriority="high" />

</module>

</loggingManagement>

Troubleshooting

If entries are not included in the log or email is not sent, exception messages (including the original message) are written to the Application log in the Microsoft® Windows Event Viewer. On the server, check the Microsoft Windows Event Viewer by selecting Start | Programs | Administrative Tools | Event Viewer | Application.