AVS-Landing-Zone/GreenField/PowerShell/5.reporting/deploy.ps1

###############################################
#                                             #
#  Author : Fletcher Kelly                    #
#  Github : github.com/fskelly                #
#  Purpose : AVS - Deploy reporting sample    #
#  Built : 21-July-2022                       #
#  Last Tested : 02-August-2022               #
#  Language : PowerShell                      #
#                                             #
###############################################


#### WORK IN PROGRESS ####

## Important link around azure-partner-customer-usage-attribution
## https://docs.microsoft.com/en-gb/azure/marketplace/azure-partner-customer-usage-attribution#notify-your-customers

<# 
Notification for SDK or API deployments
When you deploy <PARTNER> software, Microsoft can identify the installation of <PARTNER> software with the deployed Azure resources. Microsoft can correlate these resources used to support the software. Microsoft collects this information to provide the best experiences with their products and to operate their business. The data is collected and governed by Microsoft's privacy policies, located at https://www.microsoft.com/trustcenter. 
#>

## Telemetry enabled by default, Can be disabled by change the value of the telemetry parameter to false
$telemetry = $true

if ($telemetry) {
  ## https://docs.microsoft.com/en-gb/azure/marketplace/azure-partner-customer-usage-attribution#notify-your-customers
    Write-Output "Telemetry enabled"
    $telemetryId = "pid-1b3bba10-820a-4081-9c50-a3b9861be3f9"
    [Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent($telemetryId)
} else {
    Write-Host "Telemetry disabled"
}

## resource group variables
## Define location for resource groups
$technology = "avs"
$resourceGroupLocation = ""

$actionGroupRgName = "$technology-$resourceGroupLocation-operational_rg"

## GUID work
$guid = New-Guid
$actionGroupSuffix = $guid.ToString().Split("-")[0]
$actionGroupName = "avs_" + $actionGroupSuffix

$receivers = "email@contoso.com"

foreach ($receiver in $receivers) {
    $name = $receiver.Split("@")[0].replace(".","")
    $email = $receiver
    # $emailReceiver = New-AzActionGroupReceiver -Name $name -EmailReceiver -EmailAddress '$email'
    $emailReceiver = New-AzActionGroupReceiver -Name $name -EmailReceiver -EmailAddress $email
    $actionGroup = Set-AzActionGroup -Name $actionGroupName -ShortName "avsalerts" -ResourceGroupName $actionGroupRgName -Receiver $emailReceiver
}

# Creates an ActionGroup reference object in memory.
$actionGroupId = New-AzActionGroup -ActionGroupId $actionGroup.Id

## Reporting variables
$technology = "avs"
$resourceGroupLocation = ""
$privateCloudRgName = "$technology-$resourceGroupLocation-private_cloud_rg"
$privateCloud = Get-AzVMwarePrivateCloud -ResourceGroupName $privateCloudRgName

## varibales for alerts
$subID = (Get-AzContext).Subscription.id
$privateCloudName = $privateCloud.Name

## Dimension variables
$clusternameDim1 = New-AzMetricAlertRuleV2DimensionSelection -DimensionName "clustername" -ValuesToInclude "*"

## EffectiveCpuAverage
$criteria1 = New-AzMetricAlertRuleV2Criteria -MetricName "EffectiveCpuAverage" -DimensionSelection $clusternameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 80
$criticalCriteria1 = New-AzMetricAlertRuleV2Criteria -MetricName "EffectiveCpuAverage" -DimensionSelection $clusternameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 95
$targetResourceID = "/subscriptions/$subID/resourceGroups/$privateCloudRgName/providers/Microsoft.AVS/privateClouds/$privateCloudName"
Add-AzMetricAlertRuleV2 -Name "EffectiveCpuAverage" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criteria1 -ActionGroup $act -Severity 2 -Description "CPU Usage per Cluster"
Add-AzMetricAlertRuleV2 -Name "EffectiveCpuAverage" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criticalCriteria1 -ActionGroup $act -Severity 0 -Description "CPU Usage per Cluster (Critical)"

## UsageAverage
$criteria2 = New-AzMetricAlertRuleV2Criteria -MetricName "UsageAverage" -DimensionSelection $clusternameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 80
$criticalCriteria2 = New-AzMetricAlertRuleV2Criteria -MetricName "UsageAverage" -DimensionSelection $clusternameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 95
$targetResourceID = "/subscriptions/$subID/resourceGroups/$privateCloudRgName/providers/Microsoft.AVS/privateClouds/$privateCloudName"
Add-AzMetricAlertRuleV2 -Name "UsageAverage" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criteria2 -ActionGroup $act -Severity 2 -Description "Memory Usage per Cluster"
Add-AzMetricAlertRuleV2 -Name "UsageAverage" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criticalcriteria2 -ActionGroup $act -Severity 0 -Description "Memory Usage per Cluster (Critical)"

## Dimension variables
$dsnameDim1 = New-AzMetricAlertRuleV2DimensionSelection -DimensionName "dsname" -ValuesToInclude "*"

## DiskUsedPercentage
$criteria3 = New-AzMetricAlertRuleV2Criteria -MetricName "DiskUsedPercentage" -DimensionSelection $dsnameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 70
Add-AzMetricAlertRuleV2 -Name "DiskUsedPercentage" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criteria2 -ActionGroup $act -Severity 2 -Description "Storage Usage per Datastore"

## DiskUsedPercentage
$criteria4 = New-AzMetricAlertRuleV2Criteria -MetricName "DiskUsedPercentage" -DimensionSelection $dsnameDim1 -TimeAggregation Average -Operator GreaterThan -Threshold 75
Add-AzMetricAlertRuleV2 -Name "DiskUsedPercentageCritical" -ResourceGroupName $actionGroupRgName -WindowSize 0:30 -Frequency 0:5 -TargetResourceId $targetResourceID -Condition $criteria2 -ActionGroup $act -Severity 0 -Description "Storage Usage per Datastore Critical"

## Azure Activity Log Alerts (work in progress)
## TODO - Look at continuing to use bicep file and pass parameters to the script
#$condition1 = New-AzActivityLogAlertCondition -Field 'category' -Equal 'ServiceHealth'
#$condition2 = New-AzActivityLogAlertCondition -Field 'properties.impactedServices[*].ServiceName' -equal 'Azure VMware Solution'
#$condition3 = New-AzActivityLogAlertCondition -Field 'properties.impactedServices[*].ImpactedRegions[*].RegionName' -equal 'germanywestcentral'

## TODO - convert dashboard to workbook? (work in progress)
## deploy workbook as referenced object