Managing App Visibility notification channels

TrueSight App Visibility Manager and TrueSight Synthetic Monitor event notifications can be sent on a number of different channels. You can send event notifications via email, Syslog, and SNMP (v2). If you have TrueSight Infrastructure Management in your environment, App Visibility and Synthetic Monitor events are recorded there automatically.

Customizing the date format for event notification (applicable to version 11.3.03 and later)

In Synthetic Metric Rules event notifications, the event start  and end time are reported and displayed in the following date formats:

  • English - dd/MM/yyyy
  • German - dd.MM.yyyy
  • Simplified Chinese - yyyy/M/d

However, you can customize this date format using the following procedure. The customized date format is applied to all the supported languages. 

To customize the date format for event notification 

Customize the date format

  1. Log into the host where you have installed the Portal and navigate to the following directory:

    • Windows
      installationDirectory\portal\properties
    • Linux
      installationDirectory/portal/properties

  2. Edit the portal.properties file and add any one of the following supported date formats in the events.notification.date.format field and save the changes:

    Supported date formats

    Note

    Ensure that the date format you choose complies with the java simple date format. For more information, see Java Date Time Formatter.

    Format

    Sample display

    MM.dd.yyyy G 'at' HH:mm:ss z

    07.04.2019 AD at 12:08:56 GMT-12:00

    EEE, MMM d, 'yy h:mm a

    Wed, Jul 4, '01 12:08 PM

    EEEE, MMM dd, yyyy HH:mm:ss a

    Saturday, Jul 14, 2018 14:31:06 PM

    E, MMM dd yyyy

    Sat, Jul 14 2018

    h:mm a

    12:08 PM

    MM/dd/yyyy[' ']HH:mm:ss[' ']['(UTC']xxx[')']

    12/06/2019 14:22:00 (UTC+03:00)

    dd MMM yyyy[' ']HH:mm:ss[' ']['(UTC']xxx[')']

    12 Jun 2019 14:33:00 (UTC+03:00)

    hh 'o''clock' a, zzzz

    12 o’clock PM, Pacific Daylight Time

    yyyy-MM-dd'T'HH:mm:ssZ

    2018-07-14T14:31:30+0530

    d MMM uuuu HH:mm a

    3 Dec 2011

    The customized date format is applied for all the supported languages.

  3. Restart the portal service.
    The custom date format is updated for the event start and close time in the next event notification.

Editing notification channel settings (applicable to versions 11.3.02 and later)

Notification channel settings for version 11.3.02 and later

To edit App Visibility notification channel settings

  1. From the TrueSight navigation menu, select Administration > App Visibility Notifications.
  2. From the App Visibility Notification Channels action menu, select Edit Notification Channels.
    AV_Edit_Notification_Channels (1) (1).png
  3. If the notification channel you want to edit is not enabled, click the button to enable it.
    appvis_select_SNMP.png
  4. Edit the details.
  5. Click Save to return to View mode.

The following settings are displayed for the notification channels:

Parameter

Description

Notification Languagecallout_1.PNG

Notification Language

The event notifications for Synthetic Metric Rules are translated and displayed in one of the three locale options available: English, Chinese (Mandarin), and Deutsche (German). Default locale is English.

The event notifications for all other event types, such as AppVisibility, Service Level Agreements, or Health are displayed only in English.

Note: The notification language selection is not impacted by the language that you selected in the TrueSight console > User Preferences option.

Email (SMTP)callout_2.PNG

Host Name / IP Address

Host name or IP address of the SMTP server

Port

Port number of the SMTP server

Login Account

(Optional) User name of the account App Visibility uses to connect to the SMTP server


Login Password

Password of the account App Visibility uses to connect to the SMTP server

Note: This field is visible only in Edit mode.

From Account

Email address that appears in the From field of notification emails

To (Global Email Recipients List)

List of email addresses that receive event notifications

Email address can be separated by commas or semicolons.

Syslogcallout_3.PNG

Host Name / IP Address

Host name or IP address of the Syslog server

Port

Port number of the Syslog server

Protocol

Syslog protocol used for sending the event notifications

Possible values are:

  • TCP
  • UDP (default)

SNMPcallout_4.PNG

Host Name / IP Address

Host name or IP address of the SNMP server

Port

Port number of the SNMP server

Community String

SNMP community string for restricting access to SNMP traps and messages. The default value is set to public. You can edit the string, but it must not be blank.

*To configure SNMP connection on your system, you can download and use the attached AppVisibility.mib file.

To view App Visibility notification channel settings

From the TrueSight navigation menu, select Administration > App Visibility Notifications.

The current notification channel settings are displayed.

AV_Notification_Channels.png

Next to each notification channel a switch shows whether the channel is enabled.

appvis_SNMP_enabled.png

Appvis_Syslog_disabled.png

Channel enabled

Channel disabled

Editing notification channel settings (applicable to version 11.3.01)

Notification channel settings for version 11.3.01

To edit App Visibility notification channel settings

  1. From the TrueSight navigation menu, select Administration > App Visibility Notifications.
  2. From the App Visibility Notification Channels action menu, select Edit Notification Channels.
    AV_Edit_Notification_Channels (1) (1).png
  3. If the notification channel you want to edit is not enabled, click the button to enable it.
    appvis_select_SNMP.png
  4. Edit the details.
  5. Click Save to return to View mode.

The following settings are displayed for the notification channels:

Parameter

Description

Email (SMTP)

Host Name / IP Address

Host name or IP address of the SMTP server

Port

Port number of the SMTP server

Login Account

User name of the account App Visibility uses to connect to the SMTP server


Login Password

Password of the account App Visibility uses to connect to the SMTP server

Note: This field is visible only in Edit mode.

From Account

Email address that appears in the From field of notification emails

To (Global Email Recipients List)

List of email addresses that receive event notifications

Email address can be separated by commas or semicolons.

Syslog

Host Name / IP Address

Host name or IP address of the Syslog server

Port

Port number of the Syslog server

Protocol

Communication protocol used for sending the Syslog event notifications

Possible values are:

  • TCP
  • UDP (default)
  • UNIX Syslog
  • Unix Socket

SNMP*

Host Name / IP Address

Host name or IP address of the SNMP server

Port

Port number of the SNMP server

Community String

SNMP community string for restricting access to SNMP traps and messages

OID Event Trap

Unique identifier of SNMP event traps issued by App Visibility and Synthetic Monitor

Value: 1.3.6.1.4.1.1031.2.3.2.1

This parameter cannot be modified.

OID Event Message

Unique identifier of SNMP event messages issued by App Visibility and Synthetic Monitor

Value: 1.3.6.1.4.1.1031.2.3.1.1

This parameter cannot be modified.

*To configure SNMP connection on you system, you can download and use the attached AppVisibility.mib file.

To view App Visibility notification channel settings

From the TrueSight navigation menu, select Administration > App Visibility Notifications.

The current notification channel settings are displayed.

AV_Notification_Channels.png

Next to each notification channel a switch shows whether the channel is enabled.

appvis_SNMP_enabled.png

Appvis_Syslog_disabled.png

Channel enabled

Channel disabled

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*