From dynatrace
Queries and analyzes Azure cloud resources (VMs, SQL, Storage, AKS, App Service, Functions, VNet, Event Hubs, Container Apps, Key Vault) via Dynatrace Smartscape. Monitors infrastructure, audits security, manages subscriptions and resource groups.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dynatrace:dt-obs-azureThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Monitor and analyze Azure resources using Dynatrace Smartscape and DQL. Query Azure services, audit security, manage organizational hierarchy, and plan capacity across your Azure infrastructure.
references/README.mdreferences/capacity-planning.mdreferences/cost-optimization.mdreferences/database-monitoring.mdreferences/load-balancing-api.mdreferences/messaging-integration.mdreferences/metrics-performance.mdreferences/resource-management.mdreferences/resource-ownership.mdreferences/security-compliance.mdreferences/serverless-containers.mdreferences/storage-monitoring.mdreferences/vnet-networking-security.mdreferences/workload-detection.mdMonitor and analyze Azure resources using Dynatrace Smartscape and DQL. Query Azure services, audit security, manage organizational hierarchy, and plan capacity across your Azure infrastructure.
Use this skill when the user needs to work with Azure resources in Dynatrace. Load the reference file for the task type:
| Task | File to load |
|---|---|
| Inventory and topology queries | (no additional file — use core patterns below) |
| Query Azure metric timeseries (CPU, latency, throughput) | Load references/metrics-performance.md |
| VNet topology, subnets, NSGs, public IPs, VPN, peering | Load references/vnet-networking-security.md |
| Azure SQL, Cosmos DB, PostgreSQL, Redis investigation | Load references/database-monitoring.md |
| Functions, App Service, AKS infrastructure, Container Apps | Load references/serverless-containers.md |
| Azure LB, Application Gateway, Front Door, API Management | Load references/load-balancing-api.md |
| WAF rule analysis, false-positive investigation | Load references/load-balancing-api.md |
| Event Hubs, Service Bus, Event Grid | Load references/messaging-integration.md |
| Storage Accounts, Blob, File, Queue, Table | Load references/storage-monitoring.md |
| Unattached resources, tag compliance, lifecycle | Load references/resource-management.md |
| Cost savings, unused resources, SKU analysis | Load references/cost-optimization.md |
| Capacity headroom, VMSS scaling, quotas | Load references/capacity-planning.md |
| Security audit, encryption, public access, Key Vault | Load references/security-compliance.md |
| NSG rule analysis (0.0.0.0/0, open ports) | Load references/security-compliance.md |
| Storage account encryption/public access audit | Load references/security-compliance.md |
| Cost allocation, chargeback, ownership | Load references/resource-ownership.md |
| Determine orchestration context (AKS, VMSS, standalone) | Load references/workload-detection.md |
Azure resources use the AZURE_* prefix and can be queried using the smartscapeNodes function. All Azure entities are automatically discovered and modeled in Dynatrace Smartscape. Entity type names are derived from the ARM resource provider path: /Microsoft.Compute/virtualMachines becomes AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES. Sub-resources append with underscores: /Microsoft.Sql/servers/databases becomes AZURE_MICROSOFT_SQL_SERVERS_DATABASES.
Compute: AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES, AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS, AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS_VIRTUALMACHINES, AZURE_MICROSOFT_COMPUTE_DISKS, AZURE_MICROSOFT_COMPUTE_SSHPUBLICKEYS, AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES_EXTENSIONS
Networking: AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKS, AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKS_SUBNETS, AZURE_MICROSOFT_NETWORK_NETWORKSECURITYGROUPS, AZURE_MICROSOFT_NETWORK_PUBLICIPADDRESSES, AZURE_MICROSOFT_NETWORK_NETWORKINTERFACES, AZURE_MICROSOFT_NETWORK_LOADBALANCERS, AZURE_MICROSOFT_NETWORK_APPLICATIONGATEWAYS, AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKGATEWAYS, AZURE_MICROSOFT_NETWORK_CONNECTIONS, AZURE_MICROSOFT_NETWORK_EXPRESSROUTECIRCUITS
Database: AZURE_MICROSOFT_SQL_SERVERS, AZURE_MICROSOFT_SQL_SERVERS_DATABASES, AZURE_MICROSOFT_CACHE_REDIS, AZURE_MICROSOFT_CACHE_REDISENTERPRISE, AZURE_MICROSOFT_DOCUMENTDB_DATABASEACCOUNTS
Storage: AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS, AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_BLOBSERVICES_CONTAINERS, AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_FILESERVICES_SHARES, AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_QUEUESERVICES_QUEUES, AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_TABLESERVICES_TABLES
Kubernetes/Containers: AZURE_MICROSOFT_CONTAINERSERVICE_MANAGEDCLUSTERS, AZURE_MICROSOFT_CONTAINERSERVICE_MANAGEDCLUSTERS_AGENTPOOLS, AZURE_MICROSOFT_CONTAINERREGISTRY_REGISTRIES, AZURE_MICROSOFT_APP_CONTAINERAPPS, AZURE_MICROSOFT_APP_MANAGEDENVIRONMENTS, AZURE_MICROSOFT_APP_JOBS
App Service: AZURE_MICROSOFT_WEB_SITES, AZURE_MICROSOFT_WEB_SERVERFARMS, AZURE_MICROSOFT_WEB_SITES_FUNCTIONS
Messaging: AZURE_MICROSOFT_EVENTHUB_NAMESPACES, AZURE_MICROSOFT_EVENTHUB_NAMESPACES_EVENTHUBS, AZURE_MICROSOFT_SERVICEBUS_NAMESPACES, AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_QUEUES, AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_TOPICS, AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_TOPICS_SUBSCRIPTIONS
Security/Identity: AZURE_MICROSOFT_KEYVAULT_VAULTS, AZURE_MICROSOFT_MANAGEDIDENTITY_USERASSIGNEDIDENTITIES
Monitoring: AZURE_MICROSOFT_OPERATIONALINSIGHTS_WORKSPACES, AZURE_MICROSOFT_INSIGHTS_COMPONENTS
API Management: AZURE_MICROSOFT_APIMANAGEMENT_SERVICE
Azure organizes resources in a three-level hierarchy: Tenant > Subscription > Resource Group. Every resource belongs to exactly one resource group within one subscription. Use these fields to scope queries:
filter azure.subscription == "08b9810e-..."
filter azure.resource.group == "my-rg"
filter azure.location == "eastus"
Combine these filters for precise scoping:
smartscapeNodes "AZURE_*"
| filter azure.subscription == "<SUBSCRIPTION_ID>"
and azure.resource.group == "<RESOURCE_GROUP>"
and azure.location == "<REGION>"
| summarize count = count(), by: {type}
| sort count desc
To see the organizational breakdown across your environment:
smartscapeNodes "AZURE_*"
| summarize resource_count = count(), by: {azure.subscription, azure.resource.group}
| sort resource_count desc
All Azure entities include:
azure.subscription — Azure subscription GUIDazure.resource.group — Resource group nameazure.location — Azure region (e.g., eastus, polandcentral)azure.resourceType — ARM resource type (e.g., microsoft.compute/virtualmachines)azure.provisioning_state — Provisioning state (e.g., Succeeded)azure.object — Full ARM resource JSON (see Configuration Parsing)cloud.provider — Always azuretags — Resource tags (use tags[`key`])Some entity types also have:
azure.resourceId — Full ARM resource ID (VMs and some others)azure.resourceName — Resource name (VMs and some others)azure.availabilityZones — Availability zone list (VMs)Azure entity relationships can be traversed using traverse. The dt.traverse.relationship field is not populated for Azure entities, so you must use "*" as the relationship name in all traversal commands.
Key traversal pairs:
traverse "*", "AZURE_MICROSOFT_COMPUTE_DISKS"traverse "*", "AZURE_MICROSOFT_NETWORK_NETWORKINTERFACES"traverse "*", "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS"traverse "*", "AZURE_MICROSOFT_RESOURCES_LOCATIONS_AVAILABILITYZONES"traverse "*", "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES_EXTENSIONS", direction:backwardtraverse "*", "AZURE_MICROSOFT_CONTAINERSERVICE_MANAGEDCLUSTERS"traverse "*", "AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKS_SUBNETS"traverse "*", "AZURE_MICROSOFT_NETWORK_NETWORKSECURITYGROUPS"traverse "*", "AZURE_MICROSOFT_NETWORK_LOADBALANCERS_BACKENDADDRESSPOOLS"traverse "*", "AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKS"traverse "*", "AZURE_MICROSOFT_NETWORK_NETWORKSECURITYGROUPS"traverse "*", "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_NETWORKINTERFACES", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_VIRTUALNETWORKS_SUBNETS", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_LOADBALANCERS_BACKENDADDRESSPOOLS"traverse "*", "AZURE_MICROSOFT_NETWORK_LOADBALANCERS_FRONTENDIPCONFIGURATIONS"traverse "*", "AZURE_MICROSOFT_NETWORK_LOADBALANCERS_LOADBALANCINGRULES"traverse "*", "AZURE_MICROSOFT_SQL_SERVERS_DATABASES", direction:backwardtraverse "*", "AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_BLOBSERVICES_CONTAINERS", direction:backwardtraverse "*", "AZURE_MICROSOFT_STORAGE_STORAGEACCOUNTS_FILESERVICES_SHARES", direction:backwardtraverse "*", "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS", direction:backwardtraverse "*", "AZURE_MICROSOFT_CONTAINERSERVICE_MANAGEDCLUSTERS_AGENTPOOLS", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_NETWORKSECURITYGROUPS", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_PUBLICIPADDRESSES", direction:backwardtraverse "*", "AZURE_MICROSOFT_NETWORK_PUBLICIPADDRESSES"traverse "*", "AZURE_MICROSOFT_WEB_SERVERFARMS"traverse "*", "AZURE_MICROSOFT_WEB_SITES_FUNCTIONS", direction:backwardtraverse "*", "AZURE_MICROSOFT_APP_MANAGEDENVIRONMENTS"traverse "*", "AZURE_MICROSOFT_EVENTHUB_NAMESPACES_EVENTHUBS", direction:backwardtraverse "*", "AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_QUEUES", direction:backwardtraverse "*", "AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_TOPICS", direction:backwardtraverse "*", "AZURE_MICROSOFT_SERVICEBUS_NAMESPACES_TOPICS_SUBSCRIPTIONS", direction:backwardfieldsKeep:{field1, field2} to carry fields through multi-hop traversalsdt.traverse.history[0][id] to get the source entity ID, then lookup to resolve the source entity name:
| fieldsAdd sourceId = dt.traverse.history[0][id]
| lookup [smartscapeNodes "SOURCE_TYPE" | fields name, id], sourceField: sourceId, lookupField: id, prefix: "src."
dt.traverse.history[-N] works for fields carried via fieldsKeepDynatrace ingests Azure Monitor metrics and exposes them using this naming pattern:
cloud.azure.<provider_namespace>.<resource_type>.<MetricName>
The <provider_namespace> uses underscores within the namespace (e.g., microsoft_compute) and <resource_type> is lowercase (e.g., virtualmachines). Hierarchy levels are dot-separated: microsoft_sql.servers.databases. <MetricName> is the Azure Monitor metric name.
Examples:
| Azure Monitor metric | Dynatrace metric key |
|---|---|
VM Percentage CPU | cloud.azure.microsoft_compute.virtualmachines.PercentageCPU |
SQL DB cpu_percent | cloud.azure.microsoft_sql.servers.databases.cpu_percent |
Storage Ingress | cloud.azure.microsoft_storage.storageaccounts.Ingress |
Event Hub IncomingMessages | cloud.azure.microsoft_eventhub.namespaces.IncomingMessages |
Service Bus IncomingMessages | cloud.azure.microsoft_servicebus.namespaces.IncomingMessages |
App Service HttpResponseTime | cloud.azure.microsoft_web.sites.HttpResponseTime |
Load Balancer ByteCount | cloud.azure.microsoft_network.loadbalancers.ByteCount |
AKS node_cpu_usage_percentage | cloud.azure.microsoft_containerservice.managedclusters.node_cpu_usage_percentage |
Cosmos DB TotalRequestUnits | cloud.azure.microsoft_documentdb.databaseaccounts.TotalRequestUnits |
Redis serverLoad | cloud.azure.microsoft_cache.redis.serverLoad |
App Gateway TotalRequests | cloud.azure.microsoft_network.applicationgateways.TotalRequests |
To query a metric:
timeseries cpu = avg(cloud.azure.microsoft_compute.virtualmachines.PercentageCPU),
by: {dt.smartscape_source.id},
from: now()-1h
| limit 10
Important: Never refer to these as "Azure Monitor alerts" or "Azure Monitor metrics" in output. Dynatrace monitors Azure resources natively through its Azure integration — these are Dynatrace metrics ingested from Azure.
The azure.object field contains the full ARM resource JSON. Parse it with the azjson alias:
parse azure.object, "JSON:azjson"
The JSON is wrapped in a configuration key:
{
"configuration": {
"id": "<ARM resource ID>",
"name": "<resource name>",
"type": "<ARM resource type>",
"location": "<region>",
"sku": { ... },
"properties": { ... },
"zones": [...]
},
"tags": { ... }
}
Access patterns:
azjson[configuration][properties][field]azjson[configuration][sku][name]azjson[configuration][kind]azjson[configuration][zones]Common configuration fields by service:
properties.hardwareProfile.vmSize, properties.storageProfile.imageReference.offer, properties.storageProfile.osDisk.osType, properties.extended.instanceView.powerState.displayStatussku.name (VM size), sku.capacity (instance count), tags.aks-managed-poolNameproperties.securityRules[] (custom rules array), properties.securityRules[].properties.direction, properties.securityRules[].properties.access, properties.securityRules[].properties.sourceAddressPrefixkind (e.g., StorageV2), sku.name, properties.accessTier, properties.supportsHttpsTrafficOnly, properties.allowBlobPublicAccess, properties.encryption.keySourceproperties.fullyQualifiedDomainName, properties.publicNetworkAccess, properties.minimalTlsVersionsku.name (tier), sku.capacity (DTU/vCore), properties.status, properties.zoneRedundantproperties.kubernetesVersion, properties.powerState.code, properties.networkProfile.networkPlugin, properties.enableRBACkind (e.g., functionapp,linux), properties.state, properties.defaultHostName, properties.siteConfig.linuxFxVersionproperties.runningStatus, properties.template.containers[].image, properties.template.scale.minReplicas, properties.template.scale.maxReplicassku.name, properties.kafkaEnabled, properties.zoneRedundantsku.name (Basic/Standard/Premium), properties.zoneRedundant, properties.minimumTlsVersion, properties.publicNetworkAccess, properties.disableLocalAuth, properties.statusproperties.maxSizeInMegabytes, properties.enablePartitioning, properties.deadLetteringOnMessageExpiration, properties.maxDeliveryCount, properties.lockDuration, properties.requiresDuplicateDetection, properties.statusproperties.enableRbacAuthorization, properties.enableSoftDelete, properties.publicNetworkAccessproperties.sku.name, properties.hostName, properties.redisVersion, properties.enableNonSslPortkind (e.g., GlobalDocumentDB), properties.EnabledApiTypes, properties.consistencyPolicy.defaultConsistencyLevelsku.name, tags.aks-managed-cluster-nameproperties.sku.name, properties.sku.tier, properties.operationalState, properties.webApplicationFirewallConfiguration.enabled, properties.webApplicationFirewallConfiguration.firewallMode (Detection/Prevention), properties.webApplicationFirewallConfiguration.ruleSetType, properties.webApplicationFirewallConfiguration.ruleSetVersion, properties.webApplicationFirewallConfiguration.disabledRuleGroups[], properties.webApplicationFirewallConfiguration.exclusions[], properties.firewallPolicy.idAll Azure queries build on four core patterns. Master these and adapt them to any entity type.
List resources by type, filter by subscription/resource group/region/tags, summarize counts:
smartscapeNodes "AZURE_*"
| filter azure.subscription == "<SUBSCRIPTION_ID>" and azure.location == "<REGION>"
| summarize count = count(), by: {type}
| sort count desc
To list a specific type, replace "AZURE_*" with the entity type (e.g., "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES"). Add | fields name, azure.subscription, azure.resource.group, azure.location, ... to select specific columns. Use tags[`TagName`] for tag-based filtering.
Parse azure.object JSON for detailed configuration fields:
smartscapeNodes "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINES"
| parse azure.object, "JSON:azjson"
| fieldsAdd vmSize = azjson[configuration][properties][hardwareProfile][vmSize],
osType = azjson[configuration][properties][storageProfile][osDisk][osType]
| summarize vm_count = count(), by: {vmSize, osType, azure.location}
Follow relationships between resources. Use "*" for the relationship name since Azure does not populate dt.traverse.relationship:
smartscapeNodes "AZURE_MICROSOFT_NETWORK_LOADBALANCERS"
| parse azure.object, "JSON:azjson"
| fieldsAdd lbSku = azjson[configuration][sku][name]
| traverse "*", "AZURE_MICROSOFT_NETWORK_LOADBALANCERS_BACKENDADDRESSPOOLS", fieldsKeep:{lbSku, name, id}
| fieldsAdd backendPoolName = name
| traverse "*", "AZURE_MICROSOFT_COMPUTE_VIRTUALMACHINESCALESETS", direction:backward, fieldsKeep:{backendPoolName, id}
| fieldsAdd loadBalancerName = dt.traverse.history[-2][name],
loadBalancerId = dt.traverse.history[-2][id],
backendPoolId = dt.traverse.history[-1][id]
Key differences from AWS traversals:
"*" as the relationship name (relationship type names are empty for Azure)Group resources by any tag for ownership/chargeback:
smartscapeNodes "AZURE_*"
| filter isNotNull(tags[`<TAG_NAME>`])
| summarize resource_count = count(), by: {tags[`<TAG_NAME>`], type}
| sort resource_count desc
Common Azure tags: tags[`ACE:CREATED-BY`], tags[`dt_owner_email`], tags[`dt_owner_team`], tags[`project`], tags[`managed-by`]. Replace "AZURE_*" with a specific type to scope to one service.
Find untagged resources: | filter arraySize(tags) == 0
Load reference files for detailed queries when the core patterns above need service-specific adaptation.
| Reference | When to load | Key content |
|---|---|---|
| vnet-networking-security.md | VNet topology, subnets, NSGs, public IPs, VPN, peering | VNet/subnet mapping, NSG blast radius, public IP detection |
| database-monitoring.md | Azure SQL, Cosmos DB, Redis Cache | Service tier distribution, zone redundancy, public access checks |
| serverless-containers.md | Functions, App Service, AKS infra, Container Apps | Runtime distribution, App Service Plan mapping, AKS node pools |
| load-balancing-api.md | Load Balancers, Application Gateways, API Management | LB backend pool traversal, App Gateway routing, APIM config |
| messaging-integration.md | Event Hubs, Service Bus, Event Grid | Namespace inventory, Kafka enablement, throughput unit analysis |
| storage-monitoring.md | Storage Accounts, Blob, File, Queue, Table | SKU distribution, access tier, encryption audit, public access |
| resource-management.md | Resource audits, tag compliance, lifecycle | Unattached disks, tag coverage, provisioning state analysis |
| cost-optimization.md | Cost savings, unused resources, sizing | VM SKU analysis, unattached disks, deallocated VMs |
| capacity-planning.md | Capacity analysis, scaling, utilization | VMSS headroom, subnet IP counts, AKS node pool sizing |
| security-compliance.md | Security audits, encryption, public access, Key Vault | NSG rule analysis, TLS version audit, public endpoint detection, encryption checks |
| resource-ownership.md | Chargeback, ownership, cost allocation | Tag-based grouping, subscription/resource-group summaries |
| workload-detection.md | Determine orchestration context and resolution path | AKS node, VMSS member, standalone VM detection for blast radius analysis |
| metrics-performance.md | Query metric timeseries for a specific resource | DQL timeseries patterns for VM, SQL, Storage, Event Hub, LB, App Service, AKS, Cosmos DB, Redis, App Gateway |
"AZURE_*" wildcards when possible)| limit N for explorationisNotNull() checks before accessing nested fieldsazure.object with JSON parser: parse azure.object, "JSON:azjson"fieldsAdd configField = azjson[configuration][properties][field]azjson[configuration][sku][name] (not inside properties)toString() for complex nested objectsazure.subscription in multi-subscription environmentsazure.resource.group to narrow to a team or application boundaryazure.location for region-specific analysissummarize ... by: {azure.subscription, azure.resource.group} for organizational breakdownstags[`key`] for filtering (backtick-quoted key names)arraySize(tags) for untagged resourcesdt_owner_email, dt_owner_team, ACE:CREATED-BYparse azure.object, "JSON:azjson"cloud.azure.* naming convention (see Azure Metric Naming Convention)"*" as the relationship name in traverse commandsdirection:backward for reverse relationships (e.g., sub-resources to parent)fieldsKeep to maintain important fields through traversaldt.traverse.history[0][id] for single-hop source entity ID; use lookup to resolve source entity namedt.traverse.history[-N] accesses fields carried via fieldsKeepdt-obs-kubernetes skillgetNodeName() for human-readable resource namesisNotNull() and isNull()countDistinct() for unique resource countsazure.resourceType field is lowercase ARM format (e.g., microsoft.compute/virtualmachines) — useful for filtering but not for entity type matchingnpx claudepluginhub dynatrace/dynatrace-for-ai --plugin dynatraceQueries Azure resources across subscriptions using Resource Graph. Lists VMs, apps, storage; finds orphaned items, audits tags, inventories/counts types.
Guides Azure capacity and quota management for SaaS ISVs in EA/MCA subscriptions. Covers VM quota increases, reservation groups, region access, alerts, AKS integration, and governance.
Expert guidance for Azure Monitor: troubleshooting, best practices, architecture, security, and integrations with Log Analytics, Application Insights, KQL, and Prometheus/Grafana.