> For the complete documentation index, see [llms.txt](https://docs.cloud-halo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloud-halo.io/finops/reports.md).

# Reports

Reports help teams share cost, forecast, alert, and optimisation information with stakeholders.

## Report types

Cloud Halo supports reporting workflows such as:

* Executive summaries
* Cost exports
* FOCUS-aligned cost usage exports
* Workspace reporting
* Recommendation summaries
* Budget and alert summaries
* Cost allocation reports
* Chargeback and showback statements

Available formats can include on-screen summaries and downloadable exports.

FOCUS-aligned exports use Cloud Halo's FOCUS datasets. Cost Usage rows can be summary-derived from Cloud Halo syncs or provider-sourced from imported Azure Cost Management FOCUS CSV exports.

Contract Commitment rows can be projected from Azure commitment inventory or provider-sourced from imported FOCUS Contract Commitment CSV exports. Provider-sourced commitment rows preserve the native FOCUS fields and can pass the in-app Contract Commitment validation report when complete.

## Chargeback and showback

Chargeback and showback reports turn cost allocation dimensions into internal billing statements.

To use them:

1. Open **Cost allocation**.
2. Create dimensions for departments, projects, environments, or customers.
3. Add allocation rules that match Azure spend by tag, resource group, service, or resource.
4. Add an owner email and billing reference or cost centre to each billable dimension.
5. Open **Reports** and export the chargeback/showback report as CSV or PDF.

The report shows the billing period, allocated spend, unallocated spend, bill-to name, owner, billing reference, amount, and workspace share. Scheduled chargeback reports can also be sent by email when scheduled report delivery is configured.

## Scheduled reports

Scheduled reports can send regular summaries by email.

Common schedules include:

* Weekly team summaries
* Monthly budget reviews
* Monthly executive summaries

Scheduled report delivery requires email delivery to be configured for the Cloud Halo environment.

## Report run history

Cloud Halo records report activity so administrators can review when reports were generated or sent.

If a scheduled report is missing, check:

* The report schedule is active
* The recipient email address is correct
* Email delivery is configured
* The latest report run status

## Using reports well

Use reports to support review conversations rather than replacing investigation.

For detailed analysis, open Cost explorer and Recommendations from the workspace dashboard.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cloud-halo.io/finops/reports.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.