Service Graph Connector for Microsoft Azure
Use the Service Graph Connector for Microsoft Azure to pull data from Microsoft Azure into your CMDB.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, 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.
Supported versions
Supported ServiceNow versions:- Xanadu
- Yokohama
- Zurich
- Australia
Use cases
- Visibility into cloud resources, relationships, and state.
- Service ITAM/SAM outcomes through deep discovery of applications.
Configuring a connection for the connector
Important information for upgrading Service Graph Connector for Microsoft Azure
After you upgrade to the latest version of the Service Graph Connector for Microsoft Azure, you must run a full data load.
CMDB integrations dashboard
The Integration Commons for CMDB store app provides a dashboard with a central view of the status, processing results, and processing errors of all installed integrations. You can see metrics for all integration runs. You can filter the view to a specific CMDB integration, a specific time duration, or a specific integration run. For more details about monitoring Microsoft Azure integrations in the CMDB Integrations Dashboard, see Using the CMDB Integrations Dashboard.
Data mapping
Data from the Azure data sources is mapped and transformed into the ServiceNow CMDB Configuration Item (CI) class definitions using the Robust Transform Engine (RTE). Data is inserted into the ServiceNow® CMDB using the Identification and Reconciliation Engine (IRE).
When you complete setting up the connection, you can configure the integration to periodically pull data from Azure. The data is loaded into staging tables and then inserted into the target tables.
| Data source | Staging table | Target tables |
|---|---|---|
| SG-Azure Subscriptions | SG Azure Subscriptions [sn_sg_azure_integ_subscriptions] | |
| SG-Azure DatacentersSG-Azure Datacenter Updation | SG-Azure Locations [sn_sg_azure_integ_locations]SG-Azure Datacenter Updation [sn_sg_azure_integ_datacenter_updation] | |
| SG-Azure Resource Group | SG-Azure Resource Group [sn_sg_azure_integ_resource_groups] | |
| SG-Azure Availability Zone | SG-Azure Availability Sets [sn_sg_azure_integ_availability_sets] | |
| SG-Azure Storage Volume | SG-Azure Storage Volume [sn_sg_azure_integ_storage_volume] | |
| SG-Azure Load Balancers | SG-Azure Load Balancers [sn_sg_azure_integ_load_balancers] | |
| SG-Azure Network | SG-Azure Network [sn_sg_azure_integ_network] | |
| SG-Azure Public IP Address | SG-Azure Public IP Address [sn_sg_azure_integ_public_ip_address] | |
| SG-Azure Security Group | SG-Azure Security Group [sn_sg_azure_integ_security_group] | |
| SG-Azure Storage Accounts | SG-Azure Storage Accounts [sn_sg_azure_integ_storage_accounts] | |
| SG-Azure Hardware Template | SG-Azure Hardware Template [sn_sg_azure_integ_hw_template] | |
| SG-Azure Virtual Machines | SG-Azure Virtual Machine [sn_sg_azure_integ_virtual_machine] | |
| SG-Azure Network Interface | SG-Azure Network Interface [sn_sg_azure_integ_network_interface] | |
| SG-Azure SQL | SG-Azure SQL [sn_sg_azure_integ_sql] | |
| SG-Azure VM Config Data | SG-Azure VM Config Data [sn_sg_azure_integ_vm_config_data] Hinweis: The SG-Azure VM Config Data import is deactivateddisabled for delta pulls. |
|
| SG-Azure Functions | SG-Azure Functions [sn_sg_azure_integ_functions] | |
| SG-Azure Generic Resources | SG-Azure Generic Resources [sn_sg_azure_integ_generic_resources] Hinweis: The SG-Azure Generic Resources data source imports data for generic resources that aren't tracked by other data sources. |
|
| SG-Azure Scale Sets | SG-Azure Scale Sets [sn_sg_azure_integ_scale_sets] | |
| SG-Azure Scale Sets VMs | SG-Azure Scale Sets VMs [sn_sg_azure_integ_scale_sets_vms] | |
| SG-Azure Software | SG-Azure Software [sn_sg_azure_integ_software] Hinweis: The SG-Azure Software data source imports the software data from the ConfigurationData table in the Log Analytics workspace of Azure. The SG-Azure Software import is set to inactive by default. |
When the Software Asset Management (SAM) application isn't installed: When the SAM application is installed: |
| SG-Azure Server Config Data | SG-Azure Server Config Data [sn_sg_azure_integ_server_config_data] | |
| SG-Azure Software Remove | SG-Azure Software Remove [sn_sg_azure_integ_software_remove] The SG-Azure Software Remove import is set to inactive by default. |
When the SAM application isn't installed: When the SAM application is installed: |
| SG-Azure TCP | SG-Azure TCP [sn_sg_azure_integ_tcp] Hinweis: The SG-Azure TCP data source imports the TCP and processes data from the VMConnection and VMProcess tables in the Log Analytics workspace of Azure. To populate the tables, you must first enable the VM insights feature in the Azure portal. For more information, see Enabling VM insights for collecting Azure data. |
TCP Connection Running Process |
| SG-Azure Hardware Template Updation | Hardware templates [sn_sg_azure_integ_hardware_templates] | |
| SG-Azure HW Consolidation | SG-Azure HW Consolidation [sn_sg_azure_integ_hw_consolidation] | |
| SG-Azure Run Command | SG-Azure Run Command [sn_sg_azure_integ_run_command] |
No data created |
| SG-Azure Get Run Command | SG-Azure Get Run Command [sn_sg_azure_integ_get_run_command] |
TCP Connection Running Process |
| SG-Azure Kubernetes Cluster | SG-Azure Kubernetes Cluster [sn_sg_azure_integ_kubernetes_cluster] |
For more information on where data is saved when pulling data from Azure, see CMDB classes targeted in Service Graph Connector for Microsoft Azure and Supported Microsoft Azure resource types.
You can use the IntegrationHub ETL app to view the data maps. See IntegrationHub ETL for more information.
- The Service Graph Connector for Microsoft Azure utilizes the Service Graph Resource Inclusion Whitelist [sn_cmdb_int_util_service_graph_resource_inclusion_whitelist] table to differentiate between generic resources and other supported
resource types.
The connector first populates all supported resources in the Service Graph Resource Inclusion Whitelist [sn_cmdb_int_util_service_graph_resource_inclusion_whitelist] table. These resources, categorized under their respective supported resource types, have specific data sources designated for ingestion within the connector. When the SG-Azure Generic Resources data source is executed and retrieves unsupported resource types, they are added to the Service Graph Resource Inclusion Whitelist [sn_cmdb_int_util_service_graph_resource_inclusion_whitelist] table and categorized as generic.
- The SG-Azure Hardware Template Updation and SG-Azure HW Consolidation import schedules replace the SG-Azure Hardware Template import schedule from the Service Graph Connector for Microsoft Azure 1.12.0 version. The SG-Azure Hardware Template Updation and SG-Azure HW Consolidation data sources fetch only the data of the hardware templates that are used for VMs in Azure, instead of fetching all hardware templates.
- The SG-Azure SQL data source populates the microsoft.dbformysql/flexibleservers and microsoft.dbforpostgresql/flexibleservers resource types in the Cloud
Database [cmdb_ci_cloud_database] table instead of the Cloud Resource [cmdb_ci_cmp_resource] table from the Service Graph Connector for Microsoft Azure 1.14.0 version.
After upgrading to version 1.14.0, run a full data load to migrate all active flexible servers from the Cloud Resource [cmdb_ci_cmp_resource] table to the Cloud Database [cmdb_ci_cloud_database] table.
- All data sources except SG-Azure Scale Sets VMs are migrated from Azure Resource Manager (ARM) APIs to Resource Graph APIs for a full data load from the Service Graph Connector for Microsoft Azure 1.14.0 version. Microsoft Azure doesn't support uniform orchestration-type Scale Set VMs on Resource Graph APIs.
Event-based discovery
The Service Graph Connector for Microsoft Azure works with event-based discovery. Events that are pulled from Azure can create and update CIs that were brought by the Service Graph Connector for Microsoft Azure.
Additional resource
How do I configure the Azure Service Graph Connector?How do I configure the Azure Service Graph Connector?