Configuring Preferences

Email Configuration

This section is useful for configuring settings for vuSmartMaps™ to integrate with the Email server for sending out notification emails.

These details may be configured with the Edit button.

Email preferences on the following aspects can be configured with the vuSmartMaps platform:

1. Username: User name to be used to login to the Email Server.
2. Display Name (Optional): Name to be displayed.
3. Email: Use this email address as the sender for emails generated by vuSmartMaps.
4. Password: Password for authentication with Email Server.
5. SMTP Host: SMTP Server Address.
6. SMTP Port: SMTP Server Port.
7. Security Protocol: Security protocol to be used for communication with Email Server.
   
   • SSL
   • TLS
   • None

Testing Configuration

Click the Test button to send a test email to a specified email address. Enter the recipient email ID in the prompted modal. A success message confirms delivery, while a failure message provides error details for resolution.

ITSM Configuration

This section is useful for configuring Settings for vuSmartMaps to integrate with the ITSM system. This will be used to open tickets based on alert conditions and collect details of tickets present in the ITSM system.

These details may be configured with the Edit button.

ITSM preferences on the following aspects can be configured with the vuSmartMaps platform.

1. Type: Type of ITSM System. The following are the types supported with vuSmartMaps.
   
   • None
   • Service Now
     
     • URL: Provide the server URL. For BMC Remedy provides both IP and port in http://serverip:port format
     • Instance Name: Instance name associated with Service Now ITSM systems.
     • Username: Provide the username.
     • Password: Password for this username.
   • OTRS
     
     • URL: Provide the server URL. For BMC Remedy provides both IP and port in http://serverip:port format
     • Name: Provide the Webservice name.
     • Username: Provide the username.
     • Password: Password for this username.
     • Queue: Configure the queue used for tickets within the OTRS system.
     • Customer User: Configure the Customer user using which tickets are to be generated.
   • Manage Engine
     
     • URL: Provide the server URL. For BMC Remedy provides both IP and port in http://serverip:port format
     • Username: Provide the username.
     • Password: Password for this username.
     • API Key: Provide the API key to be used.
     • Matching Tags: Tags that will be used with Tickets.
   • Remedy
     
     • URL: Provide the server URL. For BMC Remedy provides both IP and port in http://serverip:port format
     • Username: Provide the username.
     • Password: Password for this username.
     • First Name: Provide the First name.
     • Last Name: Provide the last name.
     • Additional fields used during ticket creation: Add the additional fields as key-value pairs, each separated by a comma. eg: Reported Source: Direct Input, Service_Type: User Service Restoration
       
       • Ticket Create Fields
       • Worklog Update Fields
   • Jira
     
     • Instance Name:
     • Provide the instance name of your Jira account. This should be the subdomain where your Jira instance is hosted, such as yourcompany.atlassian.net Here, the instance name is yourcompany
     • Username: Specify the username of the account that will authenticate requests to the Jira API. Ensure this user account has the necessary permissions to create tickets in the designated Jira project. Mostly it is an email address.
     • API Key: The API Key is a unique token generated by the user, typically corresponding to the user’s email address. This key functions as the authentication token for API requests, ensuring secure access to the API.
     • Project Name: Specify the name of the Jira project where tickets will be created. This ensures that tickets generated by the alert engine are directed to the appropriate project within your Jira instance.
       
       💡Note: All the Jira tickets will be created in the project you are specifying, and that project must be able to allow the ticket type as BUG. All the Jira tickets will be created in the project you are specifying, and that project must be able to allow the ticket type as BUG.

Testing Configuration

Click the Test button to validate the configuration (limited to JIRA ITSM). For Jira, a test ticket is created to ensure a successful connection. Errors, such as permission issues or missing fields, are displayed if applicable.

Reports Configuration

With this configuration, the user can provide the date time format in which the date fields of the report need to be displayed. The default format for these preferences is DD/MM/YYYY hh:mm:ss.

Analytics reports preferences on the following aspects can be configured with the vuSmartMaps platform.

1. Date Format: The format for the Date field in Analytics Reports.

These details may be configured with the Edit button.

Ansible Tower Preferences

In vuSmartMaps, Ansible Tower integration is a powerful feature that allows you to manage and execute Auto Remediation jobs seamlessly through its REST API interface. While this feature is not yet available in the current release, it will be implemented in a future release, enhancing the overall automation process.

To configure your Ansible Tower preferences and take advantage of this feature when it becomes available, follow these steps:

1. Navigate to the Ansible Tower Preferences section on the Preferences landing page. The Preferences can be configured in the modal by clicking on the Edit button.
2. Fill in the details on the following aspects:
   
   • URL: Provide the correct URL. For Auto Remediation provide both IP and port in http://serverip:port format
   • Username: Provide the username
   • Password: Password for this username

     
     

3. Click on the Save button to apply these preferences.

Testing Configuration

Click Test to check the connection and credentials. Successful tests display a confirmation message, while failures show connection, response, or authentication errors.

System Configuration

System preferences on the following aspects can be configured with the vuSmartMaps platform.

1. Archival Path: Full path where index archives are to be stored in the Analyser.
   
   💡Note: If nothing is provided, the default value of /data/vunet-backups will be used.
   
   
2. Trap Credentials: Credentials to be used by SNMP trap-based discovery.
   
   💡Note: Should be in this format (separated by comma & colon); type-of-credential:credential-name; For Ex – snmp:cred1, snmp:cred2
   
   
3. SNMP trap discovery time interval: Time interval for SNMP Trap based discovery; Polling interval, in minutes, to be used to check for IPs to discover in SNMP trap data.

These details may be configured with the Edit button.

Whatsapp Configuration

Alerts created on the platform are sent to multiple notification channels including WhatsApp. The Platform uses the official WhatsApp business API to send notifications. This is a one-time configuration. This doesn’t need to be updated for each and every alert rule unless there is a need to update. The below three fields for WhatsApp Preferences can be updated on the Preferences page:

1. Phone number ID
2. Access token
3. The JSON payload sends a template message, according to the template configured with WhatsApp.

Refer to WhatsApp Configuration for the advanced settings for creating and configuring Whatsapp business API with Meta.

Testing Configuration

Click Test to enter a phone number for testing. The system verifies the configuration and sends a test message. Success confirms message delivery, while failure provides error details for resolution.

Microsoft Teams Configuration

Alerts created in the platform are sent to multiple notification channels including MS Teams. For Each addition of incoming webhooks to a channel, it will generate a unique URL. These URLs are then added in the Preferences section as a JSON with the channel name as key and URL as value.

{
"General": "https://vunetsystems.teams.com/message/channel/general",
"Priority-alerts": "https://vunetsystems.teams.com/message/channel/priority-alerts"
}

Refer to MS Teams Configuration for the advanced settings for configuring the Webhook connector and creating the message template.

Testing Configuration

Click Test to validate the URL and send a test message. Success confirms message delivery, while failures display errors for invalid URLs or channel names.

Slack Configration

To configure alerts from the platform to be sent to your Slack workspace, you need to generate an API token. Insert this token in the Slack Preferences. Once this integration is in place, your platform alerts will be seamlessly relayed to your chosen Slack channels, ensuring efficient communication and timely notifications for your team.

Refer to Slack Configuration for the advanced settings for configuring the Slack App and creating the message template.

Testing Configuration

Click Test and enter a Slack channel name. The system sends a test message. Successful tests confirm message delivery, while failures display errors for invalid API keys or channel names.