ltm rule command TCP analytics

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



TCP::analytics
       Enable/disable AVR TCP stat reporting, and/or attach a user-defined
       string to categorize the connection for statistics collection purposes.

SYNOPSIS
       TCP::analytics (enable | disable | key (KEY)?)

DESCRIPTION
       Enables or disables AVR TCP stat reporting ("analytics") for this
       connection and/or assigns user-defined keys.

       TCP::analytics enable
	   Enables analytics on this connection. AVR must be provisioned and
       the virtual must have a tcp-analytics profile attached. Collection will
       use the configuration in the profile. If the profile is configured to
       disable analytics by default, this gives users the ability to collect
       statistics by exception only.

       TCP::analytics disable
	   Disables analytics on this connection. If AVR is provisioned and
       the virtual has a tcp-analytics profile that enables analytics by
       default, this allows users to disable collection by exception only.

       TCP::analytics key 
	   Attaches a user-provided string as an analytics entity. All
       statistics reported after executing this command will be separable from
       all statistics that do not have the key attached. Replaces any existing
       key attached to this connection. If analytics is not enabled, AVR is
       provisioned, and the virtual has a tcp-analytics profile attached, this
       command also enables analytics.

       TCP::analytics key
	   Removes any user-provided analytics entity attached via a previous
       TCP::analytics command. If analytics is not enabled, AVR is
       provisioned, and the virtual has a tcp-analytics profile attached, this
       command also enables analytics.

RETURN VALUE
VALID DURING
       ANY_EVENT

EXAMPLES
	# start collection for one subnet only.
	when CLIENT_ACCEPTED {
	    if [IP::addr [IP::client_addr]/8 equals 10.0.0.0] {
		TCP::analytics enable
	    }
	}
	when HTTP_REQUEST {
	    # must check subnet again to avoid starting for all
	    # connections
	    if [IP::addr [IP::client_addr]/8 equals 10.0.0.0] {
		# make stats queryable by URI
		TCP::analytics key "[HTTP::uri]"
	    }
	}

HINTS
       Statistics on connection duration will only reflect the time which
       analytics is enabled.

SEE ALSO
CHANGE LOG
       @BIGIP-12.1.0
	   -- First introduced the command.



BIG-IP				  2017-01-31			      iRule(1)