{"id":19099791,"url":"https://github.com/Azure/azqr","last_synced_at":"2025-04-18T17:32:01.970Z","repository":{"id":63183014,"uuid":"552832415","full_name":"Azure/azqr","owner":"Azure","description":"Azure Quick Review","archived":false,"fork":false,"pushed_at":"2024-10-29T15:12:49.000Z","size":2122,"stargazers_count":505,"open_issues_count":0,"forks_count":79,"subscribers_count":17,"default_branch":"main","last_synced_at":"2024-10-30T11:01:26.547Z","etag":null,"topics":["aprl","assessment","assessment-tool","azqr","azure","hacktoberfest","hacktoberfest-accepted","review"],"latest_commit_sha":null,"homepage":"https://azure.github.io/azqr","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Azure.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-17T09:47:59.000Z","updated_at":"2024-10-29T15:01:53.000Z","dependencies_parsed_at":"2023-10-11T11:23:07.030Z","dependency_job_id":"e0dd2f9c-2ce0-4b77-8b8d-e89b7d0519d2","html_url":"https://github.com/Azure/azqr","commit_stats":{"total_commits":441,"total_committers":13,"mean_commits":33.92307692307692,"dds":"0.15646258503401356","last_synced_commit":"07bc2201f6afeaf162f28589d1273b9325efd380"},"previous_names":["cmendible/azqr"],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazqr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazqr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazqr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azure%2Fazqr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Azure","download_url":"https://codeload.github.com/Azure/azqr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223305191,"owners_count":17123364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aprl","assessment","assessment-tool","azqr","azure","hacktoberfest","hacktoberfest-accepted","review"],"created_at":"2024-11-09T03:52:17.503Z","updated_at":"2025-04-18T17:32:01.962Z","avatar_url":"https://github.com/Azure.png","language":"Go","funding_links":[],"categories":["hacktoberfest","Official","azure"],"sub_categories":["Official Repositories and Tools"],"readme":"[![build](https://github.com/Azure/azqr/actions/workflows/build.yaml/badge.svg)](https://github.com/Azure/azqr/actions/workflows/build.yaml)\n[![CodeQL](https://github.com/Azure/azqr/actions/workflows/codeql.yml/badge.svg)](https://github.com/Azure/azqr/actions/workflows/codeql.yml)\n[![Github All Releases](https://img.shields.io/github/downloads/Azure/azqr/total.svg)]()\n[![codecov](https://codecov.io/gh/Azure/azqr/branch/main/graph/badge.svg?token=VReik9rs3l)](https://codecov.io/gh/Azure/azqr)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/9896/badge)](https://www.bestpractices.dev/projects/9896)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/Azure/azqr.svg)](http://isitmaintained.com/project/Azure/azqr \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/Azure/azqr.svg)](http://isitmaintained.com/project/Azure/azqr \"Percentage of issues still open\")\n\n# Azure Quick Review\n\n[![Open in vscode.dev](https://img.shields.io/badge/Open%20in-vscode.dev-blue)](https://vscode.dev/github/Azure/azqr)\n\n![Azure Quick Review](/docs/static/logo/azqr_readme.png)\n\n**Azure Quick Review (azqr)** is a powerful command-line interface (CLI) tool that specializes in analyzing Azure resources to ensure compliance with Azure's best practices and recommendations. Its main objective is to offer users a comprehensive overview of their Azure resources, allowing them to easily identify any non-compliant configurations or areas for improvement.\n\n## Azure Quick Review Recommendations\n\n**Azure Quick Review (azqr)** scans your resources with 3 types of recommendations:\n\n* **Azure Resource Graph (ARG)** queries provided by the [Azure Proactive Resiliency Library v2 (APRL)](https://aka.ms/aprl) project\n* **Azure Resource Manager (ARM)** rules built with the Azure Golang SDK\n* **Azure Orphan Resources (ARG)** queries provided by the [Azure Orphan Resources](https://github.com/dolevshor/azure-orphan-resources) project\n\nTo learn more about the recommendations used by **Azure Quick Review (azqr)**, you can refer to the documentation available [here](https://azure.github.io/azqr/docs/recommendations/).\n\n## Scan Results\n\nThe output generated by **Azure Quick Review (azqr)** is written by default to an Excel file, which contains the following sheets:\n\n* **Recommendations**: a list with all recommendations with the number of resources that are impacted. You can use this table as an action plan to improve the compliance of your resources.\n* **ImpactedResources**: a list with all resources that are impacted. You can use this table to identify resources that have issues that need to be addressed.\n* **ResourceTypes**: a list of impacted resource types.\n* **Inventory**: a list of all resources scanned by the tool. Here you'll find details such as SKU, Tier, Kind or calculated SLA.\n* **Advisor**: a list of recommendations provided by Azure Advisor.\n* **DefenderRecommendations**: a list of recommendations provided by Microsoft Defender for Cloud.\n* **OutOfScope**: a list of resources that were not scanned.\n* **Defender**: a list of Microsoft Defender for Cloud plans and their tiers.\n* **Costs**: a list of costs associated with the scanned subscription for the last 3 months.\n\n\u003e By default, Azure Quick Review (azqr) obfuscates the Subscription Ids in the output to ensure the protection of sensitive information and maintain data privacy and security. If you want to display the Subscription Ids without obfuscation, you can use the `--mask=false` flag when executing the tool.\n\n\u003e Azure Quick Review can also generate an csv files with the same information as the excel. To generate the csv files, you can use the `--csv` flag when running the tool.\n\n\u003e A Power BI template is also available to help you visualize the results generated by Azure Quick Review. You can create the template running Azure Quick Review with the `pbi` command and then loading the excel file generated by the tool.\n\n## Supported Azure Services\n\n**Azure Quick Review (azqr)** currently supports the following Azure services:\n\nAbbreviation  | Resource Type\n---|---\naa | Microsoft.Automation/automationAccounts\nadf | Microsoft.DataFactory/factories\nafd | Microsoft.Cdn/profiles\nafw | Microsoft.Network/azureFirewalls\nafw | Microsoft.Network/ipGroups\nagw | Microsoft.Network/applicationGateways\naks | Microsoft.ContainerService/managedClusters\namg | Microsoft.Dashboard/grafana\napim | Microsoft.ApiManagement/service\nappcs | Microsoft.AppConfiguration/configurationStores\nappi | Microsoft.Insights/components\nappi | Microsoft.Insights/activityLogAlerts\nas | Microsoft.AnalysisServices/servers\nasp | Microsoft.Web/serverFarms\nasp | Microsoft.Web/sites\nasp | Microsoft.Web/connections\nasp | Microsoft.Web/certificates\navail | Microsoft.Compute/availabilitySets\navd | Specialized.Workload/AVD\navs | Microsoft.AVS/privateClouds\navs | Specialized.Workload/AVS\nba | Microsoft.Batch/batchAccounts\nca | Microsoft.App/containerApps\ncae | Microsoft.App/managedenvironments\nci | Microsoft.ContainerInstance/containerGroups\ncog | Microsoft.CognitiveServices/accounts\ncon | Microsoft.Network/connections\ncosmos | Microsoft.DocumentDB/databaseAccounts\ncr | Microsoft.ContainerRegistry/registries\ndbw | Microsoft.Databricks/workspaces\ndec | Microsoft.Kusto/clusters\ndisk | Microsoft.Compute/disks\nerc | Microsoft.Network/expressRouteCircuits\nerc | Microsoft.Network/ExpressRoutePorts\nevgd | Microsoft.EventGrid/domains\nevh | Microsoft.EventHub/namespaces\nfdfp | Microsoft.Network/frontdoorWebApplicationFirewallPolicies\ngal | Microsoft.Compute/galleries\nhpc | Specialized.Workload/HPC\niot | Microsoft.Devices/IotHubs\nit | Microsoft.VirtualMachineImages/imageTemplates\nkv | Microsoft.KeyVault/vaults\nlb | Microsoft.Network/loadBalancers\nlog | Microsoft.OperationalInsights/workspaces\nlogic | Microsoft.Logic/workflows\nmaria | Microsoft.DBforMariaDB/servers\nmaria | Microsoft.DBforMariaDB/servers/databases\nmysql | Microsoft.DBforMySQL/servers\nmysql | Microsoft.DBforMySQL/flexibleServers\nnetapp | Microsoft.NetApp/netAppAccounts\nng | Microsoft.Network/natGateways\nnic | Microsoft.Network/networkInterfaces\nnsg | Microsoft.Network/networkSecurityGroups\nnw | Microsoft.Network/networkWatchers\npdnsz | Microsoft.Network/privateDnsZones\npep | Microsoft.Network/privateEndpoints\npip | Microsoft.Network/publicIPAddresses\npsql | Microsoft.DBforPostgreSQL/servers\npsql | Microsoft.DBforPostgreSQL/flexibleServers\nredis | Microsoft.Cache/Redis\nrg | Microsoft.Resources/resourceGroups\nrsv | Microsoft.RecoveryServices/vaults\nrt | Microsoft.Network/routeTables\nsap | Specialized.Workload/SAP\nsb | Microsoft.ServiceBus/namespaces\nsigr | Microsoft.SignalRService/SignalR\nsql | Microsoft.Sql/servers\nsql | Microsoft.Sql/servers/databases\nsql | Microsoft.Sql/servers/elasticPools\nst | Microsoft.Storage/storageAccounts\nsynw | Microsoft.Synapse/workspaces\nsynw | Microsoft.Synapse workspaces/bigDataPools\nsynw | Microsoft.Synapse/workspaces/sqlPools\ntraf | Microsoft.Network/trafficManagerProfiles\nvdpool | Microsoft.DesktopVirtualization/hostPools\nvdpool | Microsoft.DesktopVirtualization/scalingPlans\nvdpool | Microsoft.DesktopVirtualization/workspaces\nvgw | Microsoft.Network/virtualNetworkGateways\nvm | Microsoft.Compute/virtualMachines\nvmss | Microsoft.Compute/virtualMachineScaleSets\nvnet | Microsoft.Network/virtualNetworks\nvnet | Microsoft.Network/virtualNetworks/subnets\nvwan | Microsoft.Network/virtualWans\nwps | Microsoft.SignalRService/webPubSub\n\n## Usage\n\n### Install on Linux or Azure Cloud Shell (Bash)\n\n```bash\nlatest_azqr=$(curl -sL https://api.github.com/repos/Azure/azqr/releases/latest | jq -r \".tag_name\" | cut -c1-)\nwget https://github.com/Azure/azqr/releases/download/$latest_azqr/azqr-ubuntu-latest-amd64 -O azqr\nchmod +x azqr\n```\n\n### Install on Windows\n\nUse `winget`:\n\n```console\nwinget install azqr\n```\n\nor download the executable file:\n\n```\n$latest_azqr=$(iwr https://api.github.com/repos/Azure/azqr/releases/latest).content | convertfrom-json | Select-Object -ExpandProperty tag_name\niwr https://github.com/Azure/azqr/releases/download/$latest_azqr/azqr-windows-latest-amd64.exe -OutFile azqr.exe\n```\n\n### Install on Mac\n\nUse `homebrew`:\n\n```console\nbrew install azqr\n```\n\nor download the latest release from [here](https://github.com/Azure/azqr/releases).\n\n### Authentication\n\n**Azure Quick Review (azqr)** supports the following authentication methods:\n\n* Service Principal. You'll need to set the following environment variables:\n  * AZURE_CLIENT_ID\n  * AZURE_CLIENT_SECRET\n  * AZURE_TENANT_ID\n* Azure Managed Identity\n* Azure CLI (Using this type of authentication will make scans run slower)\n\n### Authorization\n\n**Azure Quick Review (azqr)** requires the following permissions:\n\n* Reader over Subscription or Management Group scope\n\n### Running the Scan\n\nTo scan all resources in all subscription run:\n\n```bash\n./azqr scan\n```\n\nTo scan all resources in a specific management group run:\n\n```bash\n./azqr scan --management-group-id \u003cmanagement_group_id\u003e\n```\n\nTo scan all resources in a specific subscription run:\n\n```bash\n./azqr scan -s \u003csubscription_id\u003e\n```\n\nTo scan a specific resource group in a specific subscription run:\n\n```bash\n./azqr scan -s \u003csubscription_id\u003e -g \u003cresource_group_name\u003e\n```\n\nFor information on available commands and help run:\n\n```bash\n./azqr -h\n```\n\n## Filtering Recommendations and more\n\nYou can configure Azure Quick Review to include or exclude specific subscriptions or resource groups and also exclude services or recommendations. To do so, create a `yaml` file with the following format:\n\n```yaml\nazqr:\n  include:\n    subscriptions:\n      - \u003csubscription_id\u003e # format: \u003csubscription_id\u003e\n    resourceGroups:\n      - \u003cresource_group_resource_id\u003e # format: /subscriptions/\u003csubscription_id\u003e/resourceGroups/\u003cresource_group_name\u003e\n    resourceTypes:\n      - \u003cresource type abbreviation\u003e # format: Abbreviation of the resource type. For example: \"vm\" for \"Microsoft.Compute/virtualMachines\"\n  exclude:\n    subscriptions:\n      - \u003csubscription_id\u003e # format: \u003csubscription_id\u003e\n    resourceGroups:\n      - \u003cresource_group_resource_id\u003e # format: /subscriptions/\u003csubscription_id\u003e/resourceGroups/\u003cresource_group_name\u003e\n    services:\n      - \u003cservice_resource_id\u003e # format: /subscriptions/\u003csubscription_id\u003e/resourceGroups/\u003cresource_group_name\u003e/providers/\u003cservice_provider\u003e/\u003cservice_name\u003e\n    recommendations:\n      - \u003crecommendation_id\u003e # format: \u003crecommendation_id\u003e\n```\n\nThen run the scan with the `--filters` flag:\n\n```bash\n./azqr scan --filters \u003cpath_to_yaml_file\u003e\n```\n\n\u003e Check the [rules](https://azure.github.io/azqr/docs/recommendations/) to get the recommendation ids.\n\n## Troubleshooting\n\nIf you encounter any issue while using **Azure Quick Review (azqr)**, please set the `AZURE_SDK_GO_LOGGING` environment variable to `all`, run the tool with the `--debug` flag and then share the console output with us by filing a new [issue](https://github.com/Azure/azqr/issues).\n\n## Building Locally\nMake sure you have `Go 1.23.x` or higher installed in your environment. You can set `GOROOT=\u003cpath_to_go_libexec\u003e folder` and `GOPATH=\u003cpath_to_go_dep_folder\u003e` if you want to be specific about where to find Go binary and Go dependencies.\n\n```bash\n   git clone git@github.com:Azure/azqr.git\n   cd azqr\n   git submodulie init\n   git submodule update --recursive\n   go build -o azqr cmd/main.go\n ```\n\n## Support\n\nThis project uses GitHub Issues to track bugs and feature requests.\nBefore logging an issue please check our [troubleshooting](#troubleshooting) guide.\n\nPlease search the existing issues before filing new issues to avoid duplicates.\n\n- For new issues, file your bug or feature request as a new [issue](https://github.com/Azure/azqr/issues).\n- For help, discussion, and support questions about using this project, join or start a [discussion](https://github.com/Azure/azqr/discussions).\n\nSupport for this project / product is limited to the resources listed above.\n\n## Contributors\n\nThanks to everyone who has contributed!\n\n\u003ca href=\"https://github.com/Azure/azqr/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=Azure/azqr\" /\u003e\n\u003c/a\u003e\n\n## Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](CODE_OF_CONDUCT.md)\n\n## Trademark Notice\n\n\u003e **Trademarks** This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft’s Trademark \u0026 Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzure%2Fazqr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAzure%2Fazqr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzure%2Fazqr/lists"}