---
title: cbsummary
description: The <code>cbsummary</code> tool connects to a set of Couchbase
  clusters, and generates a summary report.
pubDate: 2026-08-17T09:53:44.266Z
antora:
  editUrl: https://github.com/couchbase/docs-server/edit/release/7.2/modules/cli/pages/cbsummary.adoc
  xref: xref:7.2@server:cli:cbsummary.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/server/7.2/cli/cbsummary.html)

# cbsummary

> The `cbsummary` tool connects to a set of Couchbase clusters, and generates a summary report. 

## [](#description)Description

The `cbsummary` tool connects to a set of Couchbase clusters specified in a configuration file and generates a summary report.

The config file contains JSON specifying an array of information on each cluster, giving the Couchbase credentials to login, and one or more IP addresses for cluster nodes.

The default report format includes RAM and core utilization across each specified cluster, since that information is useful in determining compliance with Couchbase licenses. If you specify `--csv`, then the report is generated in CSV instead of JSON. If, instead, you specify `--full`, then a much more detailed report is generated.

The summary report is sent to the file `cbsummary.out.<timestamp>`, unless a different filename is specified with the `--output` option.

## [](#syntax)Syntax

The syntax for `cbsummary` is as follows:

cbsummary --config=<config file> [--output=<output file>] [--full]

## [](#options)Options

Command options are as follows:

| Option                    | Description                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------------- |
| \--config \[config file\] | Configuration file listing clusters and credentials to connect and generate a summary.              |
| \--csv                    | Generate the report in CSV format. Note that this format is not compatible with full reports.       |
| \--full                   | Generate an extensive report instead of just core and RAM usage.                                    |
| \-h --help                | Print a help message and exit.                                                                      |
| \--output \[output file\] | Name of the output file. The default naming convention for the report is cbsummary.out.<timestamp>. |

## [](#examples)Examples

An example config file giving information about 2 clusters is:

{ "clusters": [
  {"login": "Administrator", "pass": "password1", "nodes": ["http://192.168.1.1:8091"]},
  {"login": "Administrator", "pass": "password2", "nodes": ["http://192.166.1.1:8091","http://192.16.1.2:8091"]}
]}