1 // Testing tool for Keep services.
3 // keepexercise helps measure throughput and test reliability under
4 // various usage patterns.
6 // By default, it reads and writes blocks containing 2^26 NUL
7 // bytes. This generates network traffic without consuming much disk
10 // For a more realistic test, enable -vary-request. Warning: this will
11 // fill your storage volumes with random data if you leave it running,
12 // which can cost you money or leave you with too little room for
26 "git.curoverse.com/arvados.git/sdk/go/arvadosclient"
27 "git.curoverse.com/arvados.git/sdk/go/keepclient"
30 // Command line config knobs
32 BlockSize = flag.Int("block-size", keepclient.BLOCKSIZE, "bytes per read/write op")
33 ReadThreads = flag.Int("rthreads", 1, "number of concurrent readers")
34 WriteThreads = flag.Int("wthreads", 1, "number of concurrent writers")
35 VaryRequest = flag.Bool("vary-request", false, "vary the data for each request: consumes disk space, exercises write behavior")
36 VaryThread = flag.Bool("vary-thread", false, "use -wthreads different data blocks")
37 Replicas = flag.Int("replicas", 1, "replication level for writing")
38 StatsInterval = flag.Duration("stats-interval", time.Second, "time interval between IO stats reports, or 0 to disable")
39 ServiceURL = flag.String("url", "", "specify scheme://host of a single keep service to exercise (instead of using all advertised services like normal clients)")
40 ServiceUUID = flag.String("uuid", "", "specify UUID of a single advertised keep service to exercise")
46 arv, err := arvadosclient.MakeArvadosClient()
50 kc, err := keepclient.MakeKeepClient(arv)
54 kc.Want_replicas = *Replicas
55 kc.Client.Timeout = 10 * time.Minute
59 nextLocator := make(chan string, *ReadThreads+*WriteThreads)
61 go countBeans(nextLocator)
62 for i := 0; i < *WriteThreads; i++ {
63 nextBuf := make(chan []byte, 1)
64 go makeBufs(nextBuf, i)
65 go doWrites(kc, nextBuf, nextLocator)
67 for i := 0; i < *ReadThreads; i++ {
68 go doReads(kc, nextLocator)
73 // Send 1234 to bytesInChan when we receive 1234 bytes from keepstore.
74 var bytesInChan = make(chan uint64)
75 var bytesOutChan = make(chan uint64)
77 // Send struct{}{} to errorsChan when an error happens.
78 var errorsChan = make(chan struct{})
80 func countBeans(nextLocator chan string) {
82 var tickChan <-chan time.Time
83 if *StatsInterval > 0 {
84 tickChan = time.NewTicker(*StatsInterval).C
92 elapsed := time.Since(t0)
93 log.Printf("%v elapsed: read %v bytes (%.1f MiB/s), wrote %v bytes (%.1f MiB/s), errors %d",
95 bytesIn, (float64(bytesIn) / elapsed.Seconds() / 1048576),
96 bytesOut, (float64(bytesOut) / elapsed.Seconds() / 1048576),
99 case i := <-bytesInChan:
101 case o := <-bytesOutChan:
109 func makeBufs(nextBuf chan<- []byte, threadID int) {
110 buf := make([]byte, *BlockSize)
112 binary.PutVarint(buf, int64(threadID))
115 if randSize > *BlockSize {
116 randSize = *BlockSize
120 rnd := make([]byte, randSize)
121 if _, err := io.ReadFull(rand.Reader, rnd); err != nil {
124 buf = append(rnd, buf[randSize:]...)
130 func doWrites(kc *keepclient.KeepClient, nextBuf <-chan []byte, nextLocator chan<- string) {
131 for buf := range nextBuf {
132 locator, _, err := kc.PutB(buf)
135 errorsChan <- struct{}{}
138 bytesOutChan <- uint64(len(buf))
139 for cap(nextLocator) > len(nextLocator)+*WriteThreads {
140 // Give the readers something to do, unless
141 // they have lots queued up already.
142 nextLocator <- locator
147 func doReads(kc *keepclient.KeepClient, nextLocator <-chan string) {
148 for locator := range nextLocator {
149 rdr, size, url, err := kc.Get(locator)
152 errorsChan <- struct{}{}
155 n, err := io.Copy(ioutil.Discard, rdr)
157 if n != size || err != nil {
158 log.Printf("Got %d bytes (expected %d) from %s: %v", n, size, url, err)
159 errorsChan <- struct{}{}
161 // Note we don't count the bytes received in
162 // partial/corrupt responses: we are measuring
163 // throughput, not resource consumption.
165 bytesInChan <- uint64(n)
169 func overrideServices(kc *keepclient.KeepClient) {
170 roots := make(map[string]string)
171 if *ServiceURL != "" {
172 roots["zzzzz-bi6l4-000000000000000"] = *ServiceURL
173 } else if *ServiceUUID != "" {
174 for uuid, url := range kc.GatewayRoots() {
175 if uuid == *ServiceUUID {
181 log.Fatalf("Service %q was not in list advertised by API %+q", *ServiceUUID, kc.GatewayRoots())
186 kc.SetServiceRoots(roots, roots, roots)