Docs > Platform Settings > Preferences > Configuring Preferences

Configuring Preferences

Email Preferences

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. Email: Use this email address as the sender for emails generated by vuSmartMaps.
  3. Password: Password for authentication with Email Server.
  4. SMTP Host: SMTP Server Address.
  5. SMTP Port: SMTP Server Port.
  6. Security Protocol: Security protocol to be used for communication with Email Server.
    • SSL
    • TLS
    • None

ITSM Preferences

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.

Analytics Reports Preferences

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.

System Preferences

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:cred1snmp: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 Preferences

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.

Microsoft Teams Preferences

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.

Slack Preferences

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.

Resources

Browse through our resources to learn how you can accelerate digital transformation within your organisation.