File tree Expand file tree Collapse file tree 3 files changed +37
-17
lines changed Expand file tree Collapse file tree 3 files changed +37
-17
lines changed Original file line number Diff line number Diff line change @@ -31,14 +31,18 @@ destination. Data is sent according to a query's interval.
31
31
32
32
### Webhook
33
33
34
- Each time a scheduled query runs, results are sent via webhook to your configured destination URL.
35
- To use Webhook logging for scheduled queries, run Fleet with these environment variables:
36
-
37
- ```
38
- FLEET_OSQUERY_RESULT_LOG_PLUGIN="webhook"
39
- FLEET_WEBHOOK_STATUS_URL="<target_status_url>"
40
- FLEET_WEBHOOK_RESULT_URL="<target_result_url>"
41
- ```
34
+ Results from scheduled queries can be written to an arbitrary external webhook of your choosing.
35
+ First, follow the [ configuration docs] ( https://fleetdm.com/docs/deploying/configuration#webhook ) .
36
+ Then in the UI:
37
+
38
+ 1 . Navigate to the ** Queries** page, select the relevant team, and click ** Manage automations**
39
+ 2 . In the modal that opens, confirm that you see "Log destination: Webhook", and when you hover over
40
+ "Webhook", you see "Each time a query runs, the data is sent via webhook to:
41
+ <target_result_url>"
42
+ 3 . Select the queries that you want to send data to this webhook
43
+ 4 . Click ** Save**
44
+
45
+ Results from the selected scheduled queries will be sent to the configured results URL. * Not configurable per-query.*
42
46
43
47
### Amazon Kinesis Data Firehose
44
48
Original file line number Diff line number Diff line change @@ -44,15 +44,7 @@ Note that Firehose logging has limits [discussed in the documentation](https://d
44
44
45
45
## Webhook
46
46
47
- Results from scheduled queries are written to an arbitrary external webhook of your choosing. To use, run Fleet with the
48
- following environment variables set:
49
-
50
- ```
51
- FLEET_OSQUERY_RESULT_LOG_PLUGIN="webhook"
52
- FLEET_WEBHOOK_STATUS_URL="<target_status_url>"
53
- FLEET_WEBHOOK_RESULT_URL="<target_result_url>"
54
- ```
55
-
47
+ See [ webhook configuration docs] ( https://fleetdm.com/docs/deploying/configuration#webhook )
56
48
57
49
## Snowflake
58
50
Original file line number Diff line number Diff line change @@ -1251,6 +1251,30 @@ to zero will retain all logs. _Note_ max_age may still cause them to be deleted.
1251
1251
max_backups: 0
1252
1252
` ` `
1253
1253
1254
+ # # Webhook
1255
+
1256
+ To use webhook logging for query results, the following two Fleet config values must *both* be set :
1257
+
1258
+ # ## Set log method to 'webhook' by
1259
+ - Command line flag : ` --osquery_result_log_plugin="webhook"` ,
1260
+ - Environment variable : ` FLEET_OSQUERY_RESULT_LOG_PLUGIN="webhook"` , or
1261
+ - Config file :
1262
+ ` ` ` yaml
1263
+ osquery:
1264
+ result_log_plugin: "webhook"
1265
+ ` ` `
1266
+
1267
+ and
1268
+
1269
+ # ## Set the desired result URL by
1270
+ - Command line flag : ` --webhook_result_url="<target_result_url>"` ,
1271
+ - Environment variable : ` FLEET_WEBHOOK_RESULT_URL="<target_result_url>"` , or
1272
+ - Config file :
1273
+ ` ` ` yaml
1274
+ webhook:
1275
+ result_url: "<target_result_url>"
1276
+ ` ` `
1277
+
1254
1278
# # Firehose
1255
1279
1256
1280
# ## firehose_region
You can’t perform that action at this time.
0 commit comments