Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 91 additions & 0 deletions .github/ISSUE_TEMPLATE/community-report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
name: Community Report Contribution
about: Submit a community Power BI report to the FinOps toolkit
title: '[Community Report] '
labels: 'community-report, Needs: Triage 🔍'
---

# Community Report Contribution

Thank you for contributing a Power BI report to the FinOps toolkit community! 🙌

## 📋 Report information

**Report Name:** <!-- Provide the name of your report -->

**Author:** <!-- Your name or organization -->

**Contact:** <!-- GitHub handle or email for support inquiries -->

**Brief Description:** <!-- 1-2 sentences about what your report does -->

**Target Audience:** <!-- e.g., FinOps practitioners, Engineering teams, Finance teams -->

**FinOps Capability:** <!-- e.g., Cost allocation, Rate optimization, Workload optimization -->

## ✅ Pre-submission checklist

I confirm that my report submission includes:

### Required files
- [ ] README.md with all required sections completed
- [ ] CONTRIBUTORS.md with technical lead information
- [ ] Power BI report files (.pbip, .pbit, or .pbix)
- [ ] At least 2 screenshots in the images/ folder

### Documentation
- [ ] Clear setup instructions for data sources
- [ ] Prerequisites and requirements listed
- [ ] Known limitations documented
- [ ] Troubleshooting guidance included

### Quality
- [ ] Report has been tested with real data
- [ ] All sensitive data has been removed
- [ ] Report works with latest Power BI Desktop
- [ ] Data source connections are parameterized

### Licensing
- [ ] Report is licensed under MIT or compatible license
- [ ] All third-party components are properly attributed
- [ ] No copyrighted content without permission

