Version: v0.1.20 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Sep 25, 2021 License: BSD-3-Clause Imports: 15 Imported by: 0



Benchmark result archival daemon. Usage in godoc.

Testing UI changes

# Build benarchd and some binaries to upload test data
jiri go install
cd ${JIRI_ROOT}/release/go/bin

# Create dummy credentials to run all processes with
export V23_CREDENTIALS=/tmp/bencreds
./principal create --with-passphrase=false "${V23_CREDENTIALS}" bentesting

# Start benarchd
# And then visit http://localhost:14142 to browse the UI
# Edit HTML/CSS/JavaScript in internal/assets to mess around with the UI
./benarchd \
  --assets=${JIRI_ROOT}/release/go/src/ \
  --v23.tcp.address=localhost:14141 \
  --http=localhost:14142 &

# Populate with data (repeat multiple times or use multiple packages for more data)
go test -run NONE -bench . crypto/sha256 | ./benup --archiver=/

# Cleanup when done
kill $!
./v23agentd stop



Command benarchd implements a benchmark archival daemon.

It provides a Vanadium RPC service to accept results to archive (typically provided by the benup tool - and a web-interface to browse the results.

A SQL database is used for persistent storage, configured via the --store flag.


benarchd [flags]

The benarchd flags are:

  If set, the directory containing assets (template definitions, css,
  javascript files etc.) to use in the web interface. If not set, compiled-in
  assets will be used instead.
  The address of the HTTP server to advertise externally, typically used if the
  HTTP server is running behind a proxy or on a machine that is unaware of its
  publicly accessible hostname/IP address. If empty, derived from --http.
  Address on which to serve HTTP requests
  Vanadium object name to export this service under
  Specification of the persistent store to use. Format: <engine>:<parameters>,
  where <engine> can be 'sqlite3', 'mysql' or 'sqlconfig'. For 'sqlconfig',
  <parameters> is a path to a file containing a JSON-serialized SqlConfig
  (, for the others it is the
  data source name (e.g., filename for sqlite3)

The global flags are:

  log to standard error as well as files
  when logging hits line file:N, emit a stack trace
  if non-empty, write log files to this directory
  log to standard error instead of files
  max size in bytes of the buffer to use for logging stack traces
-metadata=<just specify -metadata to activate>
  Displays metadata for the program and exits.
  logs at or above this threshold go to stderr
  Dump timing information to stderr before exiting the program.
  log level for V logs
  directory to use for storing security credentials
  local namespace root; can be repeated to provided multiple roots
  specify a perms file as <name>:<permsfile>
  explicitly specify the runtime perms as a JSON-encoded access.Permissions.
  Overrides all --v23.permissions.file flags
  object name of proxy service to use to export services across network
  max number of proxies to connect to when the policy is to connect to all
  proxies; 0 implies all proxies
  policy for choosing from a set of available proxy instances
  address to listen on
  protocol to listen with
  if set the process will also advertise its private addresses
  if set, a failure to detect the requested virtualization provider will result
  in an error, otherwise, native mode is used
  if set the process will use the supplied dns name (and port) without
  resolution for its entry in the mounttable
  set if the process is running in a docker container and needs to configure
  itself differently therein
  the name of the virtualization/cloud provider hosting this process if the
  process needs to configure itself differently therein
  if set the process will use this address (resolving via dns if appropriate)
  for its entry in the mounttable
  if set the process will use this protocol for its entry in the mounttable
  The number of vtrace traces to store in memory
  Spans and annotations that match this regular expression will trigger trace
  If true, dump all stored traces on runtime shutdown
  Enable the use of AWS x-ray integration with vtrace
  Rate (from 0.0 to 1.0) to sample vtrace traces
  The verbosity level of the log messages to be captured in traces
  comma-separated list of globpattern=N settings for filename-filtered logging
  (without the .go suffix).  E.g. foo/bar/baz.go is matched by patterns baz or
  *az or b* but not by bar/baz or baz.go or az or b.*
  comma-separated list of regexppattern=N settings for file pathname-filtered
  logging (without the .go suffix).  E.g. foo/bar/baz.go is matched by patterns
  foo/bar/baz or fo.*az or oo/ba or b.z but not by foo/bar/baz.go or fo*az

Source Files


Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL