Microsoft Azure Cloud components discovery using patterns

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 25 minutes to read

    • Discovery uses multiple patterns to discover components of the Microsoft Azure Cloud deployment during horizontal discovery. Discovering some of these resources requires updating the Discovery and Service Mapping Patterns application from the ServiceNow Store.

    Request new or enhanced Patterns on the ServiceNow® Store

    Visit the ServiceNow Store to view all the available updates and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

    Prerequisites

    Verify that the applications are up to date.
    • Discovery and Service Mapping Patterns
    • CMDB CI Class Models
    • Visibility Content
    Configure Microsoft Azure discovery schedule
    Activate the cloud-related CI relationships
    To include discovered components into application services, enable CI relationships used in tag-based discovery by Service Mapping. These CI relationships are available from the 1.0.68 release on the ServiceNow Store. For operational steps, see Tag-based discovery configuration.
    Azure Availability Set
    Wait for the Clean-Up job for Availability zone to clear availability set record schedule job to delete all the pre-populated availability set's Configuration Items (CI) in the cmdb_ci_azure_availability_set table.
    Azure Availability Zone

    To run a discovery with Azure Availability Zone, register the subscription ID to the AvailabilityZonePeering feature with AZ CLI using az feature register -n AvailabilityZonePeering --namespace Microsoft.Resources to use the Check Zone Peering API. Check the status with az feature show -n AvailabilityZonePeering --namespace Microsoft.Resources before running discovery.

    Verify the REST API Permissions

    Download the Cloud Discovery patterns spreadsheet so you can grant user permissions required for running the Discovery patterns. In addition to permissions, the spreadsheet also includes useful information such as pattern names, types, CI Classes, and links to vendor documentation. New patterns are available quarterly, so check periodically to be sure you have the latest version of the spreadsheet.

    Azure resources discovery by datacenters

    Azure has dozens of datacenters around the world. Your resources like load balancers and virtual machines are typically not located on all datacenters, but only on some of them. The Azure Datacenter Discovery pattern executes before all other Azure patterns to identify the datacenters that have resources related to your service account ("active") and the datacenters that don't have your resources ("passive"). This model improves the performance of the Azure discovery. This execution model is more efficient than the previous one, in which all datacenters were discovered regardless of having relevant resources in them.

    After identifying the "active" and "passive" datacenters, the Discovery schedule continues to execute all Azure patterns only for the "active" datacenters, to discover the Azure cloud resources you have. The "passive" datacenters are ignored while running the schedule.

    Datacenters that have already been discovered prior to Discovery and Service Mapping Patterns version 1.15.0, remain in the Azure Datacenters table. However, the discovery runtime behavior is now determined by the value of the MID Server property mid.cloud.discovery.sonar.discover_all_azure_datacenters. The property is set to false by default, to limit the discovery execution to the "active" datacenters, rather than all datacenters. You can discover all datacenters for a service account, including "passive" ones, by setting the property to true. For more information, see: Create a MID Server property

    You might notice differences in Azure discovery log, in discovery time and in the CMDB, depending on the service account and MID Server property settings.

    Differences according to the service account discovery, after deploying Discovery and Service Mapping Patterns version 1.15.0:
    • For newly discovered service account:
      • If the MID Server property is set to false (default), Discovery collects the Azure resources only for "active" datacenters. The Azure Datacenters table contains only “active” datacenters records for the service account. The discovery log (Devices tab) shows only “active” datacenters.
      • If the MID Server property is set to true, Discovery collects the Azure resources for all datacenters. The Azure Datacenters table contains all datacenter records for the service account. The discovery log (Devices tab) shows all datacenters (“active” and “passive”).
    • For a service account discovered prior to Discovery and Service Mapping Patterns version 1.15.0:
      • If the MID Server property is set to false (default), Discovery collects the Azure resources only for "active" datacenters. TheAzure Datacenters table contains all datacenter records for the service account. The discovery log (Devices tab) shows only “active” datacenters.
      • If the MID Server property is set to true, Discovery collects the Azure resources for all datacenters. The Azure Datacenters table contains all datacenter records for the service account. The discovery log (Devices tab) shows all datacenters (“active” and “passive”).

    For management groups, Azure Cloud Discovery discovers all Azure datacenters.

    Azure Hardware Type discovery

    Hardware Type discovery has undergone three model changes in recent years. The 1.15.0 model triggers the Hardware Type pattern and the Virtual Machine pattern after the Azure Datacenter Discovery pattern. Starting Discovery and Service Mapping Patterns plugin version 1.15.0, Cloud Discovery identifies which Hardware Type model is used, and launches only one of the two patterns: Hardware Type (LP) or Cloud Hardware Type (LP).
    Table 1. Migration to the new Azure Hardware Type discovery model- Use cases
    Discovery and Service Mapping Patterns version Hardware Type Migration status Which pattern executes Discovery result
    Prior to 1.0.75 Haven't migrated to the new model Hardware Type (LP) pattern

    The CI type created: [cmdb_ci_compute_template]

    Discovery and Service Mapping Patterns version 1.0.75

    The migration to the new model is done by migration script. See KB0955939

    		 Hardware Type (LP) pattern

    The CI type created: [cmdb_ci_cloud_hardware_type]

    Discovery and Service Mapping Patterns version 1.6.0

    		 The Hardware Type new model is provided OOB, enabled with the system property: sn_itom_pattern.use a single hardware type for cloud datacenters. For more information, seeKB1285337.

    According to KB1285337 Flow Diagram

    The CI type created: According to KB1285337

    Discovery and Service Mapping Patterns 1.15.0

    		 The Hardware Type new model is provided OOB enabled with the system property: sn_itom_pattern.use a single hardware type for cloud datacenters. For more information, seeKB1285337.

    The flow is as described in KB1285337. However, only one pattern executes. The pattern that used to gracefully terminate doesn't execute.

    		Either Hardware Type (LP) pattern or Cloud Hardware Type (LP) pattern executes.

    Azure SQL Managed Instance license discovery

    The Azure DataBase (LP) pattern extension Azure SQL Managed Instance license discovers Azure SQL Managed Instance license information and populates the license type in the Key Value [cmdb_key_value] table of Cloud Database CI [cmdb_ci_cloud_database].

    Required plugins and applications
    • Software Asset Management Professional for Microsoft
    • Visibility Content
    Discovered resources and relationships
    Resources discovered using the Azure DataBase (LP) pattern extension: Azure SQL Managed Instance license
    Relationships discovered using the Azure DataBase (LP) pattern extension: Azure SQL Managed Instance license

    Azure Marketplace discovery

    The Azure - Marketplace LB (LP) pattern discovers the following Azure Marketplace products:
    • SaaS
    • Azure Application
    • Virtual Machine
      Note:
      The pattern discovers only virtual machines (VMs) created from third-party or commercial marketplace images.
    Discovered resources and relationships
    Resources discovered by the Azure - Marketplace LB (LP) pattern
    Relationships discovered using the Azure - Marketplace LB (LP) pattern

    Data collected by Discovery during horizontal discovery

    Resources discovered by the Microsoft Azure - Application LB (LP) pattern
    Field Description
    Cloud Load Balancer [cmdb_ci_cloud_load_balancer​]
    object_id A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer.
    location The path of the load balancer.
    state The current state of the load balancer.
    install_status Resource provisioning status.
    ip_address​ IP Address of the load balancer.
    fqdn The fully qualified domain name of the load balancer.
    dns_name The DNS name of the load balancer.
    comments Identifier for internal usage (deletion strategy).
    Cloud LB IP Address [cmdb_ci_cloud_lb_ipaddress]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    lb_id​ A unique identifier for the load balancer.
    ip_address​ IP address of the load balancer.
    ip_address_type The type of the IP Address, which can be private or public.
    fqdn The fully qualified domain name of the load balancer.
    comments Identifier for internal usage (deletion strategy).
    install_status​ Resource provisioning status.
    Load Balancer Pool [cmdb_ci_lb_pool​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer pool.
    location Path of the load balancer pool.
    install_status​ Resource provisioning status.
    comments Identifier for internal usage (deletion strategy).
    Load Balancer Service [cmdb_ci_lb_service]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer service.
    location Path of the load balancer service.
    port The TCP port that the load balancer service listens to.
    install_status Resource provisioning status.
    comments Identifier for internal usage (deletion strategy).
    Resources discovered by the Microsoft Azure - Availability Set (LP) pattern
    Field Description
    Availability Set [cmdb_ci_availability_set]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the availability zone.
    install_status​ Resource provisioning status.
    Resources discovered by the Microsoft Azure - Availability Zones (LP) pattern
    Field Description
    Availability Zone [cmdb_ci_availability_zone]
    object_id​ {Location} + "-"  + {ZoneNum}
    name {Location} + "-" + {ZoneNum}
    Resources discovered by the Microsoft Azure - Classic LB (LP) pattern
    Field Description
    Cloud Load Balancer [cmdb_ci_cloud_load_balancer​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer.
    location Path of the load balancer.
    state The current state of the load balancer.
    install_status Resource provisioning status.
    comments Identifier for internal usage (deletion strategy).
    Cloud LB IP Address [cmdb_ci_cloud_lb_ipaddress]
    object_id​ ​ ​ ​ A unique identifier, allocated by Microsoft Azure for this resource.
    lb_id​ A unique identifier for the load balancer.
    ip_address​ IP address of the load balancer.
    ip_address_type The type of the IP address, which can be private or public.
    fqdn The fully qualified domain name of the load balancer.
    comments Identifier for internal usage (deletion strategy).
    install_status​ Resource provisioning status.
    Load Balancer Service [cmdb_ci_lb_service]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer service.
    location Path of the load balancer service.
    port The TCP port that the load balancer service listens to.
    install_status Resource provisioning status.
    comments Identifier for internal usage (deletion strategy).
    Load Balancer Pool [cmdb_ci_lb_pool​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the load balancer pool.
    location Path of the load balancer pool.
    install_status​ Resource provisioning status.
    comments Identifier for internal usage (deletion strategy).
    Resources discovered by the Microsoft Azure - Hardware Type (LP) pattern
    Field Description
    Hardware Type [cmdb_ci_hardware_type]​
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the hardware type.
    local_storage_gb​ Storage assigned to this template.
    cores The default number of cores for the instance type.
    memory_mb​ Memory size assigned to this template.
    vcpus Number of CPU cores assigned to this template.
    Resources discovered by the Microsoft Azure - Host (LP) pattern
    Field Description
    Host [cmdb_ci_cloud_host]​
    name The Name or ID if no Name is specified for the host.
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    host_type The host type.
    cloud_vendor The cloud vendor: Microsoft Azure.
    virtual Virtual host: False.
    Resources discovered by the Microsoft Azure - Image (LP) pattern
    Field Description
    Image table [cmdb_ci_os_template​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the image.
    location Path of the image.
    guest_os Operating system that is secondary to the OS.
    comments Identifier for internal usage (deletion strategy).
    image_source Source of the OS image.
    Note:
    When using the Image [cmdb_ci_os_template] table to store Cloud OS Images, you may notice an unusually large number of records. To avoid this issue, you can store the discovered OS images in the Cloud Image [cmdb_ci_cloud_os_image] table. For more information, see Enable Cloud OS Image discovery.
    Resources discovered by the Microsoft Azure - Network and Subnet (LP) pattern
    Field Description
    Cloud Network [cmdb_ci_network]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the cloud network.
    location Path of the network.
    state The current state of the network.
    install_status​ Resource provisioning status.
    cidr CIDR representation of the network. For example, 10.0.0.0/24.
    Cloud Subnet [cmdb_ci_cloud_subnet​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the cloud subnet.
    location Identifier for internal usage (deletion strategy).
    state The current state of the subnet.
    install_status Resource provisioning status.
    cidr CIDR representation of the subnet. For example, 10.0.0.0/24.
    Resources discovered by the Microsoft Azure - NIC (LP) pattern
    Field Description
    Cloud Mgmt Network Interface [cmdb_ci_nic]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the network interface.
    location Path of the network interface.
    install_status Resource provisioning status.
    state The current state of the network interface.
    public_ip The address of the Elastic IP address bound to the network interface.
    private_ip​ The IPv4 address of the network interface within the subnet.
    primary True/False. Defines if the network interface is the primary network interface or not.
    mac_address The MAC address of the network interface.
    public_dns​ The public DNS name of the network interface.
    Resources discovered by the Microsoft Azure - Private Gateway (LP) pattern
    Field Description
    Virtual Private Gateway [cmdb_ci_virtual_pvt_gateway]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the private gateway.
    location Path of the private gateway.
    connection_type Type of VPN connection the gateway supports.
    operational_status The state of the resource.
    install_status​ Resource provisioning status.
    Virtual Private Gateway Endpoint [cmdb_ci_endpoint_vpg]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the endpoint.
    location Path of the endpoint.
    connection_type​ Type of VPN connection the gateway supports.
    Resources discovered by the Microsoft Azure - Public IP (LP) pattern
    Field Description
    Cloud Public IP Address [cmdb_ci_cloud_public_ipaddress]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the IP address.
    location Path of the IP address.
    state The current state of the IP address.
    public_ip_address The address of the Elastic IP address.
    public_dns​ The public DNS name.
    install_status Resource provisioning status.
    Resources discovered by the Microsoft Azure - Resource Group (LP) pattern
    Field Description
    Resource Group [cmdb_ci_resource_group]
    object_id A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the resource group.
    location Path of the resource group.
    state The current state of the resource group.
    install_status​ Resource provisioning status.
    Resources discovered by the Microsoft Azure - Route Table (LP) pattern
    Field Description
    Route Table [cmdb_ci_route_table]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the route table.
    location Path of the route table.
    install_status Resource provisioning status.
    state The current state of the route table.
    Resources discovered by the Microsoft Azure - Security Group (LP) pattern
    Field Description
    Compute Security Group [cmdb_ci_compute_security_group​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the security group.
    location Path of the security group.
    state The current state of the security group.
    install_status Resource provisioning status.
    Resources discovered by the Microsoft Azure - SQL Server (LP) pattern
    Field Description
    Virtual Machine Instance [cmdb_ci_vm_instance]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    location Path of the VM instance.
    Resources discovered by the Microsoft Azure - Storage Account (LP) pattern
    Field Description
    Cloud Storage Account [cmdb_ci_cloud_storage_account]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the storage account.
    location Path of the storage account.
    sku_name The name of the SKU (for backup frequency).
    install_status​ Resource provisioning status.
    state The current state of the storage account.
    Resources discovered by the Microsoft Azure - Storage Containers (LP) pattern
    Field Description
    Storage Volume [cmdb_ci_storage_volume]
    object_id A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the storage volume.
    location Path of the storage volume.
    volume_id Identifier that holds the volume ID as the value.
    volume_container​ The container name.
    comments Identifier for internal usage (deletion strategy).
    status The status of the resource.
    Block Endpoint [cmdb_ci_endpoint_block]
    name The Name or ID if no Name is specified for the block endpoint.
    object_id A unique identifier, allocated by Microsoft Azure for this resource.
    Resources discovered by the Microsoft Azure - Storage Volume (LP) pattern
    Field Description
    Storage Volume [cmdb_ci_storage_volume]​
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the storage volume.
    volume_id​ The volume type. For example:
    • gp2 for General Purpose SSD
    • io1 for Provisioned IOPS SSD
    • st1 for Throughput Optimized HDD
    • sc1 for Cold HDD
    • standard for Magnetic volumes
    location Path of the storage volume.
    state The current state of the storage volume.
    install_status​ Resource provisioning status.
    size The size of the volume.
    size_bytes The size of the volume (bytes).
    storage_type For example, hard-coded value “block.”
    comments Identifier for internal usage (deletion strategy).
    Resources discovered by the Microsoft Azure - Sub Account (LP) pattern
    Field Description
    Cloud Service Account [cmdb_ci_cloud_service_account​]
    object_id​ ​ ​ ​ ​ ​ ​ A unique identifier, allocated by Microsoft Azure for this resource.
    account_id The unique identifier (ID) of the account.
    name The Name or ID if no Name is specified for the service account.
    datacenter_type cmdb_ci_azure_datacenter
    discovery_credentials Reference field to the related Microsoft Azure credentials.
    datacenter_url The URL of the datacenter.
    parent_account Reference to the primary account, if it exists.
    is_master_account​ The Boolean attribute indicating if this is the primary account or not.
    Resources discovered by the Microsoft Azure - Virtual Machine (LP) pattern
    Field Description
    Virtual Machine Instance [cmdb_ci_vm_instance]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the instance.
    location The path of the instance.
    install_status Resource provisioning status.
    state The current state of the instance.
    vm_inst_id The ID of the instance.
    nics The number of NICs available to the instance.
    disks The number of disks attached to the instance.
    disks_size The total size of the attached disks.
    memory The amount of memory available to the instance. (MBs)
    cpus The number of CPUs available to the instance.
    Block Endpoint [cmdb_ci_endpoint_block]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the endpoint.
    location The path of the endpoint.
    host The public IPv4 address assigned to the instance, if applicable.
    Storage Volume [cmdb_ci_storage_volume]
    object_id​​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the storage volume.
    location The path of the storage volume.
    comments Identifier for internal usage (deletion strategy).
    Cloud Mgmt Network Interface [cmdb_ci_nic​]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    location The path of the network interface.
    VNIC Endpoint [cmdb_ci_endpoint_vnic]
    object_id​ A unique identifier, allocated by Microsoft Azure for this resource.
    name The Name or ID if no Name is specified for the endpoint.
    location The path of the endpoint.
    The pattern extension section discovers Bring Your Own License (BYOL) or the included licenses for Windows VMs and Red Hat Enterprise Linux (RHEL) VMs.
    • For Windows VM using a custom image, Discovery populate key values only when the primary OS disk details are available.
    • For RHEL VMs, information is populated only for VMs that use Marketplace images.
    Field Description
    Key value [cmdb_key_value]
    Key [key] The key is one of the options:
    • Windows_OS_License_Type_automatic
    • RHEL_OS_License_Type_automatic
    • SQL_Server_License_Type_automatic
    Value [value] The value is one of the options:
    • BYOL
    • License Included
    CI [ci] Reference to the Virtual Machine Instance record.
    Class The Class is Virtual Machine Instance.
    Resources discovered by the Microsoft Azure WebSite (LP) pattern and Microsoft Azure WebSite pattern
    Field Description
    Cloud Resource [cmdb_ci_cloud_webserver]
    Name​ [name] The name of the Azure web server.
    Object ID [object_id] The ID of Azure web server.
    IP Address [ip_address]​ The IP address of the web server.
    FQDN [fqdn] The fully qualified domain name (FQDN) of the web server.
    Vendor [vendor] The vendor is Microsoft.
    Install Status [install_status] The install status of the web server.
    State [state] The operational state of the web server.
    Operational Status [operational_status] The operational status of the web server.
    IP Address [cmdb_ci_ip_address]
    Name [name] The IP address of the web server.
    IP Address [ip_address] The IP address of the web server.
    FQDN [fqdn] The fully qualified domain name (FQDN).
    Vendor [vendor] The vendor is Microsoft.
    Install Status [install_status] The install status.
    Operational Status [operational_status] The operational status.
    Key Value [cmdb_key_value]
    Key [key] The Azure Key Value name.
    Value [value] The Azure Key Value value.
    Resources discovered using the Azure DataBase (LP) pattern
    Table 2. Cloud DataBase [cmdb_ci_cloud_database]
    Field Description
    Fully qualified domain name [fqdn] The FQDN that Microsoft Azure assigned to your database.
    Name [name] The name of the database that you created in Microsoft Azure.
    Object ID [object_id] The identification name of the database.
    Operational Status [operational_status] The operational status of the database.
    Type [type] The type of database you created.
    State [state] The state of the database: Whether it’s Available or Terminated.
    Vendor [vendor] The vendor name is Azure.
    Version [version] The version of the database.
    Category [category] The stock keeping unit (SKU) family.
    Table 3. Cloud Hardware Type [cmdb_ci_cloud_hardware_type]​
    Field Description
    Object ID [object_id] A unique identifier for the hardware type.
    Name [name] Name for the hardware type.
    vCPUs [vcpus] Number of virtual CPU cores.
    Provider [provider] Provider for the hardware type: Azure.
    Table 4. IP Address [cmdb_ci_ip_address]
    Field Description
    Netmask [netmask] Netmask of the Azure database.
    Resources discovered using the Azure DataBase (LP) pattern extension: Azure SQL Managed Instance license
    Table 5. Key value [cmdb_key_value]
    Field Description
    Key [key] SQL_Server_PaaS_Managed_Instance_License_Type_automatic
    Value [value] License type. The following maps the Azure portal license to ServiceNow values:
    • Azure Hybrid Benefit: BYOL
    • Pay as you go: License Included
    • Hybrid Failover rights: Hybrid Failover
    Configuration item [configuration_item] cmdb_ci_cloud_database
    Table 6. Serverless Hardware [cmdb_ci_serverless_hardware]
    Field Description
    Object ID [object_id] Object ID of the Azure cloud database.
    Name [name] SKU name.
    Cloud Vendor [cloud_vendor] Cloud vendor of the serverless hardware: MS Azure.
    CPU core count [cpu_core_count] Number of virtual cores (vCores).
    CPU core thread [cpu_core_thread] Number of vCores.
    CPU count [cpu_count] Number of vCores.
    Category [category] vCore purchasing model.
    Subcategory [subcategory] SKU tier.
    Host Type [host_type] Host type: PaaS.
    Resources discovered by the Azure - Marketplace LB (LP) pattern
    Table 7. Deployed Marketplace Product [cmdb_ci_deployed_marketplace_product]​
    Field Description
    Name [name] Name of the Cloud resource, usually the marketplace offering or SKU name.
    Object ID [object_id] A unique resource ID of the Cloud resource.
    Resource Type [resource_type] Service in Cloud Marketplace.​ For example: microsoft.compute/virtualmachines.
    Plan Name [plan_name] Billing or SKU plan for a resource from the Cloud Marketplace.​ For example: Pay as You Go.
    Market [market] International Organization for Standardization (ISO) code of the geographical market where the resource is sold in the specified market. For example: US or EU.
    Organization Id [organization_id] A unique identifier for the organization or publisher that owns the marketplace resource.
    Table 8. Marketplace Product Details [marketplace_product_details]
    Field Description
    Product Code [product_code] A unique product code of the resource within the Cloud Marketplace.
    Publisher Name [publisher_name] Organization or individual responsible for creating and offering the product or service.
    Version [version] Release number or iteration of the product​.
    Deployed On [deployed_on] References the Deployed Marketplace Product [cmdb_ci_deployed_marketplace_product] table.
    Table 9. Key Value [cmdb_key_value]
    Field Description
    Key [key] Azure Key Value name.
    Value [value] Azure Key Value value.
    Resources discovered by the Azure - Sub Account (LP) pattern extension: Azure Management Groups
    Table 10. Cloud Organizations [cmdb_ci_cloud_org]
    Field Description
    Name [name] Tenant ID or name.
    • Tenant ID: When using management-level credentials
    • Tenant name: When using tenant-level credentials
    Object ID [object_id] Tenant ID.
    DNS Domain [dns_domain] Domain name entered during registration. For example: servicenow.com.

    This field is only populated when using tenant-level credentials.
    Table 11. Azure Management Group [cmdb_ci_azure_management_group]
    Field Description
    Name [name] Management group name.
    Object ID [object_id] Management group name and tenant ID in the following format: name+@+tenantId.

    For example: itomMgmtGroup@8bcff-vdc-btrv.
    Parent [parent] References the direct parent Azure Management Group [cmdb_ci_azure_management_group] table.

    CI relationships

    Relationships discovered using the Microsoft Azure - Application LB (LP) pattern
    CI Relationship CI
    cmdb_ci_cloud_load_balancer Owns::Owned by cmdb_ci_cloud_lb_ipaddress
    cmdb_ci_cloud_load_balancer Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_lb_service Hosted on::Hosts cmdb_ci_cloud_load_balancer
    cmdb_ci_cloud_subnet Contains::Contained by cmdb_ci_cloud_load_balancer
    cmdb_ci_lb_pool Hosted on::Hosts cmdb_ci_cloud_load_balancer
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_cloud_load_balancer
    Relationships discovered using the Microsoft Azure - Availability Set (LP) pattern
    CI Relationship CI
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_availability_set
    cmdb_ci_azure_datacenter Contains::Contained by cmdb_ci_availability_set
    Relationships discovered using the Microsoft Azure - Availability Zone (LP) pattern
    CI Relationship CI
    cmdb_ci_azure_datacenter Contains::Contained by cmdb_ci_availability_zone
    cmdb_ci_availability_zone Contains::Contained by cmdb_ci_vm_instance
    Relationships discovered using the Microsoft Azure - Classic LB (LP) pattern
    CI Relationship CI
    cmdb_ci_cloud_load_balancer Owns::Owned by cmdb_ci_cloud_lb_ipaddress
    cmdb_ci_cloud_load_balancer Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_lb_service Hosted on::Hosts cmdb_ci_cloud_load_balancer
    cmdb_ci_lb_pool Hosted on::Hosts cmdb_ci_cloud_load_balancer
    cmdb_ci_lb_pool Hosted on::Hosts cmdb_ci_lb_service
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_cloud_load_balancer
    Relationships discovered using the Microsoft Azure - Hardware Type (LP) pattern
    CI Relationship CI
    cmdb_ci_compute_template Hosted on::Hosts cmdb_ci_azure_datacenter
    Relationships discovered using the Microsoft Azure - Host (LP) pattern
    CI Relationship CI
    cmdb_ci_cloud_host Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_cloud_host
    cmdb_ci_vm_instance Runs on::Runs cmdb_ci_cloud_host
    Relationships discovered using the Microsoft Azure - Image (LP) pattern
    CI Relationship CI
    cmdb_ci_os_template Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_os_template
    Relationships discovered using the Microsoft Azure - Network and Subnet (LP) pattern
    CI Relationship CI
    cmdb_ci_network Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_network Contains::Contained by cmdb_ci_cloud_subnet
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_network
    Relationships discovered using the Microsoft Azure - NIC (LP) pattern
    CI Relationship CI
    cmdb_ci_nic Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_nic
    cmdb_ci_cloud_subnet Contains::Contained by cmdb_ci_nic
    Relationships discovered using the Microsoft Azure - Private Gateway (LP) pattern
    CI Relationship CI
    cmdb_ci_endpoint_vpg Implement End Point To::Implement End Point From cmdb_ci_virtual_pvt_gateway
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_virtual_pvt_gateway
    cmdb_ci_virtual_pvt_gateway Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_network Use End Point To::Use End Point From cmdb_ci_endpoint_vpg
    Relationships discovered using the Microsoft Azure - Public IP (LP) pattern
    CI Relationship CI
    cmdb_ci_cloud_public_ipaddress Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_nic Contains::Contained by cmdb_ci_cloud_public_ipaddress
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_cloud_public_ipaddress
    Relationships discovered using the Microsoft Azure - Resource Group (LP) pattern
    CI Relationship CI
    cmdb_ci_azure_datacenter Contains::Contained by cmdb_ci_resource_group
    Relationships discovered using the Microsoft Azure - Route Table (LP) pattern
    CI Relationship CI
    cmdb_ci_route_table Contains::Contained by cmdb_ci_route
    cmdb_ci_route_table Contains::Contained by cmdb_ci_network
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_route_table
    cmdb_ci_azure_datacenter Contains::Contained by cmdb_ci_route_table
    Relationships discovered using the Microsoft Azure - Security Group (LP) pattern
    CI Relationship CI
    cmdb_ci_cloud_subnet Uses::Used by cmdb_ci_compute_security_group
    cmdb_ci_network Contains::Contained by cmdb_ci_compute_security_group
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_compute_security_group
    cmdb_ci_compute_security_group Hosted on::Hosts cmdb_ci_azure_datacenter
    Relationships discovered using the Microsoft Azure - Storage Account (LP) pattern
    CI Relationship CI
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_cloud_storage_account
    cmdb_ci_cloud_storage_account Hosted on::Hosts cmdb_ci_azure_datacenter
    Relationships discovered using the Microsoft Azure - Storage Containers (LP) pattern
    CI Relationship CI
    cmdb_ci_endpoint_block Implement End Point To::Implement End Point From cmdb_ci_storage_volume
    cmdb_ci_cloud_storage_account Contains::Contained by cmdb_ci_storage_volume
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_storage_volume
    cmdb_ci_storage_volume Hosted on::Hosts cmdb_ci_azure_datacenter
    Relationships discovered using the Microsoft Azure - Storage Volume (LP) pattern
    CI Relationship CI
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_storage_volume
    cmdb_ci_storage_volume Hosted on::Hosts cmdb_ci_azure_datacenter
    Relationships discovered using the Microsoft Azure - Sub Account (LP) pattern
    The Microsoft Azure - Sub Account (LP) pattern does not discover any relationships.
    Relationships discovered using the Microsoft Azure - Virtual Machine (LP) pattern
    CI Relationship CI
    cmdb_ci_vm_instance Use End Point To::Use End Point From cmdb_ci_endpoint_vnic
    cmdb_ci_endpoint_vnic Implement End Point To::Implement End Point From cmdb_ci_nic
    cmdb_ci_vm_instance Provisioned From::Provisioned cmdb_ci_compute_template
    cmdb_ci_resource_group Contains::Contained by cmdb_ci_vm_instance
    cmdb_ci_vm_instance Use End Point To::Use End Point From cmdb_ci_endpoint_block
    cmdb_ci_endpoint_block Implement End Point To::Implement End Point From cmdb_ci_storage_volume
    cmdb_ci_storage_volume Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_vm_instance Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_vm_instance Provisioned From::Provisioned cmdb_ci_os_template
    cmdb_ci_os_template Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_availability_set Contains::Contained by cmdb_ci_vm_instance
    Relationships discovered using the Microsoft Azure WebSite (LP) and Microsoft Azure WebSite patterns
    CI Relationship CI
    cmdb_ci_cloud_webserver Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_cloud_webserver Owns::Owned cmdb_ci_ip_address
    cmdb_key_value Reference only cmdb_ci_cloud_webserver
    Relationships discovered using the Azure DataBase (LP) Pattern.
    CI Relationship CI
    cmdb_ci_cloud_database Owns:Owned By cmdb_ci_ip_address
    cmdb_ci_cloud_database Contains::Contained by cmdb_ci_database
    cmdb_ci_cloud_database Hosted On::Hosted cmdb_ci_azure_datacenter
    cmdb_ci_database Provisioned From::Provisioned cmdb_ci_compute_template
    cmdb_ci_database Provisioned From::Provisioned cmdb_ci_cloud_hardware_type
    cmdb_ci_compute_template Hosted On::Hosts cmdb_ci_azure_datacenter
    cmdb_ci_compute_template Hosted On::Hosts cmdb_ci_cloud_hardware_type
    Relationships discovered using the Azure DataBase (LP) pattern extension: Azure SQL Managed Instance license
    CI Relationship CI
    cmdb_ci_cloud_database Runs on::Runs cmdb_ci_serverless_hardware
    cmdb_ci_serverless_hardware Hosted on::Hosts cmdb_ci_azure_datacenter
    cmdb_key_value Reference only cmdb_ci_cloud_database
    Relationships discovered using the Azure - Marketplace LB (LP) pattern
    CI Relationship CI
    Deployed Marketplace Product ​[cmdb_ci_deployed_marketplace_product] Extends from Virtual Machine Object [cmdb_ci_vm_object]
    Deployed Marketplace Product ​[cmdb_ci_deployed_marketplace_product] Hosted on::Hosts Cloud Service Account [cmdb_ci_cloud_sevice_account]
    Deployed Marketplace Product ​[cmdb_ci_deployed_marketplace_product] Hosted on::Hosts Azure Datacenter [cmdb_ci_azure_datacenter]
    Marketplace Product Details [marketplace_product_details] References Deployed Marketplace Product ​[cmdb_ci_deployed_marketplace_product]
    Resource Group [cmdb_ci_resource_group] Contains::Contained by Deployed Marketplace Product ​[cmdb_ci_deployed_marketplace_product]
    Relationships discovered using the Azure - Sub Account (LP) pattern extension: Azure Management Groups
    CI Relationship CI
    Azure Management Group [cmdb_ci_azure_management_group] Contains::Contained by Cloud Service Account [cmdb_ci_cloud_service_account]
    Cloud Organizations [cmdb_ci_cloud_org] Contains::Contained by Azure Management Group [cmdb_ci_azure_management_group]
    Azure Management Group [cmdb_ci_azure_management_group] Contains::Contained by Azure Management Group [cmdb_ci_azure_management_group]
    *Azure Management Group [cmdb_ci_azure_management_group] References Azure Management Group [cmdb_ci_azure_management_group]
    *Only references the direct parent-child management group relationship.

    Events discovered by Discovery during horizontal discovery

    Discovery uses patterns to find events created for Microsoft Azure components. If there are events that indicate the change of state in one of the Microsoft Azure components, it triggers the discovery of Microsoft Azure components using the patterns.

    Table 12. Patterns used for event discovery
    Pattern CI Class
    Azure Application LB Event Cloud Load Balancer [cmdb_ci_cloud_load_balancer]
    Azure Availability Set Event Availability Set [cmdb_ci_availability_set]
    Azure Classic LB Event Cloud Load Balancer [cmdb_ci_cloud_load_balancer]
    Azure DataBase Event Cloud DataBase [cmdb_ci_cloud_database]
    Azure Express Route Circuit Event Cloud Direct Connect [cmdb_ci_cloud_direct_connect]
    Azure Functions Event Cloud Function [cmdb_ci_cloud_function]
    Azure Local Network Gateway Event Virtual Private Gateway [cmdb_ci_virtual_pvt_gateway]
    Azure NAT Gateway Event NAT Gateway [cmdb_ci_nat_gateway]
    Azure Network Event Cloud Network [cmdb_ci_network]
    Azure NIC Event Cloud Mgmt Network Interface [cmdb_ci_nic]
    Azure Private DNS Zone Event DNS Zone [cmdb_ci_dns_zone]
    Azure Public IP Event Cloud Public IP Address [cmdb_ci_cloud_public_ipaddress]
    Azure Resource Group Event Resource Group [cmdb_ci_resource_group]
    Azure Security Group Event Compute Security Group [cmdb_ci_compute_security_group]
    Azure Storage Account Event Cloud Storage Account [cmdb_ci_cloud_storage_account]
    Azure Virtual Machine Event Virtual Machine Instance [cmdb_ci_vm_instance]
    Azure Virtual Network Gateway Connection Event Virtual Network Gateway Connection [cmdb_ci_vpc_gateway_connection]
    Azure Virtual Network Peerings Event Virtual Network Peering [cmdb_ci_vnet_peering]
    Azure VM Scale Set Event Instance Scale Set [cmdb_ci_instance_scale_set]

    Tag information collected by Discovery during horizontal discovery

    When running the patterns, tag information is collected to populate the cmdb_key_value table.​ Each tag is related to a CI that was discovered during the discovery.​ Tag discovery is done in the extension section of each pattern.

    Data collected by Service Mapping during tag-based discovery

    Service Mapping uses tag-based discovery to create application service maps including the Cloud components. The Service Mapping application comes with the following preconfigured CI relationships used for tag-based discovery. These CI relationships are available from the 1.0.68 release on the ServiceNow Store.
    CI Relationship CI
    Configuration Item [cmdb_ci] Hosted on::Hosts Logical Datacenter [cmdb_ci_logical_datacenter]
    Logical Datacenter [cmdb_ci_logical_datacenter] Hosted on::Hosts Cloud Service Account [cmdb_ci_cloud_service_account]