Microsoft Azure

Documentation Index

Fetch the complete documentation index at: https://narev.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• Active Microsoft Azure subscription with billing data access
• Azure Storage account configured for billing exports
• Billing export configured and running
• Storage account access key or appropriate permissions

​

Setting up Azure billing export

​

1. Create storage account

1. Sign in to the Azure Portal
2. Navigate to Storage accounts
3. Click Create to create a new storage account

4. Configure the storage account:
   • Subscription: Select your billing subscription
   • Resource group: Create new or select existing
   • Storage username: Choose a unique name (for example, mybillingstorage)
   • Region: Select appropriate region
   • Performance: Standard (sufficient for billing data)
   • Replication: LRS (Locally redundant storage) or as needed
5. Click Review + create and then Create

​

2. Create container for exports

1. Navigate to your newly created storage account
2. Go to Data storage > Containers
3. Click + Container
4. Configure the container:
   • Name: billing-exports (or your preferred name)
   • Public access level: Private (recommended for security)
5. Click Create

​

3. Set up cost management export

1. Navigate to Cost Management + Billing
2. Select your billing scope (subscription, resource group, etc.)
3. Go to Settings > Exports
4. Click Create to create a new export

​

Step 1: Basics

5. Select Export Template: Choose Cost and usage (FOCUS) template
   • This exports data in FOCUS 1.0 format, which NarevAI maps to FOCUS 1.2
   • Avoid other templates as they may not be fully supported

​

Step 2: Datasets

7. Specify export prefix (required to ensure unique export names)
   • Enter a prefix for all exports (for example, billing, focus, narev)
   • This ensures that exports have unique names

​

Step 3: Destination

8. Configure storage destination:
   • Storage type: Azure blob storage
   • Destination: Use existing (select your storage account)
   • Subscription: Select your subscription
   • Storage account: Select the storage account you created
   • Container: Enter the container name you created
   • Directory: Optional subdirectory (for example, exports/daily)
   • Format: Parquet (recommended) or CSV
   • Compression: Snappy (for Parquet) or GZIP (for CSV)
   • Overwrite data: ✅ Checked (recommended to save storage costs)

​

Step 4: Review + create

9. Review your configuration and click Create

​

4. Note your configuration

• Storage username: The name of your storage account
• Container name: The container where exports are stored
• Export path: Any subdirectory path (if configured)

​

Storage account access setup

​

Getting storage account key

1. Go to your storage account (Storage Center -> Sidebar: Object Storage -> Sidebar: Blob Storage)
2. Open your storage account from the table
3. Navigate to Sidebar: Security + networking > Access keys
4. Under key1 or key2, click Show next to the key
5. Copy the entire key value (long alphanumeric string)
6. Store it securely because NarevAI uses it for authentication

​

Adding Azure Provider in NarevAI

​

Step 1: Navigate to Connect

1. In the NarevAI sidebar, under Data Connections, click Connect
2. You’ll see the “Provider Integrations” page with available providers

​

Step 2: Select Azure Provider

1. Find the Microsoft Azure card in the provider grid
2. Click the Connect button on the Azure card
3. The Azure configuration dialog opens

​

Step 3: Configure Azure Provider

​

Narev configuration

• Unique identifier (for example, azure-prod, company-azure)
• Format: lowercase letters, numbers, hyphens, underscores only

• Human-readable name (for example, Azure Production, Company Azure)
• Shown in the interface

​

App configuration - Azure credentials ✅ Required

• Your Azure Storage account access key (long alphanumeric string)
• Password field with show/hide toggle
• Found in Azure Portal > Storage Account > Access Keys

​

Provider-specific configuration

• Storage username with exports (for example, mybillingstorage)
• Must match the storage account you configured in Azure

• Container with billing exports (for example, billing-exports)
• Must match the container you created in Azure

• Path prefix for export files (for example, exports/daily)
• Leave empty if exports are in root of container

​

Step 4: Connect Provider

1. Review all configuration settings
2. Click the Connect button
3. NarevAI tests the connection to your Azure Storage
4. If successful, NarevAI adds the provider and marks it as “Connected”
5. You can now sync billing data from this Azure account

• Storage account access verification
• Container access check
• Export files detection
• Permissions verification

​

Configuration examples

​

Basic setup

Provider Name: azure-main
Display Name: Main Azure Account
Storage Account Key: [your-storage-account-key]
Storage Account: mybillingstorage
Container Name: billing-exports

​

With Custom Export Path

Provider Name: azure-organized
Display Name: Azure Production Environment
Storage Account Key: [your-storage-account-key]
Storage Account: companyazurestorage
Container Name: cost-exports
Export Path: daily/detailed

​

Multi-Environment Setup

Provider Name: azure-dev
Display Name: Azure Development
Storage Account Key: [your-storage-account-key]
Storage Account: devbillingstorage
Container Name: dev-exports
Export Path: development/costs

​

Common Test Results

​

Success Response

Successfully connected to Azure Storage
Storage Account: mybillingstorage
Container: billing-exports
Export Path: exports/daily
Files Found: 28
Auth Method: api_key

​

Container Not Found

Container 'billing-exports' not found

• Solution: Verify the container name spelling and ensure it exists in the storage account

​

Access Denied

Azure Error: AuthenticationFailed

• Solution: Verify your storage account key is correct and not expired

​

Storage Account Not Found

Azure Error: ResourceNotFound

• Solution: Check the storage account name and ensure it exists in your subscription

​

Supported Features

• ✅ Billing export data from Azure Cost Management
• ✅ Cost analysis and breakdown by service
• ✅ Resource tags for cost attribution
• ✅ Budget alerts integration
• ✅ FOCUS format compatibility
• ✅ Multiple export schedules (daily, monthly)

​

Troubleshooting

​

Authentication Issues

• Verify the storage account key is copied completely without extra spaces
• Check that the storage account key hasn’t been rotated or expired
• Ensure you’re using the correct storage account name

​

Storage Access Problems

• Confirm the container exists and is spelled correctly
• Verify the export path matches your Cost Management export configuration
• Check that the storage account is in the same subscription as your billing scope

​

Export Configuration Issues

• Ensure your Cost Management export is actively generating files
• Verify the export is configured to use the correct storage account and container
• Check that the export has run at least once (may take 24 hours after creation)

​

Permission Errors

• Confirm you have access to the storage account keys
• Verify your Azure account has permissions to read from the storage account
• Check that the storage account is accessible from your location

​

No Data Found

• Verify that billing exports are being generated (check Azure Cost Management > Exports)
• Ensure the export path in NarevAI matches the directory configured in your export
• Check if your billing period has completed for data to be available

​

Export File Formats

• Parquet format (recommended): Column-oriented format with efficient compression, better for large datasets and analytics
• CSV format: Traditional comma-separated values, universally readable
• Compression options: Snappy compression for Parquet, Gzip for CSV
• File partitioning: Large files are automatically split into manageable chunks
• Daily exports: Updated daily with month-to-date data
• File naming: Includes date stamps and billing periods

​

Data Collection

• Usage metrics: Service consumption, resource hours, API calls
• Cost data: Pay-as-you-go costs, reservation savings, spot pricing
• Resource information: Virtual machines, storage usage, network traffic
• Billing hierarchy: Subscription, resource group, and resource-level costs
• Tags and metadata: Custom tags for cost allocation and analysis
• Time-series data: Daily cost and usage patterns