Skip to content

Commit

Permalink
Update open data docs
Browse files Browse the repository at this point in the history
  • Loading branch information
flanakin committed Feb 20, 2024
1 parent 3a9f84e commit 5895d3e
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 28 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Leverage open data to normalize and enhance your FinOps reporting.

---

Reporting is the life-blood of any FinOps initiative. And your reports are only as good as your data. This is why [data ingestion and normalization](https://learn.microsoft.com/azure/cost-management-billing/finops/capabilities-ingestion-normalization) is such an important part of FinOps (and any big data effort). The following datasets can be used to clean and normalize your data as part of data ingestion, reporting, or other solutions.
Reporting is the life-blood of any FinOps initiative. And your reports are only as good as your data. This is why [data ingestion and normalization](../../_docs/framework/capabilities/understand/ingestion.md) is such an important part of FinOps (and any big data effort). The following datasets can be used to clean and normalize your data as part of data ingestion, reporting, or other solutions.

<br>

Expand Down Expand Up @@ -56,15 +56,11 @@ A few important notes about the data:
4. Marketplace meters are not included due to inconsistencies that would impact data size.

<blockquote class="note" markdown="1">
_`UnitOfMeasure` maps to `PricingUnit` in FOCUS 1.0._
</blockquote>

<blockquote class="tip" markdown="1">
_You can also integrate service data into your workflow with the [Get-FinOpsService](../../_automation/powershell/data/Get-FinOpsService) PowerShell command._
_In the Cost Management FOCUS dataset, `UnitOfMeasure` is renamed to `x_PricingUnitDescription`. Both `PricingUnit` and `UsageUnit` in FOCUS are set to the `DistictUnits` column._
</blockquote>

[Download](https://github.com/microsoft/finops-toolkit/releases/latest/download/PricingUnits.csv){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsPricingUnit){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsPricingUnit.md){: .btn .mb-4 .mb-md-0 .mr-4 }

<br>

Expand All @@ -86,12 +82,8 @@ Sample data:

<!-- cSpell:enable -->

<blockquote class="tip" markdown="1">
_You can also integrate service data into your workflow with the [Get-FinOpsRegion](../../_automation/powershell/data/Get-FinOpsRegion) PowerShell command._
</blockquote>

[Download](https://github.com/microsoft/finops-toolkit/releases/latest/download/Regions.csv){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsRegion){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsRegion.md){: .btn .mb-4 .mb-md-0 .mr-4 }

<br>

Expand All @@ -117,13 +109,9 @@ Sample data:

<!-- cSpell:enable -->

<blockquote class="tip" markdown="1">
_You can also integrate resource type data into your workflow with the [Get-FinOpsResourceType](../../_automation/powershell/data/Get-FinOpsResourceType) PowerShell command._
</blockquote>

[Download CSV](https://github.com/microsoft/finops-toolkit/releases/latest/download/ResourceTypes.csv){: .btn .fs-5 .mb-4 .mb-md-0 .mr-4 }
[Download JSON](https://github.com/microsoft/finops-toolkit/releases/latest/download/ResourceTypes.json){: .btn .fs-5 .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsResourceType){: .btn .fs-5 .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsResourceType.md){: .btn .fs-5 .mb-4 .mb-md-0 .mr-4 }

<br>

Expand Down Expand Up @@ -152,12 +140,8 @@ A few important notes about the data:
3. `ServiceName` values should match the product marketing name for the closest possible service. Some services reuse resource types and cannot be distinguished from the resource type alone (e.g., Azure functions will show as App Service).
4. `ServiceCategory` values are aligned with the allowed values in FOCUS.

<blockquote class="tip" markdown="1">
_You can also integrate service data into your workflow with the [Get-FinOpsService](../../_automation/powershell/data/Get-FinOpsService) PowerShell command._
</blockquote>

[Download](https://github.com/microsoft/finops-toolkit/releases/latest/download/Services.csv){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsService){: .btn .mb-4 .mb-md-0 .mr-4 }
[See PowerShell](../../_automation/powershell/data/Get-FinOpsService.md){: .btn .mb-4 .mb-md-0 .mr-4 }

<br>

Expand Down
12 changes: 6 additions & 6 deletions docs/_resources/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ Legend:

> ➕ Added:
>
> 1. New and updated [resource types](./open-data/README.md#-resource-types) and icons.
> 1. New and updated [resource types](../_reporting/data/README.md#-resource-types) and icons.
[Download v0.2.1](https://github.com/microsoft/finops-toolkit/releases/tag/v0.2.1){: .btn .mt-2 .mb-4 .mb-md-0 .mr-4 }
[Full changelog](https://github.com/microsoft/finops-toolkit/compare/v0.2...v0.2.1){: .btn .mt-2 .mb-4 .mb-md-0 .mr-4 }
Expand Down Expand Up @@ -240,9 +240,9 @@ Legend:

> ➕ Added:
>
> 1. [Resource types](../_reporting/open-data/README.md#-resource-types) to map Azure resource types to friendly display names.
> 1. [Resource types](../_reporting/data/README.md#-resource-types) to map Azure resource types to friendly display names.
> 2. [Get-FinOpsResourceType](../_automation/powershell/data/Get-FinOpsResourceType.md) PowerShell command to support resource type to display name mapping.
> 3. [Sample exports](../_reporting/open-data/README.md#-sample-data) for each of the datasets that can be exported from Cost Management.
> 3. [Sample exports](../_reporting/data/README.md#-sample-data) for each of the datasets that can be exported from Cost Management.
📗 FinOps guide
{: .fs-5 .fw-500 .mt-4 mb-0 }
Expand Down Expand Up @@ -350,9 +350,9 @@ Legend:

> ➕ Added:
>
> 1. [Pricing units](../_reporting/open-data/README.md#-pricing-units) to map all pricing units (UnitOfMeasure values) to distinct units with a scaling factor.
> 2. [Regions](../_reporting/open-data/README.md#-regions) to map historical resource location values in Microsoft Cost Management to standard Azure regions.
> 3. [Services](../_reporting/open-data/README.md#-services) to map all resource types to FOCUS service names and categories.
> 1. [Pricing units](../_reporting/data/README.md#-pricing-units) to map all pricing units (UnitOfMeasure values) to distinct units with a scaling factor.
> 2. [Regions](../_reporting/data/README.md#-regions) to map historical resource location values in Microsoft Cost Management to standard Azure regions.
> 3. [Services](../_reporting/data/README.md#-services) to map all resource types to FOCUS service names and categories.
[Download v0.1](https://github.com/microsoft/finops-toolkit/releases/tag/v0.1){: .btn .btn-primary .mt-2 .mb-4 .mb-md-0 .mr-4 }
[Full changelog](https://github.com/microsoft/finops-toolkit/compare/v0.0.1...v0.1){: .btn .mt-2 .mb-4 .mb-md-0 .mr-4 }
Expand Down

0 comments on commit 5895d3e

Please sign in to comment.