Service Graph Connector for Microsoft Azure properties

Service Graph Connector for Microsoft Azure properties control the behavior of the connector.

Connection properties

These connection properties are available for the Service Graph Connector for Microsoft Azure hardware connections.

Note: To open the Service Graph Connection Properties [sn_cmdb_int_util_service_graph_connection_property] table for the connector, navigate to All > Service Graph Connectors > Azure > Connections, and select the hardware connection name. The connection properties are displayed in the Service Graph Connection Properties related list.

<table id=“table_sbd_lbl_c3c”><thead><tr><th>

Property

</th><th>

Description

</th></tr></thead><tbody><tr><td>

vmGraphQuery

</td><td>

Specify the resource graph query on which the Run command should be executed. By default, the Run command is executed on all running VMs.- Type: string - Default value: empty

</td></tr><tr><td>

filter_databricks

</td><td>

This property is used to filter Azure Databricks CIs using the Vendor tag provided by Azure. Azure Databricks virtual machines (VMs), Network Interface Controllers (NICs), and storage volumes (collectively called Azure Databricks CIs) have the value of the Vendor tag set to Databricks.

Starting with the Service Graph Connector for Microsoft Azure 1.14.0 version, all Azure Databricks CIs that have the value of the Vendor tag set to Databricks are filtered out from discovery during a full data load.

During delta loads, set the value of the insert_short_lived_vms custom system property to false to filter Azure Databricks CIs that are marked as retired during discovery (see Custom system properties). Additionally, for each Hardware connection, set the filter_databricks connection property to true.

• Type: true | false

• Default value: false

</td></tr><tr><td>

last_full_load_date

</td><td>

Enable this property to run a delta data load on Hardware connections. When this property is deactivated, the next scheduled import automatically runs a full data load.​Note: Enable the SG - Azure Hardware Clear Last success imports time scheduled import job and set the run frequency to schedule regular full data loads. The default run frequency is daily. When this scheduled import job is enabled, the last_full_load_date property is deactivated.

</td></tr><tr><td colspan=“2”>

Properties used for the Run command

</td></tr><tr><td>

scriptsContainerName

</td><td>

Enter the name of the container where the .sh and .ps1 files are uploaded in Azure.- Type: string - Default value: empty

</td></tr><tr><td>

storageAccountName

</td><td>

Enter the name of the storage account where the containers are created.- Type: string - Default value: empty

</td></tr><tr><td>

storageSubsription

</td><td>

Enter the subscription ID where the storage account is created.- Type: string - Default value: empty

</td></tr><tr><td>

storageContainerName

</td><td>

Enter the name of the container where the results of the commands are to be stored.- Type: string - Default value: empty

</td></tr><tr><td>

storageResourceGroup

</td><td>

Enter the resource group of the storage account.- Type: string - Default value: empty

</td></tr><tr><td>

powershellScriptURI

</td><td>

Enter the URI of the .ps1 file that is to be run on Windows machines.- Type: URI - Default value: empty

</td></tr><tr><td>

shellScriptURI

</td><td>

Enter the URI of the .sh file that is to be run on Linux machines.- Type: URI - Default value: empty

</td></tr><tr><td>

lookback_time_in_days

</td><td>

This property is used for record removal. Time in days in which the sys_object_source records are queried for the deletion of CIs. The value is automatically updated to 15 after the initial run.Set the value of this property to empty to include all the older records populated by SG-Azure as removal candidates for the Integration Commons record removal API.

Note: Do not modify this property if the value is empty.

• Type: integer

• Default value: empty

</td></tr></tbody> </table>For more information about the Run command for the Service Graph Connector for Microsoft Azure, see Instructions for setting up Run Command in Service Graph Connector for Azure [KB2001668]

Default system properties

These default system properties are available for Service Graph Connector for Microsoft Azure.

Note: To open the System Properties [sys_properties] table, enter sys_properties.list in the navigation filter.

<table id=“table_w4t_nrm_jzb”><thead><tr><th>

Property

</th><th>

Description

</th></tr></thead><tbody><tr><td>

api_retry_max

</td><td>

Enter the maximum retry limit for a Microsoft Azure API call made from the data sources within the connector.- Type: integer - Default value: 3 - Location: System Property [sys_properties] table

</td></tr><tr><td>

api_retry_max_without_backoff

</td><td>

Enter the maximum retry limit for a Microsoft Azure API call made from the data sources within the connector, without using exponential backoff to increase the waiting time between consecutive retries.- Type: integer - Default value: 3 - Location: System Property [sys_properties] table

</td></tr><tr><td>

azure_full_pull_partition_size

</td><td>

Set the partition size for Azure full data pull. This property determines the number of subscriptions that each partition processes. The value must be set to a numeric value greater than 0.- Type: integer - Default value: null - Location: System Property [sys_properties] table

Note: If no value is specified, the property value is determined based on the number of active threads in the instance.

See Set partition size for parallel loading-enabled Azure accounts.

</td></tr><tr><td>

delta_grace_time

</td><td>

Enter the additional time period in hours added to the current delta pull period when fetching incremental changes.- Type: integer - Default value: 0 - Location: System Property [sys_properties] table

</td></tr><tr><td>

delta_page_size

</td><td>

Enter the page size, that is, the maximum number of records fetched per page in a data pull for the data sources within the connector.- Type: integer - Default value: 500 - Location: System Property [sys_properties] table

