Skip to content

Commit

Permalink
Updated changelog and fixed workbook links (#804)
Browse files Browse the repository at this point in the history
  • Loading branch information
flanakin authored Jul 11, 2024
1 parent f968203 commit c5f9aab
Show file tree
Hide file tree
Showing 6 changed files with 71 additions and 74 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ At this point, you've defined your organizational objectives, identified how cur

- Evaluate limitations and gaps in existing tools and services and establish a plan to address them.
- Automate tasks with [PowerShell commands](../../../../_automation/powershell/README.md) and [Bicep modules](../../../../_automation/bicep-registry/README.md).
- Consider lightweight tools for engineers, like the [Cost optimization](../../../../_workbooks/optimization-workbook/README.md) or [Governance](../../../../_workbooks/governance-workbook/README.md) workbooks.
- Consider lightweight tools for engineers, like the [Cost optimization](../../../../_optimize/optimization-workbook/README.md) or [Governance](../../../../_optimize/governance-workbook/README.md) workbooks.
- If you're looking for an extensible platform for reporting and analytics, check out [FinOps hubs](../../../../_reporting/hubs/README.md) and connect to your hub from Microsoft Fabric to go even further.
- Document the key processes around the tools and services available to teams.
- Include when to use and how to get started with each.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Establish policies, guidelines, and strategies to optimize cloud sustainability
When you first start with cloud sustainability, you use the native tools to drive efficiency and optimize carbon in the portal.

- Leverage [Azure Carbon Optimization](https://learn.microsoft.com/azure/carbon-optimization/overview) to find opportunities to lower carbon emissions.
- Consider using the [Cost optimization workbook](../../../../_workbooks/optimization-workbook/README.md) to view carbon optimization recommendations alongside other usage and cost efficiency recommendations.
- Consider using the [Cost optimization workbook](../../../../_optimize/optimization-workbook/README.md) to view carbon optimization recommendations alongside other usage and cost efficiency recommendations.
<br>

## 🏗️ Building on the basics
Expand Down
2 changes: 1 addition & 1 deletion docs/_docs/framework/capabilities/optimize/workloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ When you first start managing cost in the cloud, you use the native tools to dri
- Review service documentation to learn about any cost-related features that could help you optimize your environment or improve cost visibility. Some examples:
- Choose [spot VMs](https://learn.microsoft.com/azure/well-architected/cost/optimize-vm#spot-vms) for low priority, interruptible workloads.
- Avoid [cross-region data transfer](https://learn.microsoft.com/azure/well-architected/cost/design-regions#traffic-across-billing-zones-and-regions).
- Use and customize the [Cost optimization workbook](../../../../_workbooks/optimization-workbook/cost-optimization-workbook.md). The Cost Optimization workbook is a central point for some of the most often used tools that can help achieve utilization and efficiency goals.
- Use and customize the [Cost optimization workbook](../../../../_optimize/optimization-workbook/cost-optimization-workbook.md). The Cost Optimization workbook is a central point for some of the most often used tools that can help achieve utilization and efficiency goals.

<br>

Expand Down
2 changes: 1 addition & 1 deletion docs/_docs/framework/capabilities/quantify/planning.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ Starting with well-defined requirements that are aligned across teams helps set

## 🏗️ Building on the basics

- Use the [Cost optimization workbook](../../../../_workbooks/optimization-workbook/README.md) to optimize current workloads and reduce potential future estimates.
- Use the [Cost optimization workbook](../../../../_optimize/optimization-workbook/README.md) to optimize current workloads and reduce potential future estimates.
- Review the [Architecting for cloud](../optimize/architecting.md) capability to ensure workloads are designed for efficiency.
- Evaluate options to reduce costs through the [Rate optimization](../optimize/rates.md) capability.
- Automate best practices through [Azure Policy](https://learn.microsoft.com/azure/governance/policy/overview) to enforce organizational standards at scale.
Expand Down
123 changes: 60 additions & 63 deletions docs/_resources/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,47 +93,70 @@ Legend:

> ➕ Added:
>
> 1. [Data ingestion Ingestion errors page](../_reporting/power-bi/data-ingestion.md#ingestion-errors) to help identify FinOps hub data ingestion issues.
> 2. **x_IncrementalRefreshDate** column to facilitate configuring incremental refresh in Power BI.
> 3. Resource count and cost per resource in the [Cost summary Inventory page](../_reporting/power-bi/cost-summary.md#inventory).
> - General:
> 1. **x_IncrementalRefreshDate** column to facilitate configuring incremental refresh in Power BI.
> - [Cost summary](../_reporting/power-bi/cost-summary.md):
> 1. Resource count and cost per resource in the [Inventory page](../_reporting/power-bi/cost-summary.md#inventory).
> - [Data ingestion](../_reporting/power-bi/data-ingestion.md):
> 1. [Ingestion errors page](../_reporting/power-bi/data-ingestion.md#ingestion-errors) to help identify FinOps hub data ingestion issues.
>
> ✏️ Changed
>
> 1. Renamed the "Commitment discounts" report to "Rate optimization" to align to the FinOps Framework 2024 updates.
> 2. Changed the **Tags** column to default to `{}` when empty to facilitate tag expansion ([#691](https://github.com/microsoft/finops-toolkit/issues/691#issuecomment-2134072033)).
> 3. Changed internal storage for reports to use [Tabular Model Definition Language (TMDL)](https://learn.microsoft.com/power-bi/developer/projects/projects-dataset#tmdl-format).
> - This change makes it easier to review changes to the data model in Power BI.
> - Reports will still be released as PBIX files so this change should not impact end users.
> - Visualizations are not being switched to [Power BI Enhanced Report (PBIR)](https://learn.microsoft.com/power-bi/developer/projects/projects-report#pbir-format) format yet due to functional limitations that would impact end users (as of June 2024).
> 4. Optimized [Data ingestion report](../_reporting/power-bi/data-ingestion.md) queries to reduce memory footprint and load faster.
> 5. Updated the [Cost summary DQ page](../_reporting/power-bi/cost-summary.md#dq) to identify empty ChargeDescription rows.
> 6. Updated the [Cost summary DQ page](../_reporting/power-bi/cost-summary.md#dq) to identify potentially missing rounding adjustments.
> <blockquote class="warning" markdown="1">
> _We are investigating an issue where we are missing rounding adjustments since May 2024. We do not yet know the cause of this issue._
> </blockquote>
> 7. Simplified formatting for the `BillingPeriod` and `ChargePeriod` measures in Power BI.
> 8. Changed the [Cost summary Purchases page](../_reporting/power-bi/cost-summary.md#purchases) and [Rate optimization Purchases page](../_reporting/power-bi/rate-optimization.md#purchases) to use PricingQuantity instead of Usage/ConsumedQuantity and added the PricingUnit column.
> 9. Improved error handling for derived savings columns in the CostDetails query.
> - General:
> 1. Changed the **Tags** column to default to `{}` when empty to facilitate tag expansion ([#691](https://github.com/microsoft/finops-toolkit/issues/691#issuecomment-2134072033)).
> 2. Simplified formatting for the `BillingPeriod` and `ChargePeriod` measures in Power BI.
> 3. Improved error handling for derived savings columns in the CostDetails query.
> 4. Changed internal storage for reports to use [Tabular Model Definition Language (TMDL)](https://learn.microsoft.com/power-bi/developer/projects/projects-dataset#tmdl-format).
> - This change makes it easier to review changes to the data model in Power BI.
> - Reports will still be released as PBIX files so this change should not impact end users.
> - Visualizations are not being switched to [Power BI Enhanced Report (PBIR)](https://learn.microsoft.com/power-bi/developer/projects/projects-report#pbir-format) format yet due to functional limitations that would impact end users (as of June 2024).
> - [Cost summary](../_reporting/power-bi/cost-summary.md):
> 1. Changed the [Cost summary Purchases page](../_reporting/power-bi/cost-summary.md#purchases) and [Rate optimization Purchases page](../_reporting/power-bi/rate-optimization.md#purchases) to use PricingQuantity instead of Usage/ConsumedQuantity and added the PricingUnit column.
> 2. Updated the [DQ page](../_reporting/power-bi/cost-summary.md#dq) to identify empty ChargeDescription rows.
> 3. Updated the [DQ page](../_reporting/power-bi/cost-summary.md#dq) to identify potentially missing rounding adjustments.
> - [Rate optimization](../_reporting/power-bi/rate-optimization.md):
> 1. Renamed the "Commitment discounts" report to "Rate optimization" to align to the FinOps Framework 2024 updates.
> - [Data ingestion](../_reporting/power-bi/data-ingestion.md):
> 1. Optimized [Data ingestion report](../_reporting/power-bi/data-ingestion.md) queries to reduce memory footprint and load faster.
> <blockquote class="warning" markdown="1">
> _We are investigating an issue where we are missing rounding adjustments since May 2024. We do not yet know the cause of this issue._
> </blockquote>
>
> 🛠️ Fixed:
>
> 1. Improved parsing for the `x_ResourceParentName` and `x_ResourceParentType` columns ([#691](https://github.com/microsoft/finops-toolkit/issues/691#issuecomment-2134072033)).
> 2. Added error handling for missing `normalizedSize` and `recommendedQuantityNormalized` columns in the [Rate optimization (Commitment discounts) report](../_reporting/power-bi/rate-optimization.md) ([#702](https://github.com/microsoft/finops-toolkit/issues/702)).
> 3. Fixed error in [Data ingestion report](../_reporting/power-bi/data-ingestion.md) queries.
> - General:
> 1. Improved parsing for the `x_ResourceParentName` and `x_ResourceParentType` columns ([#691](https://github.com/microsoft/finops-toolkit/issues/691#issuecomment-2134072033)).
> - [Rate optimization](../_reporting/power-bi/rate-optimization.md):
> 1. Added error handling for missing `normalizedSize` and `recommendedQuantityNormalized` columns in the [Rate optimization (Commitment discounts) report](../_reporting/power-bi/rate-optimization.md) ([#702](https://github.com/microsoft/finops-toolkit/issues/702)).
> - [Data ingestion](../_reporting/power-bi/data-ingestion.md):
> 1. Fixed error in [Data ingestion report](../_reporting/power-bi/data-ingestion.md) queries.
🔍 Optimization engine
📒 Azure Monitor workbooks
{: .fs-5 .fw-500 .mt-4 mb-0 }

> ➕ Added:
>
> 1. Added Azure Optimization Engine (AOE), an extensible solution for custom optimization recommendations.
> - [Optimization workbook](../_optimize/optimization-workbook/README.md):
> 1. Added reservation recommendations with the break-even point to identify when savings would be achieved.
> 2. Identify idle ExpressRoute circuits to streamline costs.
> 3. Gain insights into the routing preferences for public IP addresses to optimize network performance.
> 4. Explore commitment discount savings to get a clear overview of rate optimization opportunities.
> 5. Quickly view public IP addresses with DDoS protection enabled and compare if it would be cheaper to enable DDoS to the vNet instead.
> 6. Identify Azure Hybrid Benefit usage for SQL Database elastic pools to maximize cost efficiency.
>
> ✏️ Changed:
>
> - [Optimization workbook](../_optimize/optimization-workbook/README.md):
> 1. Redesigned the Sustainability tab to clarify recommendations.
> 2. Ignore dynamic IPs in the public IP addresses list to ensure more accurate results.
> 3. Ignore free tier web apps to provide a clearer picture of your top services.
🖥️ PowerShell
🔍 Optimization engine
{: .fs-5 .fw-500 .mt-4 mb-0 }

> 🗑️ Removed:
> ➕ Added:
>
> 1. Removed `ConvertTo-FinOpsSchema` and `Invoke-FinOpsSchemaTransform` commands which were deprecated in [0.2 (January 2024)](#-v02).
> 1. Added Azure Optimization Engine (AOE), an extensible solution for custom optimization recommendations.
🖥️ PowerShell
{: .fs-5 .fw-500 .mt-4 mb-0 }
Expand All @@ -143,17 +166,15 @@ Legend:
> 1. Added progress tracking to [Start-FinOpsCostExport](../_automation/powershell/cost/Start-FinOpsCostExport.md) for multi-month exports.
> 2. Added a 60-second delay when Cost Management returns throttling (429) errors in [Start-FinOpsCostExport](../_automation/powershell/cost/Start-FinOpsCostExport.md).
>
> ✏️ Changed:
>
> 1. Updated [New-FinOpsCostExport](../_automation/powershell/cost/New-FinOpsCostExport.md) to default to FOCUS 1.0.
>
> 🗑️ Removed:
>
> 1. Removed support for Windows PowerShell.
> > _We discovered errors with Windows PowerShell due to incompatibilities in Windows PowerShell and PowerShell 7. Due to our limited capacity, we decided to only support [PowerShell 7](https://learn.microsoft.com/powershell/scripting/install/installing-powershell) going forward._
🖥️ PowerShell
{: .fs-5 .fw-500 .mt-4 mb-0 }

> ✏️ Changed:
>
> 1. Updated [New-FinOpsCostExport](../_automation/powershell/cost/New-FinOpsCostExport.md) to default to FOCUS 1.0.
> 2. Removed `ConvertTo-FinOpsSchema` and `Invoke-FinOpsSchemaTransform` commands which were deprecated in [0.2 (January 2024)](#-v02).
🌐 Open data
{: .fs-5 .fw-500 .mt-4 mb-0 }
Expand Down Expand Up @@ -241,30 +262,6 @@ Legend:
> 6. Changed the `x_PricingBlockSize` column to a whole number and not summarize by default.
> 7. Renamed the **Coverage** pages in the [Commitment discounts report](../_reporting/power-bi/rate-optimization.md) to **Recommendations**.
📒 Azure Monitor workbooks
{: .fs-5 .fw-500 .mt-4 mb-0 }

**May**:

> 1. 🔹 Reservations Recommendations:<br>
> New Tab: We've added a new tab specifically for Reservations recommendations. <br>This tab includes a handy **Break-Even Point** feature, allowing you to prioritize recommendations that will reach their break-even point sooner.
> > :warning: **Permissions**: Please note, this tab now requires Enterprise Admin or Billing Profile Reader permissions. We have kept the old tab for the time being to ensure a smooth transition.
> 2. 🔹 Sustainability: <br>
> Redesigned Tab: The sustainability tab has been completely redesigned with an improved layout, making it easier to understand the provided recommendations.
> 3. 🔹 Networking Tab: <br>
> Query Improvement: The Public IP Addresses query has been enhanced to ignore dynamic IPs, ensuring more accurate results.
> 4. 🔹 Top 10 Services:<br>
> Web App Query Update: The Web App query now ignores the free tier, providing a clearer picture of your top services.
> **April**:
> ➕ Added:
>
> 1. 1️⃣🕵️‍♂️ Identify Idle ExpressRoute Circuits: Now, easily pinpoint and optimize inactive ExpressRoute circuits to streamline costs.
> 2. 2️⃣ 📊Routing Preference for Public IP Addresses: Gain insights into the routing preferences for your public IP addresses to optimize network performance.
> 3. 3️⃣ 🥧Commitment Discount Savings Summary: Explore a new pie chart summarizing commitment discount savings, providing a clear overview of cost-saving opportunities.
> 4. 4️⃣ 💰DDoS-enabled Public IP Addresses Query: Quickly view public IP addresses with DDoS protection enabled and compare if it would be cheaper to enable DDoS to the vNet instead.
> 5. 5️⃣ 💡Azure Hybrid Benefit for SQL Database Elastic Pools: Leverage new queries to identify Azure Hybrid Benefit usage for SQL Database elastic pools, maximizing cost efficiencies.
🖥️ PowerShell
{: .fs-5 .fw-500 .mt-4 mb-0 }

Expand Down Expand Up @@ -352,20 +349,20 @@ Legend:

> ➕ Added:
>
> - [Optimization workbook](../_workbooks/optimization-workbook/README.md):
> - [Optimization workbook](../_optimize/optimization-workbook/README.md):
> 1. Storage: Identify Idle Backups: Review protected items' backup activity to spot items not backed up in the last 90 days.
> 2. Storage: Review Replication Settings: Evaluate and improve your backup strategy by identifying resources with default geo-redundant storage (GRS) replication.
> 3. Networking: Azure Firewall Premium Features: Identify Azure Firewalls with Premium SKU and ensure associated policies leverage premium-only features.
> 4. Networking: Firewall Optimization: Streamline Azure Firewall usage by centralizing instances in the hub virtual network or Virtual WAN secure hub.
>
> ✏️ Changed:
>
> - [Optimization workbook](../_workbooks/optimization-workbook/README.md):
> - [Optimization workbook](../_optimize/optimization-workbook/README.md):
> 1. Top 10 services: Improved Monitoring tabs: Enhance your monitoring experience with updated Azure Advisor recommendations for Log Analytics.
>
> 🛠️ Fixed:
>
> - [Optimization workbook](../_workbooks/optimization-workbook/README.md):
> - [Optimization workbook](../_optimize/optimization-workbook/README.md):
> 1. AHB: Fixed AHB to support Windows 10/Windows 11
🖥️ PowerShell
Expand Down Expand Up @@ -500,11 +497,11 @@ Legend:

> ➕ Added:
>
> 1. [Governance workbook](../_workbooks/governance-workbook/README.md) to centralize governance.
> 1. [Governance workbook](../_optimize/governance-workbook/README.md) to centralize governance.
>
> ✏️ Changed:
>
> 1. [Optimization workbook](../_workbooks/optimization-workbook/README.md) updated to cover more scenarios.
> 1. [Optimization workbook](../_optimize/optimization-workbook/README.md) updated to cover more scenarios.
🌐 Open data
{: .fs-5 .fw-500 .mt-4 mb-0 }
Expand Down Expand Up @@ -545,7 +542,7 @@ Legend:

> ➕ Added:
>
> 1. [Cost optimization workbook](../_workbooks/optimization-workbook/README.md) to centralize cost optimization.
> 1. [Cost optimization workbook](../_optimize/optimization-workbook/README.md) to centralize cost optimization.
[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 }
Expand Down
Loading

1 comment on commit c5f9aab

@helderpinto
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am sorry for the broken links, @flanakin. This one was very basic 🤦

Please sign in to comment.