Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General

XpoLog SDK provides a set of commands that enables remote configuration of different XpoLog properties without accessing the GUI.

The following commands are available.

...

Key

Description

Values

 

api

The API type to use – must be addLog

“addLog”

Mandatory

logNameThe name of the log to be createdTextMandatory
logPathThe full path to the log under the Folders and Log Tree (excluding the log name)ROOT = Top Folder (Folders and Logs) Use ‘->’ in the path between foldersOptional
newLogPathThe new Folders and Logs path to placethe log in XpoLog Folders and Logs tree (for example Root->Folder1->Folder2).ROOT = Top Folder (Folders and Logs) Use ‘->’ in the path between foldersOptional*
  • If used, override must be true
  • If used, newLogName must not be used
newLogNameThe new log nameTextOptional*
  • If used, override must be true
  • If used, newLogPath must not be used

filesPath

The full path to the logs on the source:

  • SSH\Windows\Local - absolute path to the files on the source (name pattern may be used)
  • Remote XpoLog Log - the filesPath parameter should be the path of the log under the Folders and Logs tree in the Remote XpoLog instance to be added (for example Root->Folder1->Folder2->log1).

Text

Mandatory

collectionPolicyThe exact name of the collection policy to be assigned on the log (if doesn't exist, the command will be ignored)TextOptional
accountNameThe name of the account to be used if needed (SSH or Win Account or Remote XpoLog)TextDirect Access - Optional
Win Network/SSH - Mandatory 
patternsA list of patterns that will be applied on the log that is added (separated by XPLG_SDK_SEP)Text

Mandatory*
If a template is used - optional 

appTagsA comma separated list of appTags that the added log will be tagged toTextOptional
overrideAppTagsSpecifies whether to add appTags on a log or replace the existing appTags of a log. Used only on edit when override is set to truetrue/falseOptional
timezoneThe timezone definition of the added logText (a value from JAVA time zone list)Optional
charsetThe charset definition of the added logText (a value from JAVA charset list)Optional
templateThe name of the template to be usedTextOptional*
specific parameters that are passed override template's settings 
dataFilterQueryThe dataFilterQuery to be applied on the specified - see Advanced Log Settings for more information. (pass an empty filter to clear an existing filter)TextOptional

override

Overwrite an existing log configuration (Default: false)

true/false

Optional

...

Key

Description

Values

 

api

The API type to use – must be addLog

“addLog”

Mandatory

logNameThe name of the log to be createdTextMandatory
logPathThe full path to the log under the Folders and Log Tree (excluding the log name)ROOT = Top Folder (Folders and Logs) Use ‘->’ in the path between foldersOptional
newLogPathThe new Folders and Logs path to placethe log in XpoLog Folders and Logs tree (for example Root->Folder1->Folder2).ROOT = Top Folder (Folders and Logs) Use ‘->’ in the path between foldersOptional*
  • If used, override must be true
  • If used, newLogName must not be used
newLogNameThe new log nameTextOptional*
  • If used, override must be true
  • If used, newLogPath must not be used
hostThe host to collect data from (default: localhost)TextOptional
uncTrue = use direct access to the EVTX file (faster but requires permissions). False = connect via Windows platform (automatic)true/falseOptional
collectionPolicyThe exact name of the collection policy to be assigned on the log (if doesn't exist, the command will be ignored)TextOptional
accountNameThe name of the account to be used if needed (Windows Authentication Account if not used on XpoLog service level)TextOptional
appTagsA comma separated list of appTags that the added log will be tagged toTextOptional
overrideAppTagsSpecifies whether to add appTags on a log or replace the existing appTags of a log. Used only on edit when override is set to truetrue/falseOptional
timezoneThe timezone definition of the added logText (a value from JAVA time zone list)Optional

override

Overwrite an existing log configuration (Default: false)

true/false

Optional

...