lb notification

The lb notification command creates the notification profiles that determine who will be informed when something happens on a vService. The profile watches two kinds of event: the changes in the service status and the traffic measures that exceed a threshold. Its panel equivalent is the Alert & Notifications screen.

Command Summary

TR7 WEB-CLI · lb notification

# Tab after the command

admin@TR7LBWAF01> lb notification

add delete list show update

 

admin@TR7LBWAF01> lb notification list # list all of them

admin@TR7LBWAF01> lb notification show <id> # show one

admin@TR7LBWAF01> lb notification add name <name> … # new profile

admin@TR7LBWAF01> lb notification update id <id> … # change

admin@TR7LBWAF01> lb notification delete <id> # delete

admin@TR7LBWAF01>  

Writing Order

Step 1 Write the name

This is the only required field: lb notification add service-alerts

Step 2 Select the events to be watched

The status changes and the threshold measures.

Step 3 Add the sending channels

--email.0 … --sms.0 … --snmp true --ui true

Step 4 Bind it to a vService

lb service update id <vService> --notification <profile>

Required Fields

Order	Field	Status	Value
1	name	Required	The name of the profile; it must be unique in the collection

The Status Notifications

Field	What it does	What is written after it
--serviceStatus	Produces a notification when the status of the Backend Services changes	true · false (default false)
--poolStatus	Produces a notification when the status of the listening service changes	true · false (default false)
--notifyDaysBeforeCertificateExpiry	Determines how many days before the certificate expires the warning will be given	The number of days (at least 1). When it is left empty, this warning is not produced

The Threshold Measures

Each of the fields below puts a threshold on a measure; when the measure exceeds the given value, a notification is produced. They are all integers, the smallest value is 1, and when they are left empty that measure is not watched.

Field	What it does	What is written after it
--bw	Puts the bandwidth threshold	A number
--reqRate	Puts a threshold on the number of requests per second	A number
--scur	Puts a threshold on the instant number of sessions	A number
--newConn	Puts a threshold on the number of new connections	A number
--activeIps	Puts a threshold on the number of active source addresses	A number
--resp4xx	Puts a threshold on the number of 4xx responses per second	A number
--resp5xx	Puts a threshold on the number of 5xx responses per second	A number
--srcConnrate	Puts a threshold on the number of connections per second per source address	A number
--srcReq	Puts a threshold on the number of requests per second per source address	A number
--srcErr	Puts a threshold on the number of errors per second per source address	A number
--srcBin	Puts a threshold on the incoming traffic per source address	A number
--srcBout	Puts a threshold on the outgoing traffic per source address	A number

The Sending Channels

Field	What it does	What is written after it
--email.N	Determines the email addresses to which the notification will be sent	An email address; each with its own index
--sms.N	Determines the phone numbers to which the notification will be sent	A phone number; each with its own index
--snmp	Turns on the notification being sent as an SNMP trap	true · false (default false)
--ui	Turns on the notification being shown in the interface	true · false (default false)
--silentAtNight	Makes no notification be sent during the night hours	true · false (default false)

Examples

TR7 WEB-CLI · A) The status notifications

admin@TR7LBWAF01> lb notification add name service-alerts \

--serviceStatus true --poolStatus true --notifyDaysBeforeCertificateExpiry 30 \

--email.0 noc@kurum.com.tr --ui true

admin@TR7LBWAF01>  

TR7 WEB-CLI · B) The threshold measures and the night silence

admin@TR7LBWAF01> lb notification add name traffic-thresholds \

--reqRate 5000 --resp5xx 50 --srcReq 200 --activeIps 10000 \

--snmp true --sms.0 <number> --silentAtNight true

admin@TR7LBWAF01>  

Updating and Deleting

TR7 WEB-CLI · update and delete

admin@TR7LBWAF01> lb notification update id <id> --reqRate 8000

 

# adding an address · removing a single address · emptying the list

admin@TR7LBWAF01> lb notification update id <id> --email.1 soc@kurum.com.tr

admin@TR7LBWAF01> lb notification update id <id> --email.0.delete

admin@TR7LBWAF01> lb notification update id <id> --sms.delete

 

admin@TR7LBWAF01> lb notification delete <id>

admin@TR7LBWAF01>  

Things to Know

• A profile does not work on its own. The notification production starts when the profile is bound to a vService with the --notification field. Additional profiles can also be bound to a vService with --extraNotificationProfiles.N.
• A threshold left empty is not watched. When no value is written in a measure field, no notification is produced for that measure.
• The smallest threshold value is 1. Zero or a negative value cannot be written in the threshold fields.
• If no channel is selected, no notification goes out. At least one of the email, SMS, SNMP and interface channels has to be turned on.
• The name is unique. A second profile with the same name cannot be created.