Skip to content

Commit

Permalink
Merge branch 'dev' into features/adx
Browse files Browse the repository at this point in the history
  • Loading branch information
flanakin authored Oct 31, 2024
2 parents cd682f6 + 57873af commit a4ddec9
Show file tree
Hide file tree
Showing 29 changed files with 35,261 additions and 1,158 deletions.
2 changes: 2 additions & 0 deletions docs/_docs/framework/capabilities/optimize/architecting.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,8 @@ Starting with the "Architecting for Cloud" capability within the FinOps Framewor

- **Implement architectural principles:** Establish architectural principles and design guidelines based on [WAF pillars](https://learn.microsoft.com/azure/well-architected/workloads): operational excellence, security, reliability, performance efficiency, and cost optimization.

- **Leverage Enterprise App Patterns for Web Apps:** Get started with the [Reliable Web App pattern](aka.ms/eap/rwa). Enterprise App Patterns are built on top of the principles laid out in the WAF and provide implementation techniques to optimize your .NET or Java web app's move to the cloud.

- **Utilize Azure Well-Architected Review:** Conduct Azure [Well-Architected Reviews](https://learn.microsoft.com/assessments/azure-architecture-review/) for workloads deployed in Azure. Evaluate workloads against the five pillars of WAF to identify areas for improvement.

- **Implement cost management practices:** Review and incorporate CAF's [cost management practices](https://learn.microsoft.com/azure/cloud-adoption-framework/get-started/manage-costs) into architectural designs, such as right-sizing resources, [leveraging reserved instances](./rates.md), and implementing cost allocation mechanisms. Use Azure Cost Management + Billing to monitor and optimize costs.
Expand Down
2 changes: 1 addition & 1 deletion docs/_includes/ftkver.txt
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.6
0.7-dev
2 changes: 1 addition & 1 deletion docs/_optimize/optimization-engine/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,8 +126,8 @@ The simplest, quickest and recommended method for installing AOE is by using the

1. Open Azure Cloud Shell (PowerShell)
1. Run `git clone https://github.com/microsoft/finops-toolkit.git`
1. Run `git checkout main`
1. Run `cd finops-toolkit/src/optimization-engine`
1. Run `git checkout main`
1. (optional) Run `Install-Module Microsoft.Graph.Authentication,Microsoft.Graph.Identity.DirectoryManagement` - this is required to grant the Global Reader role to the Automation Managed Identity in Microsoft Entra ID, used by Identity and RBAC governance features.
1. Run `./Deploy-AzureOptimizationEngine.ps1`
1. Input your deployment options and let the deployment finish (it will take less than 5 minutes)
Expand Down
6 changes: 2 additions & 4 deletions docs/_reporting/hubs/configure-scopes.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,15 +47,13 @@ If you cannot grant permissions for your scope, you can create Cost Management e
- **Frequency** = `Daily export of month-to-date costs`<sup>3</sup>
- **Storage account** = (Use subscription/resource deployed with your hub)
- **Container** = `msexports`
- **Format** = `CSV`
- **Compression Type** = `none`
- **Format** = `Parquet`
- **Compression** = `Snappy`
- **Directory** = (Specify a unique path for this scope<sup>5</sup>)
- _**EA billing account:** `billingAccounts/{enrollment-number}`_
- _**MCA billing profile:** `billingProfiles/{billing-profile-id}`_
- _**Subscription:** `subscriptions/{subscription-id}`_
- _**Resource group:** `subscriptions/{subscription-id}/resourceGroups/{rg-name}`_
- **Format** = Parquet
- **Compression** = Snappy
- **File partitioning** = On
- **Overwrite data** = Off<sup>4</sup>

Expand Down
22 changes: 8 additions & 14 deletions docs/_reporting/power-bi/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ parent: Power BI
title: Governance
nav_order: 21
description: 'Summarize cloud governance posture including areas like compliance, security, operations, and resource management in Power BI.'
permalink: /power-bi/workload-optimization
permalink: /power-bi/governance
---

<span class="fs-9 d-block mb-4">Governance report</span>
Expand All @@ -31,18 +31,12 @@ Summarize cloud governance posture including areas like compliance, security, op

---

The **Governance report** provides insights into resource utilization and efficiency opportunities based on historical usage patterns. This report enables you to:

- Identify unattached disks.


Overview of the Cloud Adoption Framework
The **Governance report** summarizes your Microsoft Cloud governance posture. It offers standard metrics aligned with the Cloud Adoption Framework to facilitate identifying issues, applying recommendations, and resolving compliance gaps.

The CAF Govern methodology provides a structured approach for establishing and optimizing cloud governance in Azure. The guidance is relevant for organizations across any industry. It covers essential categories of cloud governance, such as regulatory compliance, security, operations, cost, data, resource management, and artificial intelligence (AI).
Cloud governance is how you control cloud use across your organization. Cloud governance sets up guardrails that regulate cloud interactions. These guardrails are a framework of policies, procedures, and tools you use to establish control. Policies define acceptable and unacceptable cloud activity, and the procedures and tools you use ensure all cloud usage aligns with those policies. Successful cloud governance prevents all unauthorized or unmanaged cloud usage.
To assess your transformation journey, try the [governance benchmark tool](https://learn.microsoft.com/assessments/b1891add-7646-4d60-a875-32a4ab26327e/?WT.mc_id=FinOpsToolkit).


This report pulls data from:

- Cost Management exports or FinOps hubs
Expand All @@ -68,31 +62,31 @@ The **Get started** page includes a basic introduction to the report with additi

The **Summary** page provides a summary of subscriptions, resource types, resources, and regions across your environment.

> ![Screenshot of the Summary page](https://github.com/user-attachments/assets/4376b964-f1b7-4fee-819a-7a40e3e07e06)
> ![Screenshot of the Summary page](https://github.com/user-attachments/assets/46ded4d2-51c6-4a7f-9e24-35edc3d6ce56)
<br>

## Policy compliance

The **Policy compliance** page lists policies configured in Azure Policy for the selected subscriptions.

> ![Screenshot of the Policy compliance page](https://github.com/user-attachments/assets/3b91565f-f25e-474f-ad93-978df3d4937c)
> ![Screenshot of the Policy compliance page](https://github.com/user-attachments/assets/338d6648-fd78-4aa4-b56e-858e0fcc5873)
<br>

## Virtual machines

The **Virtual machines** page lists the virtual machines, disks, and public IP addresses with related right-sizing recommendations.

> ![Screenshot of the Virtual machines page](https://github.com/user-attachments/assets/d951df9a-3f5b-4294-b48e-840cb4901add)
> ![Screenshot of the Virtual machines page](https://github.com/user-attachments/assets/4f055d3c-a368-4f0d-8b0d-c16049bc79ea)
<br>

## Managed disks

The **Managed disks** page lists the managed disks.

> ![Screenshot of the Managed disks page](https://github.com/user-attachments/assets/545fd571-5753-4705-881a-b27e65269f13)
> ![Screenshot of the Managed disks page](https://github.com/user-attachments/assets/7cec9e2b-d597-43d0-810a-6762aa9a82e0)
<br>

Expand All @@ -102,15 +96,15 @@ The **SQL databases** page lists the SQL databases.

The chart shows the cost of each disk over time. The table shows the disks with related properties, including billed and effective cost and the dates the disk was available during the selected date range in the Charge period filter at the top-left of the page.

> ![Screenshot of the SQL databases page](https://github.com/user-attachments/assets/7da6e086-a6c1-44e2-a70b-b72df6bac346)
> ![Screenshot of the SQL databases page](https://github.com/user-attachments/assets/3aaf5ce2-cd88-40e1-a82c-b4e292cd0692)
<br>

## Network security groups

The **Network security groups** page lists network security groups and NSG rules.

> ![Screenshot of the Network security groups page](https://github.com/user-attachments/assets/ac522ccc-4ab3-4819-b1c0-bf1252ff1cdd)
> ![Screenshot of the Network security groups page](https://github.com/user-attachments/assets/c333c694-8c4d-4656-a0cb-3beeb94f6e70)
<br>

Expand Down
6 changes: 3 additions & 3 deletions docs/_reporting/power-bi/workload-optimization.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,15 +48,15 @@ _The Workload optimization report is new and still being fleshed out. We will co

The **Get started** page includes a basic introduction to the report with additional links to learn more.

> ![Screenshot of the Get started page](https://github.com/user-attachments/assets/c467d8e2-dd49-4dcf-b5b6-2643a59d57fd)
![Screenshot of the Get started page](https://github.com/user-attachments/assets/c467d8e2-dd49-4dcf-b5b6-2643a59d57fd)

<br>

## Recommendations

The **Recommendations** page provides a list of Azure Advisor cost recommendations, similar to what you will find in the Azure portal. There are currently no details available. Details will be added in a future release.

> ![Screenshot of the Recommendations page](https://github.com/user-attachments/assets/d8fbe2c2-424a-45cb-81b2-b3f4e084513e)
![Screenshot of the Recommendations page](https://github.com/user-attachments/assets/d8fbe2c2-424a-45cb-81b2-b3f4e084513e)

<br>

Expand All @@ -66,7 +66,7 @@ The **Unattached disks** page lists the unattached disks sorted by cost.

The chart shows the cost of each disk over time. The table shows the disks with related properties, including billed and effective cost and the dates the disk was available during the selected date range in the Charge period filter at the top-left of the page.

> ![Screenshot of the Unattached disks page](https://github.com/user-attachments/assets/e81cc448-9090-47f4-b990-daded98a17d8)
![Screenshot of the Unattached disks page](https://github.com/user-attachments/assets/fc815b6d-3564-466b-8100-b00403440fa4)

<br>

Expand Down
38 changes: 37 additions & 1 deletion docs/_resources/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,22 @@ Legend:
> ➕ Added:
>
> 1. Cost Management export modules for subscriptions and resource groups.
>
📗 FinOps guide
{: .fs-5 .fw-500 .mt-4 mb-0 }

> ✏️ Changed:
>
> 1. Added Enterprise App Patterns links resources to the architecting for the cloud section.
🔍 Optimization engine
{: .fs-5 .fw-500 .mt-4 mb-0 }

> 🛠️ Fixed:
>
> 1. Exports ingestion issues in cases where exports come with empty lines ([#998](https://github.com/microsoft/finops-toolkit/issues/998))
> 1. Missing columns in EA savings plans exports ([#1026](https://github.com/microsoft/finops-toolkit/issues/1026))
<br><a name="latest"></a>

Expand All @@ -98,6 +114,26 @@ Legend:
>
> 1. Renamed the `msexports_FileAdded` trigger to `msexports_ManifestAdded`.
📒 Azure Monitor workbooks
{: .fs-5 .fw-500 .mt-4 mb-0 }

> ➕ Added:
>
> - [Optimization workbook](../_optimize/workbooks/optimization/README.md)
> 1. On the Storagetab, included the **RSVaultBackup** tag in the list of non-idle disks.
>
> 🛠️ Fixed:
>
> - [Optimization workbook](../_optimize/workbooks/optimization/README.md)
> 1. On the Commitment discounts tab, fixed RI ROWS Limited.
> 2. On the Compute tab, fixed incorrect VM processor in processors query.
>
> 🗑️ Removed:
>
> - [Optimization workbook](../_optimize/workbooks/optimization/README.md)
> 1. On the Database tab, removed the idle SQL databases query.
> - This query will be re-evaluated and added again in a future release.
<br>

## 🪛 v0.6 Update 1
Expand Down Expand Up @@ -942,4 +978,4 @@ This release is a minor patch to Power BI files. These files were updated in the
[Download v0.0.1](https://github.com/microsoft/finops-toolkit/releases/tag/v0.0.1){: .btn .mt-2 .mb-4 .mb-md-0 .mr-4 }
[Full changelog](https://github.com/microsoft/finops-toolkit/compare/878e4864ca785db4fc13bdd2ec3a6a00058688c3...v0.0.1){: .btn .mt-2 .mb-4 .mb-md-0 .mr-4 }

<br>
<br>
11 changes: 11 additions & 0 deletions docs/_resources/errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ Sorry to hear you're having a problem. We're here to help!
- [UnknownExportFile](#unknownexportfile)
- [UnknownFocusVersion](#unknownfocusversion)
- [UnknownHubVersion](#unknownhubversion)
- [UnsupportedExportFileType](#unsupportedexportfiletype)
- [UnsupportedExportType](#unsupportedexporttype)
- [The \<name\> resource provider is not registered in subscription \<guid\>](#the-name-resource-provider-is-not-registered-in-subscription-guid)
- [x\_PricingSubcategory shows the commitment discount ID](#x_pricingsubcategory-shows-the-commitment-discount-id)
Expand Down Expand Up @@ -421,6 +422,16 @@ Unable to identify the version of FinOps hubs from the settings file. Please ver

<br>

## UnsupportedExportFileType

<sup>Severity: Critical</sup>

Unable to ingest the specified export file because the file type is not supported.

**Mitigation**: Either convert the file to a supported file format before adding to the msexports container or add support for converting the new file type to the msexports_ETL_ingestion pipeline.

<br>

## UnsupportedExportType

<sup>Severity: Warning</sup>
Expand Down
Loading

0 comments on commit a4ddec9

Please sign in to comment.