FdbTop 7.4.7

dotnet tool install --global FdbTop --version 7.4.7
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local FdbTop --version 7.4.7
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=FdbTop&version=7.4.7
                    
nuke :add-package FdbTop --version 7.4.7
                    

FdbTop

A command-line tool for monitoring a live FoundationDB cluster: a top-style live view of what the cluster is doing.

Install

FdbTop is a .NET tool. Install it globally:

dotnet tool install --global FdbTop

Usage

fdbtop

It shows a continuously-updating dashboard of throughput, latencies, and process/role health, handy for watching a cluster under load during development or testing.

Connecting

By default fdbtop uses the standard FoundationDB cluster file. A few options make it easy to point it elsewhere, in particular at a cluster running locally in Docker:

  • a positional path, or -c, -C, --connfile <path>: path to a cluster file.
  • --connStr <string>: a connection string, instead of a file.
  • --docker <port>: connect to a local FoundationDB running in Docker on the given port.
  • --aspire [name]: connect to the FoundationDB resource of a .NET Aspire AppHost, using the connection string that Aspire injects into the environment (ConnectionStrings__<name>). The name is required only when the environment holds more than one FoundationDB connection string. Outside of an AppHost, --aspire stops with an error that lists the alternatives.
  • --api <version>: the API version level to use.
  • --timeout <seconds> (-t): default transaction timeout.
fdbtop                          # the default cluster file
fdbtop /path/to/fdb.cluster     # a specific cluster file
fdbtop --docker 4550            # a cluster running in Docker on port 4550
fdbtop --aspire                 # the cluster of the Aspire AppHost that started fdbtop

Requires the native FoundationDB client (fdb_c / libfdb_c) matching your cluster's version.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
7.4.7 75 11/10/2026
7.4.2 352 7/13/2026
7.3.1 276 5/30/2025
7.3.0-preview2 262 10/18/2024