Configure Azure KQL Log Analytics inputs for the Splunk Add on for Microsoft Azure - splunk/splunk-add-on-microsoft-azure GitHub Wiki

Warning

This functionality has moved to the Splunk Add-on for Microsoft Cloud Services.

Before you enable inputs, complete the previous steps in the configuration process:

Configure your inputs on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder. You can configure inputs using Splunk Web, which is a best practice, or by using the configuration files.

Data Collected

Results from a KQL query.

Required Microsoft API Permissions

API Permissions
Log Analytics API (Application) Data.Read

Configure inputs using Splunk Web

Configure your inputs using Splunk Web on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder.

  1. In the Splunk Add-on for Microsoft Azure, click Inputs.
  2. Click Create New Input and then select Azure KQL Log Analytics.
  3. Enter the Name, Interval, Index, Azure App Account, Tenant ID, Environment, and other parameters using the information in the input parameter table below.

Configure inputs using configuration files

Configure your inputs using the configuration files on the Splunk platform instance responsible for collecting data for this add-on, usually a heavy forwarder.

  1. Create or modify a file named inputs.conf under $SPLUNK_HOME/etc/apps/TA-MS-AAD/local.
  2. Add the following stanza:
[azure_kql://<input_stanza_name>]
azure_app_account = <value>
environment = <value>
index = <value>
index_stats = <value>
interval = <value>
kql_query = <value>
source_type = <value>
tenant_id = <value>
workspace_id = <value>
  1. Save and restart the Splunk platform.

Verify that the value listed for azure_app_account matches the account entry in ta_ms_aad_account.conf.

Input Parameters

Each attribute in the following table corresponds to a field in Splunk Web.

Attribute Corresponding field in Splunk Web Description
[azure_kql://input_stanza_name] Name A friendly name for your input.
azure_app_account Azure Account The Azure App account from which you want to gather data.
environment Environment The Azure environment. Valid options are public and gov.
kql_query KQL Query The KQL query to run. Query results will be indexed.
Example: `AzureActivity
workspace_id Workspace ID The Log Analytics workspace ID.
index_stats Index KQL Statistics If set to 1 (checked), the input will index statistics about the KQL query. The term :stats will be appended to the specified sourcetype for the statistical data.
tenant_id Tenant ID The Azure Active Directory Tenant ID (a.k.a. Directory ID)
source_type Subscription Sourcetype The sourcetype to use for this input.
interval Interval The number of seconds to wait before the Splunk platform runs the command again.
index Index The index in which to store Azure data.

⚠️ **GitHub.com Fallback** ⚠️