Versions Compared

Key

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

To get data over HTTP/S, configure an HTTP/S Listener account:

  1. Go to Manager > Administration > Listeners. The Listeners management console opens.
  2. Add HTTP account, for each account the following should be configured:
    1. Name: the name of the Listener account
    2. Description: the description of the Listener account
    3. Listening Node: the node in the cluster which will listen to the HTTP messages (appears only if a XpoLog cluster is deployed)
    4. 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
    5. 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)
       
    6. Advanced Settings:

      General Information:
      Enabled: determine whether this account is enabled or not

      Dynamic Log Creation Configuration:

      Note: it is optional to configure the dynamic log creation configuration in the listener XpoLog. Leave as default to recevie the data as is, or use the agent's configuration to send the information.
      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. Leave empty for no prefix)
      Split by Source Device: check to create a log for each unique source device value in the received message (a log will be created per device)
      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 Nodethe 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
  3. Save the account.
  4. Data received to the HTTP/S listener account will be created under the configured parent folder and will be available for searching, reporting and alerting