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 TrueSight Capacity 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
- 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 |
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 |
Metric mapping details for the Resource Manager model
Configuration metrics for virtual machines
Important: The enhanced DISK_SIZE and BYDISK_SIZE that show the actual size of the disk are available only when you apply Cumulative Hotfix 4 or later on Patch 2 (20.02.02) of TrueSight Capacity Optimization 20.02.
TrueSight Capacity Optimization metric | Azure metric | Formula |
|---|---|---|
CPU_NUM | numberOfCores | Not applicable |
DISK_NUM | maxDataDiskCount | Not applicable |
DISK_SIZE | Derived | Sum(BYDISK_SIZE) |
BYDISK_SIZE |
| 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 | memoryInMB*1024*1024 |
TOTAL_LDISK_SIZE1 | \LogicalDisk(_Total)\Free Megabytes and \ | ((\LogicalDisk(_Total)\Free Megabytes*1024*1024)*100)/(\LogicalDisk(_Total)\% Free Space) |
CPU_MHZ1 | \Processor Information(_Total)\Processor Frequency | Not applicable |
1 - These metrics are available only:
- For Microsoft Windows operating system.
- If the Guest OS diagnostics or the Monitor Agent settings are enabled for your virtual machines.
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.)
TrueSight Capacity Optimization metric | Azure metric | Formula |
|---|---|---|
CPU_UTIL | Percentage CPU | PERCENTAGE_CPU/100 |
CPU_USED_NUM | Derived | CPU_NUM*(PERCENTAGE_CPU)/100 |
DISK_READ_RATE | Disk Read Bytes | DISK_READ_BYTES/36001 |
DISK_WRITE_RATE | Disk Write Bytes | DISK_WRITE_BYTES/36001 |
DISK_TRANSFER_RATE | Derived | (DISK_READ_BYTES+DISK_WRITE_BYTES)/36001 |
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/36001 |
NET_IN_BYTE_RATE | Network In | NETWORK_IN/36001 |
NET_BIT_RATE | Derived | ((NETWORK_IN + NETWORK_OUT)*8)/36001 |
NET_BYTE_RATE2 | Derived | (NETWORK_IN + NETWORK_OUT)/36001 |
1 - When you collect the data at a 15-minute resolution, these values are divided by 900 instead of 3600 (for the default 1-hour resolution). For example, DISK_READ_BYTES/900. For information about changing the data resolution, see Microsoft-Azure-Azure-API-Extractor.
2 - 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.
High mark metrics
Note: The high-mark metrics are available only when you apply Cumulative Hotfix 3 or later on Patch 2 (20.02.02) of TrueSight Capacity Optimization 20.02.
High Mark metric | Base metric to calculate high-mark metric | Azure metric |
|---|---|---|
CPU_USED_NUM_HM | CPU_NUM * CPU_UTIL | The calculation is based on base metrics (1M granularity*) |
DISK_TRANSFER_RATE_HM | DISK_TRANSFER_RATE | Disk Read Bytes, Disk Write Bytes (1M granularity*) |
NET_BIT_RATE_HM | NET_BIT_RATE | Network In, Network Out (1M granularity*) |
* 1M granularity indicates that the metric data is sampled every minute.
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:
Related topic