### Commitment
- [ ] I commit to serving as technical lead for this report
- [ ] I understand the [technical lead responsibilities](https://github.com/microsoft/finops-toolkit/blob/dev/docs-wiki/Advisory-council.md)
- [ ] I will respond to issues and maintain the report

## 📂 Report location

**Folder path:** `src/power-bi/community/[your-report-name]/`

**Files included:**
- <!-- List the main files in your submission -->

## 📷 Screenshots

<!-- Add 1-2 screenshots showing key features of your report -->

## 📝 Additional notes

<!-- Any additional information reviewers should know about your report -->

---

## For reviewers

### Review checklist

- [ ] Folder structure follows template guidelines
- [ ] README.md is complete and clear
- [ ] CONTRIBUTORS.md includes technical lead contact
- [ ] Screenshots are included and descriptive
- [ ] No sensitive data in report files
- [ ] Report files are in correct format
- [ ] Documentation quality is acceptable
- [ ] License is compatible with MIT
- [ ] Report has been tested (as stated by contributor)

### Review notes

<!-- Reviewer comments and feedback -->
2 changes: 2 additions & 0 deletions docs-mslearn/toolkit/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,8 @@ The following section lists features and enhancements that are currently in deve

### [Power BI reports](power-bi/reports.md) v13

- **Added**
- Created [community reports repository](power-bi/community.md) for community-contributed Power BI reports, similar to Azure Quickstart Templates. The repository enables the FinOps community to share specialized reports for specific use cases while maintaining clear differentiation from official toolkit reports.
- **Fixed**
- Fixed tag expansion in Power BI reports when tag names contain special characters like colons.

Expand Down
185 changes: 185 additions & 0 deletions docs-mslearn/toolkit/power-bi/community.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,185 @@
---
title: Community Power BI reports
description: Learn about community-contributed Power BI reports for FinOps in the FinOps toolkit and how to contribute your own reports.
author: flanakin
ms.author: micflan
ms.date: 10/10/2025
ms.topic: how-to
ms.service: finops
ms.subservice: finops-toolkit
ms.reviewer: micflan
#customer intent: As a FinOps practitioner, I want to discover and use community-contributed Power BI reports to accelerate my FinOps journey.
---

# Community Power BI reports

The FinOps toolkit includes a repository for community-contributed Power BI reports. These reports are created and maintained by FinOps practitioners like you to address specialized use cases, industries, or scenarios that complement the official toolkit reports.

<br>

On this page:

- [About community reports](#about-community-reports)
- [Available community reports](#available-community-reports)
- [Using community reports](#using-community-reports)
- [Contributing a report](#contributing-a-report)
- [Support and maintenance](#support-and-maintenance)

---

## About community reports

Community reports are Power BI reports contributed by members of the FinOps community. These reports provide specialized solutions for specific scenarios that may not be covered by the [official FinOps toolkit reports](reports.md).

### Key differences from official reports

The following table compares community reports to official FinOps toolkit reports:

| Aspect | Official toolkit reports | Community reports |
|--------|-------------------------|-------------------|
| **Maintenance** | Maintained by the FinOps toolkit team | Maintained by community contributors |
| **Support** | Supported through Microsoft channels | No formal support guarantee |
| **Quality assurance** | Full QA and testing by toolkit team | Community reviewed, best effort |
| **Updates** | Regular updates with toolkit releases | Updated by report owners |
| **Branding** | FinOps toolkit branding | Community contributor branding |
| **SLA** | Best effort support | No SLA |

> [!IMPORTANT]
> Community reports are provided "AS IS" without warranty of any kind. Microsoft and the FinOps toolkit team do not guarantee the quality, compatibility, performance, or ongoing maintenance of community reports. Each report is the responsibility of its contributor.

<br>

## Available community reports

> [!NOTE]
> No community reports have been submitted yet. Be the first to contribute!

To view all available community reports:

1. Browse the [community reports directory](https://github.com/microsoft/finops-toolkit/tree/dev/src/power-bi/community) on GitHub
2. Each report has its own folder containing:
- README.md with setup instructions and documentation
- Power BI report files (.pbip, .pbit, or .pbix)
- Screenshots and sample data (if applicable)
- CONTRIBUTORS.md with maintainer contact information

<br>

## Using community reports

To use a community report:

### 1. Review the report documentation

Before downloading a community report, review the report's README.md file to understand:

- What the report does and who it's designed for
- Data sources and prerequisites required
- Known limitations or compatibility requirements
- Support expectations from the report maintainer

### 2. Download the report

Download the report files from the GitHub repository:

1. Navigate to the [community reports directory](https://github.com/microsoft/finops-toolkit/tree/dev/src/power-bi/community)
2. Select the report you want to use
3. Download the report files:
- Use the .pbit file for first-time setup (template with no data)
- Use the .pbix file to preview with sample data (if available)
- Use the .pbip folder for source control and collaboration

### 3. Configure data sources

Follow the setup instructions in the report's README.md file to:

1. Configure required data sources (Cost Management exports, FinOps hubs, etc.)
2. Set up authentication
3. Enter any required parameters
4. Refresh the data

### 4. Customize as needed

Community reports are designed to be customized for your specific needs:

- Adjust filters and parameters
- Modify visuals and layouts
- Add your own data sources
- Integrate with other reports

<br>

## Contributing a report

We welcome contributions from the FinOps community! If you've created a Power BI report that could benefit others, consider contributing it to the toolkit.

### Before you contribute

Review the [contribution guidelines](https://github.com/microsoft/finops-toolkit/blob/dev/src/power-bi/community/README.md#-contribution-guidelines) to ensure your report meets the requirements:

- Report must be well-documented with setup instructions
- Must include screenshots and sample data or configuration
- Must be tested with real data
- Must be licensed under MIT or compatible license
- You must commit to maintaining the report as technical lead

### How to contribute

1. Fork the [finops-toolkit repository](https://github.com/microsoft/finops-toolkit)
2. Create a new branch for your report
3. Copy the [report template](https://github.com/microsoft/finops-toolkit/tree/dev/src/power-bi/community/.template) to a new folder
4. Add your report files and documentation following the template structure
5. Submit a pull request with a clear description
6. Respond to review feedback from the community

For detailed contribution steps, see the [community reports contribution guide](https://github.com/microsoft/finops-toolkit/blob/dev/src/power-bi/community/README.md#-contributing-a-report).

<br>

## Support and maintenance

### Getting support

Community reports follow a community support model similar to [Azure Quickstart Templates](https://github.com/Azure/azure-quickstart-templates):

1. **Check the report's README** for troubleshooting guidance and FAQs
2. **Contact the report maintainer** listed in the report's CONTRIBUTORS.md file
3. **Search existing issues** on GitHub for similar problems and solutions
4. **Open a new issue** on GitHub with the `community-report` label if needed
5. **Ask in discussions** for community help and suggestions

### Reporting issues

When reporting issues with a community report:

1. Include the report name in the issue title
2. Tag the issue with `community-report` and `Type: Bug 🐛` labels
3. Mention the report maintainer from the CONTRIBUTORS.md file
4. Provide detailed reproduction steps, screenshots, and error messages
5. Include your Power BI Desktop version and data source configuration

### Maintenance responsibilities

Report contributors serve as technical leads for their reports and are responsible for:

- Responding to issues and questions from users
- Maintaining compatibility with the latest Power BI versions
- Updating documentation as needed
- Reviewing and merging pull requests from other contributors
- Archiving or marking reports as deprecated if no longer maintained

<br>

## Related content

- [Official Power BI reports](reports.md)
- [Help me choose a data source](help-me-choose.md)
- [Set up Power BI reports](setup.md)
- [FinOps toolkit contribution guide](../help/contributors.md)
- [FinOps Framework](https://www.finops.org/framework/)

<br>

---

_Community reports are maintained by their contributors and are not officially supported by Microsoft or the FinOps toolkit team. For supported reports, see [Power BI reports](reports.md)._
7 changes: 7 additions & 0 deletions docs-mslearn/toolkit/power-bi/reports.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,13 @@ In addition, the following reports use the Cost Management connector for Power B
- [Cost Management connector](connector.md) – Summarizes costs, savings, and commitment discounts using the Cost Management connector for Enterprise Agreements and Microsoft Customer Agreement accounts.
- [Cost Management template app](template-app.md) (EA only) – The original Cost Management template app as a customizable .pbix file.

### Community reports

The FinOps community also contributes specialized Power BI reports for specific use cases and industries. Community reports are maintained by their contributors and are not officially supported by the FinOps toolkit team.

> [!div class="nextstepaction"]
> [Explore community reports](community.md)

<br>

## Data sources
Expand Down
1 change: 1 addition & 0 deletions docs/power-bi.md
Original file line number Diff line number Diff line change
Expand Up @@ -200,6 +200,7 @@ Create a new or update an existing FinOps hub instance.
</div>

<a class="btn mt-2 mb-4 mb-md-0 mr-4" target="_blank" href="https://learn.microsoft.com/cloud-computing/finops/toolkit/power-bi/reports">About the reports</a>
<a class="btn mb-4 mb-md-0 mr-4" target="_blank" href="https://learn.microsoft.com/cloud-computing/finops/toolkit/power-bi/community">Community reports</a>
<a class="btn mb-4 mb-md-0 mr-4" target="_blank" href="https://portal.azure.com/#view/HubsExtension/InProductFeedbackBlade/extensionName/FinOpsToolkit/cesQuestion/How%20easy%20or%20hard%20is%20it%20to%20use%20FinOps%20toolkit%20Power%20BI%20reports%3F/cvaQuestion/How%20valuable%20are%20FinOps%20toolkit%20Power%20BI%20reports%3F/surveyId/FTK{% include ftkver.txt %}/bladeName/PowerBI/featureName/Marketing.Docs">💜 Give feedback</a>

<br>
12 changes: 12 additions & 0 deletions src/power-bi/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ On this page:

- [� Prerequisites](#-prerequisites)
- [📐 Design guidelines](#-design-guidelines)
- [🌐 Community reports](#-community-reports)
- [ℹ️ Cost Management template app](#ℹ️-cost-management-template-app)

---
Expand Down Expand Up @@ -71,6 +72,17 @@ Power BI reports in the FinOps toolkit must adhere to the following guidelines:

<br>

## 🌐 Community reports

In addition to official FinOps toolkit reports, the community has contributed specialized reports for specific use cases and industries. Community reports are maintained by their contributors and provided "AS IS" without formal support from the FinOps toolkit team.

For a full list of available community reports and contribution guidelines, see the [community reports directory](community/README.md).

> [!IMPORTANT]
> Community reports are not officially maintained by the FinOps toolkit team. Each report is the responsibility of its contributor. Quality, compatibility, and ongoing maintenance may vary.

<br>

## ℹ️ Cost Management template app

The Cost Management template app is managed by the Cost Management team. The template app is not available for download and cannot be edited. We are including this report in the FinOps toolkit to help unblock customers who are looking for something specific in this report, however we highly recommend using the FinOps toolkit reports instead.
Expand Down
Empty file.
37 changes: 37 additions & 0 deletions src/power-bi/community/.template/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Contributors

This file lists the contributors and maintainers for this community report.

## Technical lead

**Name:** [Your Name]
**Organization:** [Your Organization]
**GitHub:** [@your-github-handle](https://github.com/your-github-handle)
**Contact:** [Email or preferred contact method]
**Role:** Primary maintainer and technical lead

## Additional contributors

<!-- List any additional contributors who have helped develop or improve this report -->

**Name:** [Contributor Name]
**Organization:** [Organization]
**GitHub:** [@github-handle](https://github.com/github-handle)
**Contribution:** [Brief description of contribution]

---

<!-- Add more contributors as needed -->

## Acknowledgments

<!-- Optional: Acknowledge any third-party resources, tools, or individuals that inspired or supported this work -->

- [Resource or person to acknowledge]
- [Resource or person to acknowledge]

<br>

---

_For questions about this report, please contact the technical lead listed above._
Loading