ltm rule command ISTATS incr

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

ISTATS::incr
       Increments the specified key by the given value.

SYNOPSIS
       ISTATS::incr KEY VALUE

DESCRIPTION
       Increments the specified key by the given value. The increment value must be non-negative for a counter.

       Note that text string iStats may not be incremented.

       Syntax

       ISTATS::incr  

	    * Increments the specified iStats key by the given value.

	    Note that there is no default increment value, so the value is
	    required, not optional.

RETURN VALUE
VALID DURING
       ANY_EVENT

EXAMPLES
	when HTTP_REQUEST {
		if { [string tolower [HTTP::uri]] equals "/12345" } {
			ISTATS::incr "uri /12345 counter Requests" 1
			HTTP::uri "/"
			HTTP::redirect "http://www.mysite.com"
		} elseif { [string tolower [HTTP::uri]] equals "/stats" } {
			  HTTP::respond 200 content "Requests for /12345: [ISTATS::get "uri /12345 counter Requests"]"
		}
	}

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

BIG-IP							    2022-04-12							  iRule(1)