Alert Properties
This section lists and describes the Fivetran HVR alert properties.
An alert property specifies the characteristics/attributes of various alerts generated in HVR. These properties are set when creating/modifying alerts from the (Alerts) tab in UI or using the command hvralertconfig.
An array property and map property can store multiple values. The syntax for updating them from the Command Line Interface (CLI) varies.
Property | Argument | Description |
---|---|---|
Add_HVR_Event | If set to true, creates an HVR event every time an alert notification is sent. This event can be viewed on the Events page. | |
Email_From_Address | address | Email address of the sender in the notification email header. This property can be defined only if Notification_Type is set to EMAIL. |
Email_Recipients | address1 [,address2] | Email address(es) to which HVR will send an email notification. This property can be defined only if Notification_Type is set to EMAIL. Multiple email addresses can be specified with values separated by a comma. This property requires Email_SMTP_Server. This is an array property that can store multiple values. |
Email_SMTP_Password | password | Password for the SMTP user (Email_SMTP_User). This property can be defined only if Notification_Type is set to EMAIL. |
Email_SMTP_Port | port | SMTP port to use when sending an email notification. If this property is not defined, the default SMTP port is 25. If Email_SMTP_Starttls is set to true, the default SMTP port is 465. This property can be defined only if Notification_Type is set to EMAIL. |
Email_SMTP_Server | server | SMTP server to use when sending an email notification to the recipient(s) defined in Email_Recipients. Value server can be either a node name or IP address. This property can be defined only if Notification_Type is set to EMAIL. |
Email_SMTP_Starttls | If set to true, use the STARTTLS method to communicate with the SMTP server. This property can be defined only if Notification_Type is set to EMAIL. | |
Email_SMTP_User | user | Username for authenticating SMTP server, if needed. This property can be defined only if Notification_Type is set to EMAIL. |
Ignore_Patterns | pattern | Pattern to match error/warning records in the hvr.out file. If defined, HVR alert system will ignore the matching error/warning records, which means alert notification will not be sent for these errors/warnings. For example, if pattern F_JT.*|W_JD.* is defined, alert notification will not be sent for all errors starting with F_JT or warnings starting with W_JD. |
Ignore_Warnings | Notifications are sent only for errors. If set to true, HVR will not send alert notifications when the alert system encounter a warning while scanning the log file hvr.out or when the latency limit is exceeded. | |
Max_Channel_Idle_MinutesSince v6.1.5/2 | minutes | Send notifications when the channel has empty Capture cycles (no data captured) for a duration that exceeds the time (in minutes) specified in this parameter. |
Max_Hub_Idle_MinutesSince v6.1.5/2 | minutes | Send notifications when there is no activity in the HVR Hub for a duration that exceeds the time (in minutes) specified in this parameter. |
Message_Error_Limit | limit | HVR errors reported are limited to the limit number. This option prevents the generated notification (email, SNS, or Slack) from becoming too large. If this property is not defined, the defaultlimit for email and SNS notification is 1000. For Slack notification, the default and maximum limit is 40. |
Notification_Type | type | Type of the alert notification that the HVR alert system will send. Available options for type are:
|
Repeat_Interval | secs | Send alert for the same error/warning only after the specified duration in seconds secs. By default, each time when HVR alert system encounters an error itself or detects an HVR error or warning while scanning hvr.out or the latency limit is exceeded, the alerting system sends out an alert until the issue is fixed. The number of alerts sent depends on the frequency at which the hvralertmanager is configured to run. As long as the issue is not resolved or the error/warning has not changed, the alerting system will repeatedly send alerts for the same issue. To avoid repeatedly sending alerts for the same issue, this option forces HVR alerting system to remain silent for the specified duration after the first alert is sent out. |
Slack_Channel | channel | Slack user (@username) or channel to which HVR will send Slack message notifications. This optional property can be used to override the value defined in the Slack_Webhook_URL. This property can be defined only if Notification_Type is set to SLACK. |
Slack_Webhook_URL | url | Incoming webhook URL for the Slack channel to which HVR will send Slack message notifications. To generate a Slack incoming webhook, see Slack documentation. This property can be defined only if Notification_Type is set to SLACK. |
SNMP_Community | str | Community string str for SNMP agent to receive traps. This property can be defined only if Notification_Type is set to SNMP. |
SNMP_Heartbeat | If set to true, send a hvrMaintNotifySummary notification, even if there was nothing to report. This property can be defined only if Notification_Type is set to SNMP. | |
SNMP_Hostname | host | Host name of the SNMP agent. The Default host is localhost. This property can be defined only if Notification_Type is set to SNMP. |
SNMP_Port | port | Port number for the SNMP agent to receive traps. The Default port is 162. This property can be defined only if Notification_Type is set to SNMP. |
SNMP_Version | version | SNMP version. Available options for version are:
|
SNS_Access_Key_Id | keyid | Access key ID of the AWS IAM user. For more information about the access key, refer to Managing Access Keys for IAM Users in AWS documentation. This property can be defined only if Notification_Type is set to SNS. |
SNS_Destination | arn | Amazon Resource Name (ARN) of the SNS topic to which HVR will send alert notification. This property can be defined only if Notification_Type is set to SNS. |
SNS_Secret_Access_Key | key | Secret access key of the AWS IAM user. For more information about the secret key, refer to Managing Access Keys for IAM Users in AWS documentation. This property can be defined only if Notification_Type is set to SNS. |
Specific_Channels | chn | Only scan the specified channel(s) chn for errors and warnings. This is an array property that can store multiple values. |
Specific_Locations | loc | Only scan the specified locations(s) loc for errors and warnings. This is an array property that can store multiple values. |