</td></tr><tr><td>

is_delta_sync_enabled

</td><td>

Set the property to false to deactivate delta synchronization.- Type: true | false - Default value: false - Location: System Property [sys_properties] table

See Configuring data synchronization in Service Graph Connector for Microsoft Azure.

</td></tr><tr><td>

LDC_status

</td><td>

Set the property to true to enable populating the passive status of an Azure datacenter (also known as a logical datacenter) in the Comments attribute of the Azure Datacenter [cmdb_ci_azure_datacenter] CI class when the regionType attribute is Logical or the service account for the datacenter is deactivated .- Type: true | false - Default value: false - Location: System Property [sys_properties] table

</td></tr><tr><td>

load_balancer_page_limit

</td><td>

Enter the maximum number of records per page to be fetched in a delta pull for the SG-Azure Load Balancers data source.- Type: integer - Default value: 500 - Location: System Property [sys_properties] table

</td></tr><tr><td>

maximum_delta_total_period

</td><td>

Enter the maximum time period in days preceding the current run time during delta pull.- Type: integer - Default value: 7 - Location: System Property [sys_properties] table

</td></tr><tr><td>

maximum_delta_window_period

</td><td>

Enter the maximum time duration in hours for each API call to repeat within the total delta period during delta pull.- Type: integer - Default value: 24 - Location: System Property [sys_properties] table

</td></tr><tr><td>

network_interface_page_limit

</td><td>

Enter the maximum number of records per page to be fetched in a delta pull for the SG-Azure Network Interface data source.- Type: integer - Default value: 500 - Location: System Property [sys_properties] table

</td></tr><tr><td>

pull_disabled_subscriptions

</td><td>

Set the property to false to deactivate the import of resources associated with deactivated Azure subscriptions.- Type: true | false - Default value: true - Location: System Property [sys_properties] table

</td></tr><tr><td>

save_rest_response_as_attachment

</td><td>

Set the property to true to save the response from Azure Resource Graph API calls as an attachment and read the data. Set this value to true if more than 10MB data is returned from Resource Graph API calls.- Type: true | false - Default value: false - Location: System Property [sys_properties] table

</td></tr><tr><td>

security_group_page_limit

</td><td>

Enter the maximum number of records per page to be fetched in a delta pull for the SG-Azure Security Group data source.- Type: integer - Default value: 500 - Location: System Property [sys_properties] table

</td></tr><tr><td>

software_page_limit

</td><td>

Enter the maximum number of records fetched per page when importing software data through the SG-Azure Software data source.- Type: integer - Default value: 5000 - Location: System Property [sys_properties] table

</td></tr><tr><td>

tcp_and_process_page_limit

</td><td>

Enter the maximum number of records fetched per page when importing TCP and running process data through the SG-Azure TCP data source.- Type: integer - Default value: 1000 - Location: System Property [sys_properties] table

</td></tr><tr><td>

tcp_time_period

</td><td>

Enter the time period in hours during which TCP and running process data is imported through the SG-Azure TCP data source.- Type: integer - Default value: 1 - Location: System Property [sys_properties] table

</td></tr><tr><td>

vm_power_state_page_limit

</td><td>

Enter the maximum number of records fetched per page when importing the power state of VMs through the SG-Azure VM Config Data data source.- Type: integer - Default value: 1000 - Location: System Property [sys_properties] table

</td></tr><tr><td>

sn_cmdb_ci_class.use_single_cloud_os_image

</td><td>

Set this property to true to import Cloud OS Image data to the Cloud Image [cmdb_ci_cloud_os_image] table. When this property is set to false, Cloud OS Image data is imported to the Image [cmdb_ci_os_template] table.For more information, see the Service Graph Connector For Azure - Cloud OS Image model [KB2828502] article in the Now Support Knowledge Base.

• Type: true | false

• Default value: false

• Location: System Property [sys_properties] table

</td></tr></tbody> </table>## Custom system properties

You can create these custom system properties for the Service Graph Connector for Microsoft Azure. These properties must be created in the Service Graph Connector for Microsoft Azure application scope. The custom properties that you create are listed in the System Properties [sys_properties] table.

For more information about creating custom system properties, see Add a system property.

<table id=“table_r43_g5k_c3c”><thead><tr><th>

Property

</th><th>

Description

</th></tr></thead><tbody><tr><td>

sn_sg_azure_integ.network_page_limit

</td><td>

Set the maximum number of records per page to be fetched for the SG-Azure Network data source.- Type: integer - Default value: 100

</td></tr><tr><td>

sn_sg_azure_integ.insert_short_lived_vms

</td><td>

Set the property to false to filter out Azure Databricks CIs during delta loads.- Type: true | false - Default value: true - Location: System Property [sys_properties] table

</td></tr><tr><td>

sn_sg_azure_integ.sg_azure_generic_resource_type_dynamic_create

</td><td>

Set the value to true to add new resource types to the Service Graph Resource Inclusion Whitelist [sn_cmdb_int_util_service_graph_resource_inclusion_whitelist] table.- Type: true | false - Default value: false - Location: System Property [sys_properties] table

</td></tr></tbody> </table>## Related content

Data mapping for Service Graph Connector for Microsoft Azure

CMDB classes targeted in Service Graph Connector for Microsoft Azure

Parent Topic:Service Graph Connector for Microsoft Azure reference