bARGE - basic Azure Resource Graph Explorer
bARGE is a VS Code extension that brings Azure Resource Graph querying capabilities directly into your development environment, similar to the Azure Portal's Resource Graph Explorer.
Features
- Flexible Data Grid: Excel-like table with column resizing, reordering, and sticky headers
- Exploring Results: Click, drag, and keyboard navigation with multi-cell selection support
- Copying Options: Right-click to copy cells, selections, or formatted JSON
- Querying: Run queries directly from
.kql files in your workspace, or from selected text
- Scope Management: Query across your tenant or specific subscriptions
- Authentication: Seamless integration with VS Code's Azure authentication
Getting Started
Prerequisites
- VS Code 1.103.0 or higher
- Access to Azure subscriptions
- One of the following for authentication:
- Azure CLI installed and logged in (
az login)
- Or browser-based authentication (fallback)
Installation
- Install the extension from the VS Code marketplace
- Or build from source for development
Usage
Authenticate with Azure
- Run
az login in your terminal, or
- Use VS Code's built-in Azure authentication
Run queries:
- From a .kql file: Open the file and right click to run
bARGE: Run Query from Current File
- From selected text: Select KQL text and right click to run
bARGE: Run Selected Query text
- Open the panel: Run
bARGE: Open bARGE Results Panel to view previous results
Set your scope (optional):
- Run
bARGE: Set Query Scope to choose subscription or tenant querying scope
Interact with results:
- Resize and reorder columns by dragging
- Select cells and copy data to Excel or other tools
- Click JSON objects to view formatted content
- Export results to CSV using the export button in the results panel
Example Queries
Here are some useful queries to get you started:
List all Virtual Machines
Resources
| where type == 'microsoft.compute/virtualmachines'
| project name, location, resourceGroup, properties.hardwareProfile.vmSize
| limit 100
Find resources by tag
Resources
| where tags.Environment == 'Production'
| project name, type, location, resourceGroup
| limit 50
Storage accounts by region
Resources
| where type == 'microsoft.storage/storageaccounts'
| summarize count() by location
| order by count_ desc
Resources created in the last 30 days
Resources
| where todatetime(properties.timeCreated) > ago(30d)
| project name, type, resourceGroup, properties.timeCreated
| order by todatetime(properties.timeCreated) desc
Configuration
The extension supports the following configuration options in VS Code settings:
barge.defaultSubscription: Default Azure subscription ID to use for queriesbarge.autoAuthenticate: Automatically authenticate with Azure on extension activation (default: true)
Commands
barge.openResults: Open bARGE Results Panelbarge.runQueryFromFile: Run Query from Current File (works with .kql files)barge.runQueryFromSelection: Run Selected Query textbarge.setScope: Set Query Scope (subscription, management group, or tenant)
Development
Building from Source
git clone https://github.com/PalmEmanuel/bARGE.git
cd bARGE
npm install
npm run watch
Then press F5 in VS Code to launch the Extension Development Host.
Project Structure
src/extension.ts - Main extension entry pointsrc/bargePanel.ts - Webview panel implementationsrc/azureService.ts - Azure Resource Graph API integrationsrc/types.ts - TypeScript type definitions
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License.
Troubleshooting
Authentication Issues
If you encounter authentication problems:
- Make sure you're logged into Azure CLI:
az login
- Verify you have access to the subscription you're trying to query
- Try refreshing your browser authentication
Query Errors
- Ensure your KQL syntax is correct
- Verify you have permissions to query the resources
- Check that the subscription is selected
- Use
limit clauses for large result sets
- Consider filtering early in your queries to improve performance
Resources
