> This page is for version 1.6.1.
> For other versions, use one of these documentation indexes:
> - 1.8.1 (default): https://docs.nvidia.com/networking/cloudai/1.8.1/llms.txt
> - 1.7.1: https://docs.nvidia.com/networking/cloudai/1.7.1/llms.txt
> - 1.6.1: https://docs.nvidia.com/networking/cloudai/1.6.1/llms.txt
> - dev: https://docs.nvidia.com/networking/cloudai/dev/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/networking/cloudai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/networking/cloudai/_mcp/server.

This chapter describes the reporting system in CloudAI. In this chapter, we will cover the following topics:

* [Overview](/networking/cloudai/1.6.1/reporting#overview)

* [General Flow](/networking/cloudai/1.6.1/reporting#general-flow)

* [Enabling, Disabling and Configuring Reports](/networking/cloudai/1.6.1/reporting#enabling-disabling-and-configuring-reports)

* [Reporting Registration](/networking/cloudai/1.6.1/reporting#reporting-registration)

* [Reporting Configuration Implementation](/networking/cloudai/1.6.1/reporting#reporting-configuration-implementation)

**Overview**

CloudAI has two reporting levels:

* per-test (per each case in a test scenario)

* per-scenario (per each test scenario)

All reports are generated after the test scenario is completed as part of the main CloudAI process. For Slurm, this means that the login node is used to generate reports.

Per-test reports are linked to a particular workload type (e.g. `NcclTest`). All per-test reports are implemented as part of the `per_test` scenario report and can be enabled or disabled via a single configuration option; see [Enabling, Disabling and Configuring Reports](/networking/cloudai/1.6.1/reporting#enabling-disabling-and-configuring-reports).

To list all available reports, users can use `cloudai`` ``list-reports`. Use verbose output to also print report configurations.

## General Flow

* All reports should be registered via `Registry()` (`.add_report()` or `.add_scenario_report()`)

* Scenario reports are configurable via system config (Slurm-only for now) and scenario config

* Configuration in a scenario config has the highest priority. Next, system config is checked. Then it defaults to report config from the registry

* Finally, the report is generated (or not) according to this final config

## Enabling, Disabling and Configuring Reports

Note

Only scenario-level reports can be configured.

Enabling or disabling a report needs to be done in the system configuration:

```toml
[reports]
per_test = { enable = false }
status = { enable = true }
```

## Reporting Registration

Report registration is done via `Registry` class:

```python
Registry().add_scenario_report("per_test", PerTestReporter, ReportConfig(enable=True))
```

## Reporting Configuration Implementation

Each report can define its own configuration, which is constructed and passed as an argument to `Registry.add_scenario_report`. The `reports` field is parsed during TOML reading and the respective Pydantic model is created for it.

For example, a custom report configuration can be defined as follows:

```python
class CustomReportConfig(ReportConfig):
    greeting: str
```

```python
Registry().add_scenario_report("custom", CustomReport, CustomReportConfig(greeting="default value"))
```

And it can be used in a test scenario as follows:

```toml
[reports]
custom = { enable = true, greeting = "Hello, world!" }
```