Skip to main content
Sumo Logic

Lab 1 - Installing 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 access ID and key so the collector you install can authenticate to the Sumo Logic service.

So let’s start by generating an ID and key.

Generate an access key:

  1. Sign in to Sumo Logic, if you’re not already signed in. Click your name on the left navigation pane, and go to the Preferences page
    image2.png
  2. Click Add Access Key in the My Access Keys section.

    Add_access_key.png                                                      
  3. Add a label for the access key, and click Create Key using prod_webserver_<your_name> for the Access Key Name.

    Create_access_key.png
  4. Sumo generates the ID and key. You will need them on the next step, so copy them to a secure location as they won’t be available again in the UI. Click Done.

    Success.png

    Now that you have an access ID and key, you can download the collector package and install a collector.
     
  5. From the left navigation pane, open the Collection page. Select:  Manage Data-> Collection
    ManageDataCollection.png
  6. On the top right corner, click Add Collector
    AddaCollector.png
      

  7. Click Installed Collector.
    InstallCollector.png
                                                                                               

  8. 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. Make sure you have the access ID and key that you generated handy.
    AddInstalledCollector.png

  9. Open the downloaded installer file. If prompted, enter the root or Administrator username and password for your local machine.

  10. Click Next on the Welcome page.
    setup1.png

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

  12. 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

  13. Click Advanced Settings.

  14. We will be changing the collector name to  prod_webserver_<your_name>. 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. 

  15. Click Next.
     

  16. Click Next at the confirmation screen

    confirmation.png

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

  18. Paste in the Access ID and key that you generated before starting the collector installation, and click Next.Installed Collector 5.png

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

  20. 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 name.

    collectionsearch.png