Skip to main content
Sumo Logic

Lab 1 - Installing a Collector

This lab teaches you how to install a collector.

To stream data into Sumo Logic for viewing and analysis, you first set up an installed collector and sources. 

An installed collector is a lightweight software package that you install on host machines in your environment to collect data from those machines, and a source specifies the type of data to collect.

In the next steps, you will install a collector from the Collection page, which gives you the most options and flexibility.  But before you begin, you’ll need an download the collector and install the collector and generate an access ID and key so the collector you install can authenticate to the Sumo Logic service.

Download the Collector package
  1. Sign in to Sumo Logic's training environment, if you’re not already signed in.  From the left navigation pane, select Manage Data> Collection.
    ManageDataCollection.png
  2. On the top right corner, click Add Collector
    AddaCollector.png
      

  3. Click Installed Collector.
    InstallCollector.png
                                                                                               

  4. Select your operating system (please note this will install a collector on the machine you are performing the labs on).  For this lab, we will show how to install using the UI installer, which is available for Linux, Windows, and macOS. When you click an operating system option, the installation file downloads automatically. After the download completes, you can run the UI installer. 
    AddInstalledCollector.png

 

Install the collector
  1. Open the downloaded installer file. If prompted, enter the root or Administrator username and password for your local machine. You may want to reposition this wizard popup screen to remain visible. This allows you can toggle back to this popup window.
  2. Click Next on the Welcome page.
    setup1.png

  3. Accept the license agreement and click Next.
    license.png

  4. Browse to select a location for the collector or accept the default and click Next to install the Collector files on your machine. The installer presents a confirmation screen.
    confirmation1.png

  5. Click Advanced Settings.

  6. Change the collector name to  client_<your_intials>. Use the default value for the rest of the settings. If you want to use a different name for any of the settings, take note of them as you will need them when adding a source. 

  7. Click Next.

  8. Click Next at the confirmation screen

    clipboard_e8634ee54a5f8a6179db1044743207757.png

  9. Select Access Key as the option to connect the collector to the Sumo Logic service and click Next.
    pasteaccessid.png

 

Generate an access key:
  1. Now let's see how to generate an access key so we can continue this process. From the left navigation pane at the bottom, click your account name, then click Preferences.
    image2.png
  2. Scroll down to the My Access Keys section and click Add Access Key.

    Add_access_key.png                                                      
  3. Create a Name for the access key. Use client_<your initials>_AK for the Access Key Name then click Create Key .

    clipboard_e240f27943d3841486e0276cc8bd15bde.png
  4. Sumo Logic generates the Access ID and Access Key. You will copy and paste each one into the add collector wizard. Click Copy for each and toggle back to the UI and paste them in one at a time.  Ensure you have pasted them each one into the add collector wizard. Once you click Done the access id and access key won’t be available again in the UI.

    Success.png

  5. Paste in the Access ID and then copy and paste in the Access Key from the previous step, and click Next.

    Installed Collector 5.png

  6. The installer confirms the connection to the Sumo Logic service and completes the installation. Click Finish to close the installer.
    completingsetup.png

  7. Close the Add Installer Collector dialog to return to the Manage Data > Collection > Collection page. You should now be able to find the collector you have just installed by searching for your initials, if not search for your hostname. 

    clipboard_e2c4b7759f35d2a42ed24317c8e2e9167.png

Congratulations - you have now installed a collector to start the process of getting data from your host.  In the next lab, we will add the source.