diff options
author | Maria Scott <[email protected]> | 2021-09-07 11:42:49 +0200 |
---|---|---|
committer | Loïc Hoguin <[email protected]> | 2021-09-07 12:27:39 +0200 |
commit | ad1dc0c538610bdaf5e7b197ca997820d4a3d348 (patch) | |
tree | 698cad56f4fdf951a6d77f9d4a5dd5e5c95b94cd /doc/src/manual/ranch.asciidoc | |
parent | f3bef7c456204ee653fafcfa53322daddf6e1c0e (diff) | |
download | ranch-ad1dc0c538610bdaf5e7b197ca997820d4a3d348.tar.gz ranch-ad1dc0c538610bdaf5e7b197ca997820d4a3d348.tar.bz2 ranch-ad1dc0c538610bdaf5e7b197ca997820d4a3d348.zip |
Manual for num_connection alarms
Diffstat (limited to 'doc/src/manual/ranch.asciidoc')
-rw-r--r-- | doc/src/manual/ranch.asciidoc | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/doc/src/manual/ranch.asciidoc b/doc/src/manual/ranch.asciidoc index 26e0769..af006a2 100644 --- a/doc/src/manual/ranch.asciidoc +++ b/doc/src/manual/ranch.asciidoc @@ -88,6 +88,14 @@ Unique name used to refer to a listener. [source,erlang] ---- transport_opts(SocketOpts) = #{ + alarms => #{ + term() => #{ + type := num_connections, + treshold := non_neg_integer(), + callback := fun((ref(), term(), pid(), [pid()]) -> any()), + cooldown => non_neg_integer() + } + }, connection_type => worker | supervisor, handshake_timeout => timeout(), max_connections => max_conns(), @@ -107,6 +115,38 @@ options and transport-specific socket options. None of the options are required. +alarms (#{}):: + +Alarms to call a function when the number of connections under a +connection supervisor reaches or exceeds a defined treshold. ++ +The map keys are the alarm names, which can be any `term`. The +associated values are the respective alarm options, again in a map +with the following keys: + +type::: + +Must be set to `num_connections`. + +treshold::: + +Treshold value, which must be a `non_neg_integer`. When the +number of connections under a connection supervisor reaches +or exceeds this value, The alarm will trigger and call +the function defined in the `callback` key (see below). + +callback::: + +The alarm function, which takes the listener name, the alarm +name, the pid of the connection supervisor and a list of the pids +of all connection processes under that supervisor as arguments. +The return value is ignored. + +cooldown (5000)::: + +The minimum time after which the alarm can be triggered again, +in milliseconds. + connection_type (worker):: Type of process that will handle the connection. |