Connect to Azure Blob Storage¶
View traces stored in Azure Blob Storage containers directly in the extension.
Prerequisites¶
- An Azure Storage Account with one or more containers holding Monocle trace files
- A connection string for the storage account (found in Azure Portal > Storage Account > Access Keys)
- Trace files following the Monocle naming convention:
monocle_trace_{name}_{id}_{date}.json
Setup Steps¶
Step 1: Select Provider¶
Click the Add Cloud button in the TRACES toolbar and select Microsoft Azure Blob.
Step 2: Enter Connection String¶
Enter your Azure Blob Storage connection string. The connection string must contain both AccountName= and AccountKey= fields.
Format example:
DefaultEndpointsProtocol=https;AccountName=mystorageaccount;AccountKey=abc123...==;EndpointSuffix=core.windows.net
Where to find it: 1. Go to Azure Portal 2. Navigate to your Storage Account 3. Click Access Keys in the left menu 4. Copy the Connection string for either key1 or key2
If the connection string format is invalid, the input box shows an error and lets you retry.
Step 3: Validation¶
The extension validates the connection by listing containers (listContainers with maxPageSize: 1). If validation fails:
| Error | Cause | Fix |
|---|---|---|
AuthenticationFailed (403) |
Invalid account key | Re-enter with correct connection string |
ResourceNotFound (404) |
Storage account doesn't exist | Check the account name |
ENOTFOUND / ETIMEDOUT |
Network issue | Check connectivity and VPN settings |
Step 4: Select Containers¶
A multi-select picker shows all containers in the storage account. Select one or more containers that contain your trace files.
If you're editing an existing connection, previously selected containers are pre-selected.
Step 5: Set Criteria (Time Range)¶
Choose which traces to fetch:
- Most recent: 10, 20, or 30 traces
- Last 12 hours, 24 hours, 2 days, 7 days, 15 days, or 1 month
Note: Trace ID lookup and trace-specific filters (agentic, with/without error) are not available for Azure Blob -- these are Okahu Cloud-only features.
Step 6: Done¶
Your Azure storage account appears in the TRACES sidebar with selected containers underneath. Expand a container to see trace files. Click any trace to open the visualization.