Skip to main content

Site CollectorSite Collector Administration Guide

Set Up Linux File Collector

Set up the Linux File Collector to retrieve logs natively from your Linux server, from most common text log files *.log, *.txt, and *.csv. The Linux File Collector is a set of Site Collector flows, pre-built processors, groups, custom processors, other components, and integrations that pull single-line logs and push the logs to Exabeam Security Operations Platform. The collector provides flexible template configuration capabilities to collect Linux events.

Tip

If you configure a Linux File Collector instance for a Site Collector instance which was created using a hostname, you may get a 'Request timed out' error while establishing communication with the host VM from a Linux VM. To avoid the 'Request timed out' error and ‘Setup error’, ensure that you complete the following steps on your Linux VM. 

Type ping hostnname_of_site_collector in your Linux command prompt. If this command succeeds, proceed with installing a Linux File Collector for this Site Collector instance. If you get a ‘Request timed out’, or ‘Cannot resolve host’ or ‘Unknown host’ error, use the following steps.

  1. Open the hosts file that maintains mapping between hostname and IP_address, located at: \etc\hosts, using Notepad.

  2. Add a new entry with your hostname and IP address at the end of the file for example, hostnname_of_site_collector  ip_address

  3. Save the hosts file.

  4. Proceed to install a Linux File Collector instance for this Site Collector instance.

To set up a Linux File Collector:

  1. Log in to the Exabeam Security Operations Platform with your registered credentials.

  2. Navigate to Collectors > Site Collectors.

  3. Ensure that Site Collector 1.16 and later version is installed and in running state.

  4. On the Site Collector page, click the Collectors Library tab, then click Linux File.

    Linux_file_collector1.png
  5. In the Definition section, enter the required information as follows.

    Linux_file_collector2.png
    • Collector Name – Site Collector generates a name for the Linux File collector based on your hostname.

    • Site Collector Instance – Select the site collector instance for which you want to set up the Linux File Collector.

  6. Click Next.

  7. In the Data section, set up the Linux File template while configuring the collector. After you create a template, you can reuse the template for other collector instances or create a new template each time you set up a new Linux File Collector.

    Linux_file_collector3.png
    • File Collector Template – Select a preconfigured template to filter logs, or, create a new template. Templates enable you to filter logs by file names.

      To create a new Linux File template:

      1. In the Templates list, click New File Collector Template.

        linux_template1.png
      2. In the Template Name field, specify a name for the new Linux File template.

      3. In the Add File Paths section, for filtering logs, enable the log fields that you want to use by entering regex.

        The collector supports searching for log files across subdirectories which brings comprehensive log file collection by traversing and retrieving logs from nested directory structures.

        • Include – Enter regex for the file names or paths to be included in log collection.

          For example, you can enter a file path with wildcard characters such as,/var/log/*.log and /opt/exabeam/logs/*.txt.

          Here are the examples of advanced log filtering.

          Example 1: If you include /opt/exabeam/logs/*.txt in your regex, the collector searches for all files and subdirectories under /opt/exabeam/logs for files with the .txt suffix.

          Example 2: If you include /opt/exabeam/logs/* in your regex, the collector configuration comprehensively processes all files and subdirectories within /opt/exabeam/logs, ensuring that every file in the specified directory and its nested structures is included in the processing.

        • Exclude – Enter regex for the file names or paths to be rejected while collecting logs. The collector collects all the security events from the specified log name excluding the events or file names listed in this section.

          For example, you can enter regex for exclude condition for excluding files or folders in the context of include condition: c:\exabeam\logs\*.txt. Based on this regex, the collector ignores .txt logs.

        Linux_template_3.png
      4. After setting the filters, click Create.

  8. In the Installation section, copy the scripts and download certificates as follows.

    Linux_file_collector5.png
    • Certificate – Click Download Certificate to download the certificates. After you download the certificates, ensure that you save the certificates in the same directory from where you execute the Linux File Collector installation command.

    • Install Script – Copy the Install script. Paste the script in shell or terminal as an administrator where you put downloaded certificates. Then, run the copied command to install the Linux File collector.

    • Uninstall Script – To uninstall the Linux File collector, copy and run the script using shell or terminal as an administrator. You must execute the script on the Linux server.

  9. Verify that the Collector installed. After you run the Install script on your Linux server, you get a confirmation message about successful collector installation and the Collector instance is listed in the Overview section on the user interface.

    The Linux File Collector is set up and is ready to pull logs from source files based on the template configuration from your Linux server.

    After the Linux collector is set up, Site Collector Core starts pulling logs periodically based on your template configuration and uploads logs to Exabeam Security Operations Platform. If the Linux server is not available, Site Collector core resumes pulling logs from the place where it stopped.

    An antivirus software such as Crowdstrike Falcon Sensor may block arbitrary binary execution which may lead to installation failure. Ensure that you provide necessary permissions to execute the binary file by contacting your support team.

    In case of installation failure, the collector is disabled, and the configuration is saved. You can check the status of the collector on the user interface or using the support package.