To get data over HTTP/S, configure an HTTP/S Listener account:
- Go to Manager > Administration > Listeners. The Listeners management console opens.
- Add HTTP account, for each account the following should be configured:
- Name: the name of the Listener account
- Description: the description of the Listener account
- Listening Node: the node in the cluster which will listen to the HTTP messages (appears only if a XpoLog cluster is deployed)
- Token: a unique token that is identified with this listener and must be included in the used URL when forwarding data to this account - the token ensures only permitted devices send data and also tags the sent data to the desired HTTP/S listener in XpoLog
- URL: the URL that devices that forward data to XpoLog should use - including the IP address/Hostname, port, path and token (in case of a cluster - the URL gets populated when selecting a Listening Node)
- Advanced Settings:
General Information:
Enabled: determine whether this account is enabled or not
Dynamic Log Creation Configuration:
Parent Folder: the parent folder which all logs from this listener will be place under in XpoLog Folders and Logs tree
Collection Policy: the collection policy which will be associated to all logs from this listener (used mainly for storage location and data retention)
Log Name Prefix: a prefix which will be added to any of the the logs from this listener (used to easily distinguish between multiple listener accounts logs)
Split by Source Device: check to create a log for each unique source device value in the received Syslog messages (a log will be create per device with it's associated events)
Split by JSON columns:
Listener Data:
Listener Data Location: the location which data will be stored to, by default XpoLog stores it in its data directory
Indexing Node: the node in the cluster which will index the received Syslog messages (appears only if a XpoLog cluster is deployed)
Indexing Interval: the frequency in which received Syslog messages are indexed
JSON Parsing:
JSON Parsing Level: set the maximum depth in the JSON object for which data will be extracted into columns - Save the account.
- Data received from the HTTP/S listener account will be created under the configured parent folder and will be available for searching, reporting and alerting