Azure Tag Compliance Workbook
Track resource tagging compliance effortlessly with this plug-and-play Azure Monitor workbook—built to slice through cost chaos like a chef’s knife through butter.
Overview
📊 Azure Tag Compliance Dashboard (by CloudCostChefs) is ready-made Azure Monitor workbook that gives you real-time insights into your tagging hygiene. Instantly spot untagged or mis-tagged resources groups, track compliance trends across subscriptions, and serve up accountability—no YAML prep required.
🍽️ Tag Your Tech Like a Pro. This workbook zeroes in on four essential tags—the core ingredients of any cost-optimized cloud recipe:
- Environment 🏗️ – Know if it’s cooking in Prod, Dev, or Test
- Owner 👨🍳 – Who’s the chef accountable for this resource?
- CostCenter 💸 – Follow the money, tie it to your budget
- Project 🗂️ – Every resource needs a reason; this is it
Real-Time Compliance Monitoring
No stale data here—your dashboard updates fresh every time you open it, straight from Azure’s live pantry.
Actionable Insights
Pinpoint the resource groups that are slacking and the tags they’re missing—so you can fix the flavor fast.
🛠️ Fully Customizable Recipe. This workbook comes prepped for the four FinOps-essential tags—but feel free to season it to your taste. Swap in your org’s preferred tags with just a tweak to the queries.
Key Features
Overall Compliance Score
Get the bird’s-eye view of your tagging hygiene. Visual cues (✅ Excellent to 🔴 Critical) instantly show how your Azure subscriptions stack up in the compliance kitchen.
Missing Tags Summary
A bar chart spotlighting the most frequently missing tags across your resource groups — perfect for prioritizing your cleanup like a true cloud cost chef.
Non-Compliant Resources
Get a detailed breakdown of every non-compliant resource group, including exactly which tags are missing — no more guesswork, just actionable fixes.
Resource Group Compliance
View compliance rates per resource group in a color-coded table, making it easy to spot which areas need immediate attention — red flags and green lights included.
Dashboard Sections
The workbook includes the following sections:
- Overall Tag Compliance - Summary tiles showing compliance percentages and status
- Missing Tags Summary - Bar chart showing which tags are most commonly missing
- Non-Compliant Resources by Type - Pie chart showing which resource types have compliance issues
- Resource Group Compliance Grid - Detailed view of each resource group's compliance status
- Non-Compliant Resource Groups - Actionable list of resource groups that need tagging
- Compliance by Resource Group - Bottom 20 resource groups by compliance rate
Installation
🛠️ Installing the Tag Compliance Workbook: Fast & Frictionless
Import from JSON
- Sign in to the Azure Portal
- Navigate to Azure Monitor in the left navigation
- Select Workbooks from the left menu
- Click + New to create a new workbook
- Click the Edit button in the toolbar
- Click the Advanced Editor button (looks like </>)
- Replace all content with the JSON from our workbook
- Click Apply
- Click Save, give your workbook a name (e.g., "Tag Compliance Dashboard"), select a subscription and resource group to save it in, and click Apply
After saving the workbook, you can share it with your team by clicking the "Share" button in the workbook toolbar. This allows you to grant specific users or groups access to view the workbook.
Using the Workbook
Once installed, using the Tag Compliance Workbook is straightforward:
Accessing the Workbook
- Navigate to Azure Monitor in the Azure Portal
- Select Workbooks from the left menu
- Find your saved "Tag Compliance Dashboard" in the list and click on it
- The workbook will load and begin querying your Azure environment
Selecting Subscriptions
At the top of the workbook, you'll find a subscription selector that allows you to choose which subscriptions to include in the analysis:
- By default, all subscriptions are selected
- You can select specific subscriptions to focus your analysis
- After changing the selection, the workbook will automatically refresh with the new data
Interpreting the Results
The workbook provides several visualizations to help you understand your tagging compliance:
- Overall Compliance Score - This percentage shows how many of your resource groups have all four required tags
- Status Indicator - A visual indicator (✅ Excellent, 🟡 Good, 🟠 Needs Improvement, 🔴 Critical) based on your compliance score
- Missing Tags Chart - Shows which tags are most commonly missing
- Non-Compliant Resources - Lists resource groups that are missing one or more tags
- Bottom 20 Table - Shows the resource groups with the lowest compliance rates
The workbook queries your Azure environment in real-time when you open it. To see updated data after making changes to your resource tags, simply refresh the workbook by clicking the "Refresh" button in the toolbar.
Taking Action
The Tag Compliance Workbook is designed to help you identify and fix tagging issues:
Fixing Missing Tags
The "Non-Compliant Resource Groups - Action Required" section provides a detailed list of resource groups that are missing tags, along with which specific tags are missing. You can use this information to:
- Prioritize which resource groups to fix first
- Export the list to Excel for tracking or assigning to team members
- Click directly on a resource group name to navigate to it in the Azure Portal
- Add the missing tags through the Azure Portal UI or using automation
Automation Options
For larger environments, consider automating the tagging process:
- Use our automated tagging tools to apply tags at scale
- Set up Azure Policy to enforce tagging on new resources
- Schedule regular reviews of the Tag Compliance Workbook to track progress
Set a target compliance score for your organization and track your progress over time. Many organizations aim for at least 90% compliance as a best practice benchmark.
Customizing the Workbook
You can customize the Tag Compliance Workbook to better fit your organization's needs:
Modifying Tracked Tags
If your organization uses different tag names or wants to track additional tags:
- Open the workbook in edit mode by clicking the "Edit" button
- For each query, click the "Edit" button (pencil icon)
- Modify the KQL queries to reference your organization's tag names
- Update the compliance score calculation to include your tags
- Click "Done Editing" and save your changes
Example Query Modification
To change the tracked tags from Environment, Owner, CostCenter, and Project to a different set:
// Original query
resourcecontainers
| where type == "microsoft.resources/subscriptions/resourcegroups"
| extend hasEnvironment = isnotnull(tags['Environment'])
| extend hasOwner = isnotnull(tags['Owner'])
| extend hasCostCenter = isnotnull(tags['CostCenter'])
| extend hasProject = isnotnull(tags['Project'])
| extend complianceScore = toint(hasEnvironment) + toint(hasOwner) + toint(hasCostCenter) + toint(hasProject)
// Modified query for different tags
resourcecontainers
| where type == "microsoft.resources/subscriptions/resourcegroups"
| extend hasDepartment = isnotnull(tags['Department'])
| extend hasApplication = isnotnull(tags['Application'])
| extend hasBusinessUnit = isnotnull(tags['BusinessUnit'])
| extend hasCreatedBy = isnotnull(tags['CreatedBy'])
| extend complianceScore = toint(hasDepartment) + toint(hasApplication) + toint(hasBusinessUnit) + toint(hasCreatedBy)
Adding New Visualizations
You can also add new visualizations to the workbook:
- Click the "Edit" button to enter edit mode
- Click the "Add" button at the bottom of the workbook
- Select the type of visualization you want to add (Query, Text, etc.)
- Configure your new visualization
- Click "Done Editing" and save your changes
Before making significant changes to the workbook, consider saving a copy as a backup. This allows you to experiment with modifications while preserving the original functionality.
Troubleshooting
Common Issues
No Data Appears
- Verify you have selected at least one subscription in the subscription selector
- Check that you have permissions to view resources in the selected subscriptions
- Try refreshing the workbook by clicking the "Refresh" button
Query Errors
- If you've modified the queries and encounter errors, check your KQL syntax
- Verify that any custom tag names you've added are correctly referenced in the queries
- Consider reverting to the original queries and making changes incrementally
Performance Issues
- If the workbook is slow to load, try selecting fewer subscriptions
- For very large environments, consider creating separate workbooks for different subscription groups
- Optimize queries by adding more specific filters if you're only interested in certain resource types
The workbook uses Azure Resource Graph queries, which have certain limitations on query complexity and result size. If you have a very large Azure environment, you might need to adjust the queries to work within these limitations.
Next Steps
After implementing the Tag Compliance Workbook, consider these next steps to further enhance your tagging strategy:
Implement Tag Policies
Use Azure Policy to enforce tagging rules on new resources:
- Require specific tags on all resources
- Inherit tags from resource groups
- Audit and remediate non-compliant resources
Automate Tagging
Implement automated tagging solutions:
- Use event-driven functions to tag new resources
- Schedule bulk tagging scripts for existing resources
- Integrate tagging into your CI/CD pipelines
Was this documentation helpful?
Have suggestions for improving this documentation? Contact us.