{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":30867,"path":"it-operations-management/health-log-analytics/il-connector-hla-azure-la-fields.md","title":"Microsoft Azure Log Analytics integration configuration fields","bundle":null,"doc_type":null,"release":"australia","body":"\n# Microsoft Azure Log Analytics integration configuration fields\n\nDescription of the fields on the Microsoft Azure Log Analytics integration configuration forms for Health Log Analytics.\n\nFor the Microsoft Azure Log Analytics integration setup procedure, see [Set up a Microsoft Azure Log Analytics integration for Health Log Analytics](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/health-log-analytics/il-connector-hla-azure-la.md).\n\n<table id=\"table_pxx_hz1_42c\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nIntegration Name\n\n</td><td>\n\nUnique name of this integration. For example: My Azure Log Analytics integration. This field is required.**Note:** When you fill in this field, the generic name displayed on the form adjusts automatically to match the name you entered.\n\n</td></tr><tr><td>\n\nExecute on\n\n</td><td>\n\nOption to select whether to use a specific MID Server or a MID Server cluster. This field is required.\n\n</td></tr><tr><td>\n\nMID server name\n\n</td><td>\n\n\\(Only when the **Execute on** field is set to Specific MID Server\\)\n\n MID Server to which log data from Microsoft Azure Log Analytics is pulled. This field is required.**Note:**\n\n-   You can select only MID Servers that support basic authentication. MID Servers that support mTLS are not listed.\n-   The default maximum number of integrations streaming logs to a single MID Server is 10. You can modify this number in the MID Server properties.\n-   If log ingestion is not enabled for the selected MID Server, Health Log Analytics enables it automatically.\n\n</td></tr><tr><td>\n\nMID MID Server Cluster\n\n</td><td>\n\n\\(Only when **Execute on** is set to Specific MID Server cluster.\\)\n\nThe MID Server cluster to which the log data is pulled. This field is required.The data input runs on a single MID Server in the cluster until that MID Server fails. The system then moves all the data input tasks to the next available MID Server in the cluster according to the configured order.\n\n**Note:**\n\n-   Health Log Analytics supports only failover MID Server clusters. In these clusters, multiple MID Servers are grouped together for failover protection. When selecting a cluster from the data input or integration form, the MID Server clusters list displays only failover clusters.\n-   Log ingestion must be enabled for each MID Server in the cluster. If log ingestion is not enabled for the active MID Server, Health Log Analytics enables it automatically.\n-   The default maximum number of data inputs or integrations streaming logs to a single MID Server is 10. A cluster passes capacity validation if it contains at least one MID Server with fewer than 10 data inputs or integrations running on it. This is true even when that MID Server is down.\n\nFor more information about MID Server clusters, see [Configure a MID Server cluster](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/t_ConfigureAMIDServerCluster.md).\n\n</td></tr><tr><td>\n\nService instance\n\n</td><td>\n\nThe service instance \\(formerly the application service\\) to which to bind the log data. This field is required.\n\n</td></tr><tr><td>\n\nData source\n\n</td><td>\n\nThe source of the log data that the integration pulls to your ServiceNow instance: Azure Log Analytics. This field is read-only.\n\n</td></tr><tr><td>\n\nDescription\n\n</td><td>\n\nOption to add a brief description of the integration to help identify it.\n\n</td></tr></tbody>\n</table><table id=\"table_gpq_jz1_42c\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nRedirect url\n\n</td><td>\n\nThe redirect URL of the access log application. This field is required. The URL refers to the Microsoft Azure redirect\\_uri authorization property. For more information, see the Authorization code URL \\(GET request\\) section in the [Microsoft Azure documentation](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/access-api).\n\n</td></tr><tr><td>\n\nAuthentication method\n\n</td><td>\n\nThe credentials used to access Microsoft Azure resources. This field is required.If no credentials exist, select **Create new Azure Service Principal credential**. Create a credential by filling in the fields and then selecting **Submit**. For information on the **Tenant ID**, **Client ID**, and **Secret key** fields, refer to the [Microsoft Azure documentation](https://learn.microsoft.com/en-us/azure/?product=popular). When you have created a credential, you can select it from the drop-down list.\n\n</td></tr><tr><td>\n\nWorkspace ID\n\n</td><td>\n\nThe Customer ID used to call the Microsoft Azure Log Analytics REST API. This field is required.\n\n</td></tr><tr><td>\n\nTable name\n\n</td><td>\n\nThe name of the table in Microsoft Azure Log Analytics where the data input fetches the log data. For more information, see the View table information section in the [Microsoft Azure documentation](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/log-analytics-tutorial). This field is required.\n\n</td></tr><tr><td>\n\nEvent time property name\n\n</td><td>\n\nThe Microsoft Azure Log Analytics field in which to detect the event time. This field is required.\n\n</td></tr></tbody>\n</table><table id=\"table_cyy_kz1_42c\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nEvent Processor workers\n\n</td><td>\n\nThe number of concurrent event processing workers, where each worker processes a batch of events independently.\n\n</td></tr><tr><td>\n\nWorkers queue size\n\n</td><td>\n\nThe queue size of the Event Processor workers.\n\n</td></tr><tr><td>\n\nSub sample drop ratio\n\n</td><td>\n\nThe number of events to batch together, out of which one will be discarded. This setting is used to reduce the number of fetched events.\n\n</td></tr><tr><td>\n\nSub sample receive ratio\n\n</td><td>\n\nThe number of events to batch together, out of which all but one will be discarded. This setting is used to decrease the number of received events.\n\n</td></tr><tr><td>\n\nMax documents per query\n\n</td><td>\n\nThe highest number of rows retrieved in each query.\n\n</td></tr><tr><td>\n\nColumns to select\n\n</td><td>\n\nComma-separated list of column names to return.**Note:** This field is ignored when you provide a custom query.\n\n</td></tr><tr><td>\n\nCharacter encoding\n\n</td><td>\n\nThe character encoding for this data input.\n\n</td></tr><tr><td>\n\nSleep interval \\(seconds\\)\n\n</td><td>\n\nThe interval, in seconds, to wait before querying again after a query has returned no events.\n\n</td></tr><tr><td>\n\nPolling interval\n\n</td><td>\n\nThe interval, in seconds, to wait before polling for new events.\n\n</td></tr><tr><td>\n\nDrop if queue is full\n\n</td><td>\n\nOption to discard logs if there is a load on the MID Server.\n\n</td></tr><tr><td>\n\nLog Query\n\n</td><td>\n\nOption to define your own Log Analytics query. This field overrides the values configured in the other query settings fields.**Note:** If this field is empty, Health Log Analytics generates the query using the values set in the other fields.\n\nFor your custom query, use the following JSON format:\n\n`{\"query\": \"query | where TimeGenerated > %s | take 500\"}`\n\nFor example:\n\n```\n{\n\"query\":\"ContainerLog\n                    | where LogEntry contains 'cartservice'\n                    | where TimeGenerated > %s\n                    | take 500\",\n\"workspaces\": [\"defaultworkspace-3ab145ff-f9cd-433f-8533-d1b1ee24aee6-eus\"],\n\"project\": [\"TimeGenerated\", \"LogEntry\", \"LogEntrySource\"]\n}\n```\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Integration configuration fields](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown)\n\n"}}