Configuring HTTPS Log Settings
Axonius supports integration with an HTTPS log server. You can configure HTTPS Logs to send all Activity Logs to this server, as well as to use the Send to HTTPS Log Server action.
To configure HTTPS Logs settings:
- From the top right corner of any page, click
. The System Settings page opens. - In the Categories/Subcategories pane of the System Settings page, expand External Integrations, and select HTTPS Logs.
-
Use HTTPS logs (required, default: switched off) - Toggle on to use an HTTPS logs server. This setting must be switched on if you want to use the Send to HTTPS Log Server action.
When Use HTTPS logs is activated, all log entries shown in the Activity Logs module are sent to the configured HTTPS log server.
-
Send query history events (optional, default: switched off) - Select this option to send an event to the HTTPS log server when each query run ends, so you can see who ran which query, when, and for how long. This option is available when Use HTTPS logs is enabled.
Axonius sends one event for each query run that completed, failed, or was canceled, and doesn't send an event while a run is in progress. Each event includes the user, status, start time, end time, duration, module, source, saved query name, query text, and data scope. Axonius sends the events in the background, so a slow log server doesn't slow down your queries. Axonius doesn't send query runs that ended before you selected this option. Query History keeps the newest 100,000 API runs and the newest 100,000 other runs. This limit applies only to Query History, not to the events that Axonius sends.
For the details of each event, see Sending Query History Events.
-
HTTPS gateway (optional, default: No gateway) - Enter or select the gateway to use.
-
HTTPS logs host (required) - Enter the log host.
-
Port (optional) - The port to use for HTTPS log host.
-
Custom request headers (JSON format) -
-
Authorization header - An authorization header to be used for authentication with the log server. For example: “Basic AaBbCc123456” . When supplied, Axonius sends this value in the HTTP header with the key Authorization. Enter the full value that the server expects, including the scheme, for example Bearer
. -
Extra headers around message (JSON format) (optional) - Use this setting to add a JSON formatted string that can be added to the HTTPS Log JSON thus enabling efficient integration with tools that accept input of JSON. The input should appear as follows:
{"index": 12345, "sourcetype": "_json"} -
HTTPS proxy (optional) - Enter a proxy.
-
Max retries (optional, default = 3) - The maximum number of retries to perform if connection to the HTTPS logging server is not successful.
-
Backoff for retries in seconds (optional, default = 0.5) - The number of seconds to wait between retries, using exponential backoff. (By default, the wait between retries is 0.5s, 1s, 2s.)
Updated 9 days ago
