azure-radar

A CLI tool to inventory, diagram, and run operations on Azure services using Azure CLI, mirroring gcp-radar for GCP.

Requirements

• Azure CLI: Install from https://docs.microsoft.com/cli/azure/install-azure-cli
• Python 3.8+

Installation

pip install -e .

Authentication

This tool uses Azure CLI for authentication, supporting various methods including SSO.

For SSO-enabled accounts:

1. Install Azure CLI (if not already installed):

   brew install azure-cli  # macOS
   # or use appropriate installer for your OS
   

2. Authenticate with SSO:

   az login --use-device-code
   # or if browser available
   az login
   

3. Set subscription (if you have multiple):

   az account set --subscription <subscription-id>
   # or export it
   export AZURE_SUBSCRIPTION_ID=<your-subscription-id>
   

Usage

# Generate CSV inventory of all Azure resources
azure-radar inventory

# Generate draw.io diagram of services
azure-radar diagram

# Run both inventory and diagram
azure-radar run

# Pull the last 30 days of cost data to CSV
azure-radar billing

# ...or fold billing into the full run
azure-radar run --billing

Billing

azure-radar billing queries the Azure Cost Management API (via az rest) and writes daily cost rows broken down by service and resource.

# Last 30 days (default)
azure-radar billing

# Last 60 or 90 days
azure-radar billing --days 60
azure-radar billing --days 90

# Custom output file
azure-radar billing --days 90 --output q3-spend.csv

# Amortized instead of actual cost (spreads reservation/savings-plan purchases)
azure-radar billing --cost-type AmortizedCost

# Narrow to specific services and/or resource groups (both repeatable)
azure-radar billing --service "Virtual Machines" --service "Storage" --resource-group rg-prod

# Same options are available on the full run
azure-radar run --billing --days 90 --billing-output spend.csv

The CSV contains one row per day / service / resource:

Because ServiceType is normalized the same way as the inventory output, the two CSVs can be joined on ServiceType (or on resource name/group) for cost-per-service reporting.

Permissions: reading cost data requires the Cost Management Reader role (or higher) on the subscription, which is separate from the reader role used by inventory.

Output Files

• azure_inventory.csv - CSV file with all Azure resources
• azure_diagram.drawio - Draw.io diagram of service distribution
• azure_billing.csv - CSV file with daily costs per service and resource (with billing / --billing)

Supported Azure Services

This tool currently supports the following Azure service categories for inventory and diagram generation:

• Virtual Machines
• Azure SQL
• Azure Functions
• AKS
• Storage Accounts
• Container Apps
• Cosmos DB
• Service Bus
• Azure ML

Cloud Service Mapping (Azure → AWS → GCP → OCI)

Related PyPI packages

This project is part of a family of "radars" tools available on PyPI. Two related packages you may find useful:

• aws-radar — available on PyPI (example versions: 0.1.1, 0.1.0)
• gcp-radar — available on PyPI (example versions: 0.1.9, 0.1.3, 0.1.1, 0.1.0)

Install them with pip:

pip install aws-radar
pip install gcp-radar

These packages follow a similar CLI shape (inventory, diagram, run) for their respective clouds.