Entities, lookup information, metrics, and API calls for Azure Resource Manager model
This topic provides information about the entity relationship, mapping between the Azure metrics and the BMC Helix Continuous Optimization metrics, and API calls for Azure Resource Manager model.
Entity list
The Microsoft Azure - Azure API Extractor monitors the following entities in the Azure Resource Manager model:
- Resource Group
- App Service
- Virtual Machine
Entity relationship
The following table describes entity relationship details for the Resource Manager model:
Parent entity | Child entity | Relationship type |
|---|---|---|
Resource Group - Azure (rg:azu) | Virtual Machine - Azure (gm:azu) | RG_CONTAINS_GM |
Resource Group - Azure (rg:azu) | App Service - Azure (as:azu) | RG_CONTAINS_AS |
Lookup information
The following table explains the lookup fields for Azure entities that you can use to quickly find the required entity.
Entity type | Lookup fields | |
|---|---|---|
Strong | Weak | |
Cloud Service - Azure | CLOUD_SERVICE_NAME | Not applicable |
Deployment - Azure | DEPLOYMENT_GUID, RESOURCE_ID | Not applicable |
Role - Azure | PARENT_DEPLOYMENT_GUID&&ROLE_NAME | Not applicable |
Virtual Machine - Azure | RESOURCE_ID, UUID | HOSTNAME, NAME |
App Service - Azure | RESOURCE_ID | DEFAULT_HOSTNAME |
Resource Group - Azure | RESOURCE_ID | Not applicable |
Business Service | APPLICATION_NAME | Not applicable |
Configuration metrics for virtual machines
BMC Helix Continuous Optimization metric | Azure metric | Formula |
|---|---|---|
CPU_NUM | numberOfCores | Not applicable |
DISK_NUM | maxDataDiskCount | Not applicable |
DISK_SIZE | resourceDiskSizeInMB | Not applicable |
LOCATION_SITE | location | Not applicable |
OS_FAMILY | properties.osDisk.osType | Not applicable |
OS_TYPE | properties.storageProfile.imageReference.offer | Not applicable |
OS_VER | properties.storageProfile.imageReference.sku | Not applicable |
REQUESTED_INSTANCE_TYPE | properties.hardwareProfile.vmSize | Not applicable |
TOTAL_REAL_MEM | memoryInMB | resourceDiskSizeInMB*1024*1024 |
TOTAL_LDISK_SIZE | \LogicalDisk(_Total)\Free Megabytes and \ | ((\LogicalDisk(_Total)\Free Megabytes*1024*1024)*100) / |
Performance metrics for virtual machines
The following metrics are available for any VM when "Boot diagnostics" is enabled. (This option is enabled by default while creating VM.)
BMC Helix Continuous Optimization metric | Azure metric | Formula |
|---|---|---|
CPU_UTIL | Percentage CPU | PERCENTAGE_CPU/100 |
DISK_READ_RATE | Disk Read Bytes | DISK_READ_BYTES/3600 |
DISK_WRITE_RATE | Disk Write Bytes | DISK_WRITE_BYTES/3600 |
DISK_TRANSFER_RATE | Derived | (DISK_READ_BYTES+DISK_WRITE_BYTES)/3600 |
DISK_IO_READ_RATE | Disk Read Operations/Sec | Not applicable |
DISK_IO_WRITE_RATE | Disk Write Operations/Sec | Not applicable |
DISK_IO_RATE | Derived | DISK_READ_OPERATIONS_PER_SEC + DISK_WRITE_OPERATIONS_PER_SEC |
NET_OUT_BYTE_RATE | Network Out | NETWORK_OUT/3600 |
NET_IN_BYTE_RATE | Network In | NETWORK_IN/3600 |
NET_BIT_RATE | Derived | ((NETWORK_IN + NETWORK_OUT)*8)/3600 |
NET_BYTE_RATE1 | Derived | (NETWORK_IN + NETWORK_OUT)/3600 |
1 - Indicates metrics that are set at level 4. These metrics are imported only when the collection level of the ETL is set to ‘Extended’. For information about changing the collection level, see Microsoft-Azure-Azure-API-Extractor.
Configuration metrics for App Services
BMC Helix Continuous Optimization metric | Azure metric | Formula |
|---|---|---|
APP_SERVICE_STATUS | Status | Not applicable |
OS_FAMILY | Kind | Not applicable |
REGION_ID | Location | Not applicable |
REGION_NAME | displayName | Not applicable |
LOCATION_SITE | Location | Not applicable |
TOTAL_APP_DOMAINS | Total App Domains | Average |
TOTAL_UNLOADED_APP_DOMAINS | Total App Domains Unloaded | Average |
Performance metrics for App Services
BMC Helix Continuous Optimization metric | Azure metric | Formula |
|---|---|---|
APP_CONNECTIONS | Connections | Average |
APP_CPU_TIME | CPU Time | Sum |
DATA_IN_BANDWIDTH | Data In | Sum |
DATA_OUT_BANDWIDTH | Data Out | Sum |
HTTP_RESPONSE_TIME | Response Time | Average |
HTTP_SERVER_ERRORS | Http Server Errors | Sum |
IO_READ_OPS_RATE | IO Read Operations Per Second | Sum |
IO_READ_RATE | IO Read Bytes Per Second | Sum |
IO_WRITE_OPS_RATE | IO Write Operations Per Second | Sum |
IO_WRITE_RATE | IO Write Bytes Per Second | Sum |
MEM_USED | Memory working set | Average |
REQUESTS | Requests | Sum |
API calls for the Azure API ETL
The extractor makes the following Resource Management REST API calls on Azure cloud services in the Azure Resource Manager model.
For more information, see the Azure Resource Manager.
API calls for the Azure Government cloud
The extractor makes the following REST API calls to fetch the required details from the Azure Government cloud: