Re: [hybi] Additional WebSocket Close Error Codes

> > 1012/Service Restart
> > 1012 indicates that the service is restarted. a client may reconnect,
> > and if it choses to do, should reconnect using a randomized delay of 5
> > - 30s.
> >
> > Use case:
> > restart a service with 100k clients connected clients present an
> > informative user notification ("service restarting .. reconnecting in
> > N secs) clients should not reconnect all at exactly the same time ..
> > thus the randomized delay
> 
> On the other hand, if you have almost real-time requirements and you simply
> restarted a service, sometimes 5-30s is uncomfortable long.
> For some applications it means the client is effectively frozen for 5-30s.
> Sometimes, you want restarting the service to be as invisible to the user as
> reasonably possible.
> 
> Your server knows the current load, so has an idea if it could handle immediate
> or faster reconnection attempts.  On an intranet, you might want it randomised
> as 0-1s for 10k clients.
> 
> Any reason you chose this length of time?  Could a suggested delay be included
> with the error, with 5-30s being the default?

When I suggested that use case, the 5-30s where merely a rough, unscientific guess what
range could make sense in a public WAN server scenario .. the 5s for allowing the server
to restart at all, and the upper bound of 30s leaving 25s for 100k clients to reconnect
within that interval:

100k/25s = 4k/s opening WebSocket handshakes sustained

But yes, ultimately the interval should be decided by the server based on (at least)

* exptected server restart time
* LAN vs WAN
* # of connected clients
* opening handshake rate the server can do

The server could for 1012 provide a close reason (string):

[5,30]

that is comma separated randomized reconnect interval .. JSON.

> 
> > 1013/Service Overload
> > 1013 indicates that the service is experiencing overload. a client
> > should only connect to a different IP (when there are multiple for the
> > target) or reconnect to the same IP upon user action.
> 
> Maybe it could suggest which different IP(s) (and/or URL(s))?

Close reason could be again JSON list like i.e.:

["ws://2nd.example.com", "ws://3rd.example.com:9000", "wss://4th.example.com", "ws://62.146.25.34"]

That could be interpreted by the client as a priority sorted list of servers to connect.

The priorities could also be given explicitly

[["ws://2nd.example.com", 2], ["ws://3rd.example.com:9000", 5], ["wss://4th.example.com", 12], ["ws://62.146.25.34", 9]]

where the client then connects to a server from the list with a probability proportional to the priority value, i.e. to

ws://3rd.example.com:9000

with probability

5 / (2+5+12+9)

and so on.

> 
> -- Jamie
> _______________________________________________
> hybi mailing list
> hybi@ietf.org
> https://www.ietf.org/mailman/listinfo/hybi