A fairly common problem for buildslave admins is that they don't actually have network connectivity to the buildmaster: either the name/portnum is wrong, or there's some overzealous firewall in the way. It would be nice if the error message that shows up in the log were more clear. At the moment it says something like:
2007/08/04 08:51 +0100 [-] Starting factory <buildbot.slave.bot.BotFactory instance at 0x13769b8>
2007/08/04 08:51 +0100 [Uninitialized] <twisted.internet.tcp.Connector instance at 0x1283c88> will retry in 2 seconds
If the first time we tried to reconnect, the error message said something like:
UNABLE TO CONNECT TO BUILDMASTER at hostname.example.net:portnum, are you sure you are actually connected to the internet?
then users might be inspired to test their network connection with 'telnet' or the like much quicker.
Also, it'd be nice of the "will retry" message carried some indication of what exactly it was going to retry, since after several days of retries it's not easy to find the log messages associated with the start of that factory to find out what it is trying to hard to accomplish.