github.com/distbuild/reclient@v0.0.0-20240401075343-3de72e395564/cmd/reproxystatus/README.md (about)

     1  # User Guide for `reproxystatus`
     2  
     3  `reproxystatus` is a binary that can be used to monitor build stats for running
     4  instances of `reproxy`.
     5  Source code can be found in this directory.
     6  
     7  ## Usage
     8  
     9  Invoking `reproxystatus` with no arguments will print build stats for all
    10  running instances of `reproxy` with `--server_address=unix://...` or
    11  `--server_address=pipe://...`.
    12  
    13  If `reproxy` is running on a tcp ip and port, or if you only want to show stats
    14  for one instance then you must pass the same `--server_address` to
    15  `reproxystatus` that was passed to `reproxy`.
    16  
    17  To see live output throughout a build, wrap the call to `reproxystatus` with a
    18  tool like `watch`, eg:
    19  
    20  ```
    21  $ watch /path/to/reproxystatus
    22  ```
    23  
    24  ## Sample output
    25  
    26  ```
    27  $ /path/to/reproxystatus
    28  Reproxy(unix:///path/to/unix.sock) is OK
    29  Actions completed: 26935 (26756 cache hit, 179 racing local)
    30  Actions in progress: 20
    31  ```