This function app automatically checks if you have orphan resources or non enabled hybrid use benefits on specified subscription.
You can also specify exception if you explicitely don't want to check specific resources.
Coupled with a common monitoring system (nagios, centreon, zabbix, or whatever you use), you'll automatically get alerted as soon as a virtual machine is not protected as it should be.
- An "app registration" account (client id, valid secret and tenant id).
- Reader RBAC role for this account on all subscriptions you want to monitor.
Once you have all the requirements, you can deploy the Azure function with de "Deploy" button below:
This will deploy an Azure app function with its storage account, app insights and "consumption" app plan. A keyvault will also be deployed to securely store the secret of your app principal.
Choose you Azure subscription, region and create or select a resource group.
-
App Name:
You can customize a name for resources that will be created. -
Tenant ID:
If your subscription depends on the same tenant than the account used to retrieve subscriptions information, then you can use the default value.
Otherwise, enter the tenant ID of the account. -
Subscription Reader Application ID:
Client ID of the account used to retrieve subscriptions information. -
Subscription Reader Secret:
Secret of the account used to retrieve subscriptions information. -
Zip Release URL:
For testing, you can leave it like it.
For more serious use, I would advise you host your own zip file so that you wouldn't be subject to release changes done in this repository.
See below for more details. -
Global Exceptions:
There are some resources that you might not want to check.
You can specify comma separated names. -
Signature:
When this function will be called by your monitoring system, you likely might forget about it.
The signature output will act a reminder since you'll get it in the results to your monitoring system.
When deployment is done, you can get your Azure function's URL in the output variables.
Trigger it manually in your favorite browser and eventually look at the logs in the function.
After you execute the function for the first time, it might (will) need 5-10 minutes before it works because it has to install Az module. You even might get an HTTP 500 error. Give the function some time to initialize, re-execute it again if necessary and be patient, it will work.
Even after that, you might experience issue if Azure takes time to resolve your newly created keyvault:
Wait a short time and then restart your Azure function, your should have something like:
From there, you just have to call your function's URL from your monitoring system.
You can find a script example in "monitoring-script-example" folder which makes a GET request, outputs the result, looks for "CRITICAL" or "WARNING" in the text and use the right exit code accordingly.
Calling the function once a day should be enough.
You have make 1 function call per subscription by specifying the subscriptionid in the GET parameters: &subscriptionid=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
You can specify comma separated resource names to exclude with &exclusions=vm1,snapshotXXX,nic-abcdef
You can also specify comma separated check types to exclude with &exclusiontypes=XXX
XXX can be: disks, nics, nsgs, pubips, routes, snapshots, vmhub, finopstag, sqlvmhub, sqlhub.
Be sure to have an appropriate timeout (30s or more) because if you have many resources, the function might need some time to execute.
This is an example of what you'd get in Centreon:
To make your function to stop relying on this repo's zip and become independant, follow these steps:
- remove zipReleaseURL app setting and restart app
- in "App files" section, edit "requirements.psd1" and uncomment the line: 'Az' = '6.*'
- in "Functions" section, add a new function called "AzureOrphanResourcesCheck" and paste in it the content of the file release/AzureOrphanResourcesCheck/run.ps1 in this repository