From ab2c7d72d1e25e89201be2e6e0f1cebc97bb11df Mon Sep 17 00:00:00 2001 From: Helder Pinto Date: Fri, 2 Aug 2024 13:16:37 +0100 Subject: [PATCH] AOE FAQ and setup docs improvements --- README.md | 2 +- docs/README.md | 2 +- docs/_optimize/optimization-engine/faq.md | 11 ++++++++++- .../optimization-engine/setup-options.md | 4 ++++ docs/_resources/changelog.md | 18 ++++++++++++++++++ 5 files changed, 34 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index e4210ace5..d9f150a1a 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ There are many ways to participate. From reporting bugs and requesting features Arjen Huitema
Arjen Huitema
๐Ÿ’ป Bill Anderson
Bill Anderson
๐Ÿ“– - Hรฉlder Pinto
Hรฉlder Pinto
๐Ÿ“– ๐Ÿ› + Hรฉlder Pinto
Hรฉlder Pinto
๐Ÿ’ป ๐Ÿ‘€ ๐Ÿ“– ๐Ÿ› Yuan Zhang
Yuan Zhang
๐Ÿ’ป ymehdimsft
ymehdimsft
๐Ÿ’ป srilatha inavolu
srilatha inavolu
๐Ÿ’ป ๐Ÿ‘€ diff --git a/docs/README.md b/docs/README.md index 5f0944425..59bb3f026 100644 --- a/docs/README.md +++ b/docs/README.md @@ -126,7 +126,7 @@ All the main changes are tracked in the changelog. For additional details, refer Arjen Huitema
Arjen Huitema
๐Ÿ’ป Bill Anderson
Bill Anderson
๐Ÿ“– - Hรฉlder Pinto
Hรฉlder Pinto
๐Ÿ“– ๐Ÿ› + Hรฉlder Pinto
Hรฉlder Pinto
๐Ÿ’ป ๐Ÿ‘€ ๐Ÿ“– ๐Ÿ› Yuan Zhang
Yuan Zhang
๐Ÿ’ป ymehdimsft
ymehdimsft
๐Ÿ’ป srilatha inavolu
srilatha inavolu
๐Ÿ’ป ๐Ÿ‘€ diff --git a/docs/_optimize/optimization-engine/faq.md b/docs/_optimize/optimization-engine/faq.md index e7e97aaca..c92ef4287 100644 --- a/docs/_optimize/optimization-engine/faq.md +++ b/docs/_optimize/optimization-engine/faq.md @@ -17,6 +17,15 @@ All the frequently asked questions about AOE in one place. * **What type of Azure subscriptions/clouds are supported?** AOE has been deployed and tested against EA, MCA and MSDN subscriptions in the Azure commercial cloud (AzureCloud). Although not tested yet, it should also work in MOSA subscriptions. It was designed to also operate in the US Government cloud, though it was never tested there. Sponsorship (MS-AZR-0036P and MS-AZR-0143P), CSP (MS-AZR-0145P, MS-AZR-0146P, and MS-AZR-159P) DreamSpark (MS-AZR-0144P) and Internal subscriptions should also work, but due to lack of availability or disparities in their consumption (billing) exports models, some of the Workbooks may not fully work. +* **Why are my Recommendations workbook and Power BI report still empty after deploying AOE?** AOE takes up to 3 hours after deployment to export and ingest the data required to generate recommendations into Log Analytics / SQL Database. If after this time you aren't still seeing any recommendations, check whether: + * Azure Advisor has been reporting recommendations for the subscriptions in the AOE scope; + * Azure Automation runbooks have been failing, especially critical ones such as `Ingest-` and `Recommend-`, and verify the Exception message that is logged, which will normally give you a hint for the failure cause; + * a daily cap has been set in the AOE Log Analytics Workspace that might be dropping the ingestion of AOE logs after the cap was reached. + +* **Why some workbooks present this message: `Failed to resolve table or column expression named 'AzureOptimizationPricesheetV1_CL'`?** This is typically a symptom of not having granted the required permissions to the AOE Automation Account managed identity. See instructions [here](https://aka.ms/AzureOptimizationEngine/commitmentssetup). + +* **Why is the Identity and Roles workbook empty and presenting error messages?** This is typically a symptom of not having granted the required permissions, at the Entra ID tenant level, to the AOE Automation Account managed identity. After having granted the `Global Reader` role to the AOE managed identity, the workbook should populate on the next day. + * **Why is my Power BI report empty?** Most of the Power BI report pages are configured to filter out recommendations older than 7 days. If it shows empty, just try to refresh the report data. * **Why is my VM right-size recommendations overview page empty?** The AOE depends on Azure Advisor Cost recommendations for VM right-sizing. If no VMs are showing up, try increasing the CPU threshold in the Azure Advisor configuration... or maybe your infrastructure is not oversized after all! @@ -27,7 +36,7 @@ All the frequently asked questions about AOE in one place. * **What is the currency used for costs and savings?** The currency used is the one that is reported by default by the Azure Consumption APIs. It should match the one you usually see in Azure Cost Management. -* **What is the default time span for collecting Azure consumption data?** By default, the Azure consumption exports daily runbook collects 1-day data from 7 days ago. This offset works well for many types of subscriptions. If you're running AOE in PAYG or EA subscriptions, you can decrease the offset by adjusting the `AzureOptimization_ConsumptionOffsetDays` variable. However, using a value less than 2 days is not recommended. +* **What is the default time span for collecting Azure consumption data?** By default, the Azure consumption exports daily runbook collects 1-day data from 3 days ago. This offset works well for many types of subscriptions. If you're running AOE in PAYG or EA subscriptions, you can decrease the offset by adjusting the `AzureOptimization_ConsumptionOffsetDays` variable. However, using a value less than 2 days is not recommended. * **Why is AOE recommending to delete a long-deallocated VM that was deallocated just a few days before?** The _LongDeallocatedVms_ recommendation depends on accurate Azure consumption exports. If you just deployed AOE, it hasn't collected consumption long enough to provide accurate recommendations. Let AOE run at least for 30 days to get accurate recommendations. diff --git a/docs/_optimize/optimization-engine/setup-options.md b/docs/_optimize/optimization-engine/setup-options.md index 6703ea952..4d78fffb6 100644 --- a/docs/_optimize/optimization-engine/setup-options.md +++ b/docs/_optimize/optimization-engine/setup-options.md @@ -73,6 +73,10 @@ parameters, for example to grant the SQL administrator role to an Entra ID group .\Deploy-AzureOptimizationEngine.ps1 -SilentDeploymentSettingsPath "" -SqlAdminPrincipalType Group -SqlAdminPrincipalName "" -SqlAdminPrincipalObjectId "" ``` +
+ When deploying AOE with non-user identities (service principals), you must ensure you assign a system identity to the AOE SQL Server and grant it the `Directory Readers` role in Entra ID. Please follow the steps described [here](https://aka.ms/sqlaadsetup). +
+ ## ๐Ÿค Enabling Azure commitments workbooks In order to leverage the Workbooks that allow you to analyze your Azure commitments usage (`Benefits Usage`, `Reservations Usage` and `Savings Plans Usage`) or estimate the impact of doing additional consumption commitments (`Benefits Simulation` and `Reservations Potential`), you need to configure AOE and grant privileges to its Managed Identity at your consumption agreement level (EA or MCA). If you could not do it during setup/upgrade, you can still execute those extra configuration steps, provided you do it with a user that is **both Contributor in the AOE resource group and have administrative privileges over the consumption agreement** (Enterprise Enrollment Administrator for EA or Billing Profile Owner for MCA). You just have to use the `Setup-BenefitsUsageDependencies.ps1` script following the syntax below and answer the input requests: diff --git a/docs/_resources/changelog.md b/docs/_resources/changelog.md index ee5ef57c2..338f1a676 100644 --- a/docs/_resources/changelog.md +++ b/docs/_resources/changelog.md @@ -76,6 +76,24 @@ Legend: > 1. Added support for FOCUS, pricesheet, and reservation dataset filters in [Get-FinOpsCostExport](../_automation/powershell/cost/Get-FinOpsCostExport.md). > 2. Added a `-DatasetVersion` filter in [Get-FinOpsCostExport](../_automation/powershell/cost/Get-FinOpsCostExport.md). +๐Ÿ” Optimization engine +{: .fs-5 .fw-500 .mt-4 mb-0 } + +> โž• Added: +> +> 1. `Register-MultitenantAutomationSchedules` PowerShell script helper to [add a different Azure tenant to the scope of AOE](../_optimize/optimization-engine/customize.md). +> 2. ZRS disks included in the scope of the `Premium SSD disk has been underutilized` recommendation (besides LRS). +> 3. Option to scope consumption exports to MCA Billing Profile. +> +> โœ๏ธ Changed: +> +> 1. Improved SQL Database security, replacing SQL authentication by Entra ID authentication-only. +> +> ๐Ÿ› ๏ธ Fixed: +> +> 1. `Premium SSD disk has been underutilized` recommendation was not showing results due to a meter name change in Cost Management ([#831](https://github.com/microsoft/finops-toolkit/issues/831)). +> 2. Consumption exports for Pay-As-You-Go MCA subscriptions were missing cost data ([#828](https://github.com/microsoft/finops-toolkit/issues/828)) + ## ๐Ÿšš v0.4 Released July 12, 2024