Humio
Humio Pack.#
This Integration is part of theIntegration with Humio
#
Configure Humio on Cortex XSOAR- Navigate to Settings > Integrations > Servers & Services.
- Search for Humio.
- Click Add instance to create and configure a new integration instance.
Parameter | Description | Required |
---|---|---|
url | Humio URL | True |
API-key | User API token | True |
insecure | Trust any certificate (not secure) | False |
proxy | Use system proxy settings | False |
queryParameter | Query to use to fetch incidents | False |
queryRepository | Fetch incidents from repository | False |
queryStartTime | Fetch incidents from | False |
queryTimeZoneOffsetMinutes | TimeZoneOffset in Minutes | False |
isFetch | Fetch incidents | False |
incidentType | Incident type | False |
- Click Test to validate the URLs, token, and connection.
#
Obtaining an API keyGo to https://your-humio/settings and copy the API token. Example https://cloud.humio.com/settings
#
Fetch incidentsThe parameters used for fetch-incidents are only used if you want to use the fetch incidents feature. It is recommended to use alerts and notifiers in Humio to send this data to XSOAR via a webhook notifier instead. You can read more about the supported time-formats for backfilling here.
#
CommandsYou can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
#
humio-queryQuery the data from Humio
#
Base Commandhumio-query
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to search | Required |
queryString | Query string to use | Required |
start | Relative or absolute (epoch) | Optional |
end | Relative or absolute (epoch) | Optional |
isLive | Answer with true, 1, t, y or yes | Optional |
timeZoneOffsetMinutes | TimeZoneOffset in Minutes (default 0) | Optional |
arguments | Additional arguments | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Query | Unknown | Query output |
#
Command Example!humio-query repository=sandbox queryString="foo=bar" start=24h end=now isLive=false
#
Context Example#
Human Readable Output#
Humio Query Results
#repo #type @id @rawstring @session @timestamp @timezone bar foo sandbox_Szpj6CNb6h7eWK1ZI09D9HFk kv hgXrSjcMWB08aJW40hfNUONL_3_2_1588676868 foo=bar bar=foo c12af55f-069d-43eb-840f-ff08fd11f685 1588676868908 Z foo bar sandbox_Szpj6CNb6h7eWK1ZI09D9HFk kv hgXrSjcMWB08aJW40hfNUONL_3_1_1588676850 foo=bar c12af55f-069d-43eb-840f-ff08fd11f685 1588676850226 Z bar
#
humio-query-jobIssue a query job to Humio
#
Base Commandhumio-query-job
#
InputArgument Name | Description | Required |
---|---|---|
queryString | Query string to use | Required |
start | Relative or absolute (epoch) | Optional |
end | Relative or absolute (epoch) | Optional |
repository | Repository to use | Required |
isLive | Is it live? | Optional |
timeZoneOffsetMinutes | Timezone offset in Minutes | Optional |
arguments | Additional Arguments | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Job | Unknown | Query Job outputs |
#
Command Example!humio-query-job queryString="foo=bar" repository=sandbox
#
Context Example#
Human Readable Output#
Humio Query Job
id queryOnView 1-1feyl7ulm_fmWhWmLhkPkWxZ <M:foo=bar>
#
humio-pollIssue poll command to Humio
#
Base Commandhumio-poll
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
id | Id to poll for | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Result | Unknown | Poll results |
Humio.Result.cancelled | Unknown | If it was cancelled |
Humio.Result.events | Unknown | Events in the poll |
Humio.Result.done | Unknown | If its done |
Humio.Result.metaData | Unknown | MetaData from the poll |
Humio.Result.job_id | String | Humio Job id the results came from |
#
Command Example!humio-poll repository=sandbox id=1-mJg87kWn247FiYFpsnwZcx9G
#
Context Example#
Human Readable Output#
Humio Poll Result
#repo #type @id @rawstring @session @timestamp @timezone bar foo sandbox_Szpj6CNb6h7eWK1ZI09D9HFk kv hgXrSjcMWB08aJW40hfNUONL_3_2_1588676868 foo=bar bar=foo c12af55f-069d-43eb-840f-ff08fd11f685 1588676868908 Z foo bar sandbox_Szpj6CNb6h7eWK1ZI09D9HFk kv hgXrSjcMWB08aJW40hfNUONL_3_1_1588676850 foo=bar c12af55f-069d-43eb-840f-ff08fd11f685 1588676850226 Z bar
#
humio-delete-jobIssue a job delete command to Humio
#
Base Commandhumio-delete-job
#
InputArgument Name | Description | Required |
---|---|---|
id | ID of the job to delete | Required |
repository | Repository to use | Required |
#
Context OutputThere is no context output for this command.
#
Command Example!humio-delete-job repository=sandbox id=1-mJg87kWn247FiYFpsnwZcx9G
#
Context Example#
Human Readable OutputCommand executed. Status code <Response [204]>
#
humio-list-alertsList alerts from Humio
#
Base Commandhumio-list-alerts
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Alert.description | String | Description of the alert |
Humio.Alert.id | String | The alert id |
Humio.Alert.name | String | The alert name |
Humio.Alert.notifiers | String | The notifiers the alert will use |
Humio.Alert.query.end | String | the end time of the query |
Humio.Alert.query.isLive | Number | whether or not the query is live |
Humio.Alert.query.queryString | String | The query string being used |
Humio.Alert.query.start | String | The start time of the query |
Humio.Alert.silenced | Number | Whether or not the alert is enabled |
Humio.Alert.throttleTimeMillis | Number | The throttle time for alerts |
#
Command Example!humio-list-alerts repository=sandbox
#
Context Example#
Human Readable Output#
Humio Alerts
description error id labels lastAlarm name notifiers query silenced throttleTimeMillis All notifications failed. ArHY37FM9Z8kWxYMRknwmdR5yJwNEUgc 1588680716684 new_alert_namme2 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000 All notifications failed. zXN-qja2pm5YFKVYDnllAmK4ctQ3wiOs 1588680716684 new_alert_name3 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000 All notifications failed. dIn3uuIvY4Gz90Bt2Dn2mVtDuB11ZUl2 1588680716685 SampleAlert BTkuj8QArhIFMh_L39FoN0tnyTUEXplc end: now
isLive: true
queryString: foo=bar
start: 24hfalse 300000 new_alert All notifications failed. kgguoWz0KgxEwge8IQt70L33C1J83U0C label 1588680716684 new_alert_name AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 500000 description 2 zNVae7vz-DH7GpeQUPfx1KXMGXGg7bf7 label 1588677696684 new name BTkuj8QArhIFMh_L39FoN0tnyTUEXplc end: now
isLive: true
queryString: test=true
start: 24hfalse 500000 All notifications failed. sFeYsP2mOJ_-CAqKt9frixFIYzXluiTB 1588680716684 new_alert_name2 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000 All notifications failed. sn82IuvTc9Vfnl45XqLWoZASIcBezvu1 1588680716684 new_alert_name4 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000 All notifications failed. ljeBta_tEvrGRRbae7MzLRiZG4NbckBm 1588680716684 new_alert_name5 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000
#
humio-get-alert-by-idlist alerts by id from Humio
#
Base Commandhumio-get-alert-by-id
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
id | Alert ID | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Alert.description | String | Description of the alert |
Humio.Alert.id | String | The alert id |
Humio.Alert.name | String | The alert name |
Humio.Alert.notifiers | String | The notifiers the alert will use |
Humio.Alert.query.end | String | the end time of the query |
Humio.Alert.query.isLive | Number | whether or not the query is live |
Humio.Alert.query.queryString | String | The query string being used |
Humio.Alert.query.start | String | The start time of the query |
Humio.Alert.silenced | Number | Whether or not the alert is enabled |
Humio.Alert.throttleTimeMillis | Number | The throttle time for alerts |
#
Command Example!humio-get-alert-by-id repository=sandbox id=ArHY37FM9Z8kWxYMRknwmdR5yJwNEUgc
#
Context Example#
Human Readable Output#
Humio Alerts
error id lastAlarm name notifiers query silenced throttleTimeMillis All notifications failed. ArHY37FM9Z8kWxYMRknwmdR5yJwNEUgc 1588680716684 new_alert_namme2 AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez end: now
isLive: true
queryString: alert=true
start: 24hfalse 300000
#
humio-create-alertCreate an alert in Humio
#
Base Commandhumio-create-alert
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
name | Name of the alert | Required |
queryString | Query to use | Required |
start | Start time, relative or epoch in ms. | Optional |
description | Description of the alert | Optional |
throttleTimeMillis | Time millis interval | Optional |
silenced | Is it silenced | Optional |
notifiers | comma-separated values of notifier IDs | Required |
labels | comma-separated values of labels | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Alert.description | String | Description of the alert |
Humio.Alert.id | String | The alert id |
Humio.Alert.name | String | The alert name |
Humio.Alert.notifiers | String | The notifiers the alert will use |
Humio.Alert.query.end | String | the end time of the query |
Humio.Alert.query.isLive | Number | whether or not the query is live |
Humio.Alert.query.queryString | String | The query string being used |
Humio.Alert.query.start | String | The start time of the query |
Humio.Alert.silenced | Number | Whether or not the alert is enabled |
Humio.Alert.throttleTimeMillis | Number | The throttle time for alerts |
#
Command Example!humio-create-alert name=SampleTestAlert notifiers=BTkuj8QArhIFMh_L39FoN0tnyTUEXplc queryString="foo=bar" repository=sandbox
#
Context Example#
Human Readable Output#
Humio Alerts
id name notifiers query silenced throttleTimeMillis LLJeuH--APkyCVaj3NDdXPlyfAtcsB SampleTestAlert BTkuj8QArhIFMh_L39FoN0tnyTUEXplc end: now
isLive: true
queryString: foo=bar
start: 24hfalse 300000
#
humio-list-notifiersList all notifiers in Humio
#
Base Commandhumio-list-notifiers
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Notifier | Unknown | List of notifiers |
#
Command Example!humio-list-notifiers repository=sandbox
#
Context Example#
Human Readable Output#
Humio Notifiers
entity id name properties WebHookNotifier BTkuj8QArhIFMh_L39FoN0tnyTUEXplc Null Webhook bodyTemplate: {
"repository": "{repo_name}",
"timestamp": "{alert_triggered_timestamp}",
"alert": {
"name": "{alert_name}",
"description": "{alert_description}",
"query": {
"queryString": "{query_string} ",
"end": "{query_time_end}",
"start": "{query_time_start}"
},
"notifierID": "{alert_notifier_id}",
"id": "{alert_id}",
"linkURL": "{url}"
},
"warnings": "{warnings}",
"events": {events},
"numberOfEvents": {event_count}
}
headers: {"Content-Type": "application/json"}
ignoreSSL: false
method: POST
url: http://localhostWebHookNotifier AQs6CuWm-uyXfYaNzwMyDGTX4S4qyAez other bodyTemplate: BODY
headers: {"Content-Type": "application/json"}
ignoreSSL: false
method: POST
url: http://localhost
#
humio-delete-alertDelete alert in Humio
#
Base Commandhumio-delete-alert
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
id | ID of the alert to be deleted | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Humio-delete-alert | Unknown | Details of the deletion |
#
Command Example!humio-delete-alert repository=sandbox id=dIn3uuIvY4Gz90Bt2Dn2mVtDuB11ZUl2
#
Context Example#
Human Readable OutputCommand executed. Status code <Response [204]>
#
humio-get-notifier-by-idGet notifier from Humio by id
#
Base Commandhumio-get-notifier-by-id
#
InputArgument Name | Description | Required |
---|---|---|
repository | Repository to use | Required |
id | ID to use | Required |
#
Context OutputPath | Type | Description |
---|---|---|
Humio.Notifier | Unknown | Details of the notifier |
#
Command Example!humio-get-notifier-by-id repository=sandbox id=BTkuj8QArhIFMh_L39FoN0tnyTUEXplc
#
Context Example#
Human Readable Output#
Humio Notifiers
entity id name properties WebHookNotifier BTkuj8QArhIFMh_L39FoN0tnyTUEXplc Null Webhook bodyTemplate: {
"repository": "{repo_name}",
"timestamp": "{alert_triggered_timestamp}",
"alert": {
"name": "{alert_name}",
"description": "{alert_description}",
"query": {
"queryString": "{query_string} ",
"end": "{query_time_end}",
"start": "{query_time_start}"
},
"notifierID": "{alert_notifier_id}",
"id": "{alert_id}",
"linkURL": "{url}"
},
"warnings": "{warnings}",
"events": {events},
"numberOfEvents": {event_count}
}
headers: {"Content-Type": "application/json"}
ignoreSSL: false
method: POST
url: http://localhost