You can trigger an Azure Function directly from a scheduled search or metrics monitor by configuring a Webhook Connection in Sumo Logic.
For example, you can create a scheduled search that triggers an Azure function when an administrator changes a user’s permissions. This function can then update a database to document the changes for audit purposes.
Create an Azure function
First, create an HTTP-triggered Azure function. For more information, see: https://docs.microsoft.com/en-us/azure/azure-functions/functions-bindings-http-webhook
- Create an Azure function using the template HttpTrigger-Powershell.
- Copy and paste code of the Azure function into the code field. The following example is an HTTP-triggered PowerShell function:
$requestBody = Get-Content $req -Raw | ConvertFrom-Json "Webhook Triggered" $requestBody.text $requestBody.raw $requestBody.num $requestBody.agg Out-File -Encoding Ascii -FilePath $res -inputObject "Hello Sumo Logic, from Azure Function"
- Click Save.
- Copy the function URL, as you will need it in the next section.
Create a Webhook connection
Configure the Webhook connection to trigger the Azure function.
- Go to Manage Data > Settings > Connections.
- On the Connections page click Add.
- Select Azure Functions.
- In the Create Connection dialog, configure:
- Name. Enter the name of the connection.
- (Optional) Description, enter a description for the connection.
- URL. Enter the function URL for the endpoint from the previous section.
- (Optional) Authorization Header, enter an authorization header, which may include an authorization token.
- (Optional) Custom Headers, enter up to five comma separated key-value pairs.
- Payload. Enter a JSON object in the format required. For details on variables that can be used as parameters within your JSON object, see Webhook Payload Variables.
- Click Test Connection. If the connection is made, you will see a 200 OK response message.
- Click Save.
Create a scheduled search
Now, create a scheduled search to trigger the Webhook connection. The following is an example configuration.
- Create a search query and click Save As below the search field.
- Click Schedule this search.
- Run Frequency. Select Hourly.
- Time range for scheduled search. Select Last 60 Minutes.
- Alert Condition. Select Send notification only if the condition below is satisfied.
- Number of results. Enter Greater than >0.
- Alert Type. Select Webhook to upload search results to your connection.
- Webhook. Select the Webhook you created in the previous section.
- Customize Payload (Optional). If needed, select the check box and customize the payload for this search. If you’d like to use the default payload, leave this as-is.
- Click Save.
Create a metrics monitor
To trigger the Webhook connection, you can also use a metrics monitor. For instructions, see Metrics Monitors and Alerts.