Update Railgun documentation

railgun

#1

I would like to see Railgun documentation updated for

  1. statistics page https://www.cloudflare.com/docs/railgun/administration.html explain what each of the statistics metrics are for. Right now there is no explanation at all
curl -v http://127.0.0.1:22408/

> GET / HTTP/1.1
> Accept: */*
>
< HTTP/1.1 200 OK
< Content-Length: 1191
< Content-Type: application/json
< Date: Tue, 02 Apr 2013 16:56:57 GMT
{
    "bytes_retrieved": 2794091,
    "conveyor_cleans_chunk": 1,
    "conveyor_cleans_hasher": 1,
    "conveyor_get": 0,
    "conveyor_give": 0,
    "conveyor_queue_chunk": 3,
    "conveyor_queue_hasher": 29,
    "conveyor_removed_chunk": 0,
    "conveyor_removed_hasher": 0,
    "conveyor_retained_chunk": 3212,
    "conveyor_retained_hasher": 19468,
    "conveyor_tuned_chunk": 753,
    "conveyor_tuned_hasher": 1471,
    "delta_compression_ratio": 6890,
    "memstats.Frees": 51773495,
    "memstats.Mallocs": 52696575,
    "memstats.alloc": 128060840,
    "memstats.heap_alloc": 128060840,
    "memstats.heap_idle": 22933504,
    "memstats.heap_in_use": 134352896,
    "memstats.heap_objects": 923080,
    "memstats.heap_released": 0,
    "memstats.heap_sys": 157286400,
    "memstats.lookups": 305636,
    "memstats.num_gc": 133,
    "memstats.pause_ns": 164422,
    "memstats.stack_in_use": 3940352,
    "memstats.stack_sys": 6160384,
    "memstats.sys": 448807352,
    "memstats.total_alloc": 5162978952,
    "no_origin_response": 1,
    "origin_retries": 0,
    "requests_completed": 2455,
    "requests_started": 2295,
    "uncompressed_chunks": 2552,
    "wan_bytes_sent": 2952019,
    "wan_starts": 44
}
  1. Common Issues list at https://www.cloudflare.com/docs/railgun/installation.html add one to note that if you change memcached server to using unix sockets, that they need to be run as railgun user otherwise railgun will report a permission denied error on restart