To ingest data into Sumo Logic, you must set up one or more collectors and sources. For this tutorial, we’ll show you how to install a collector and set up an Apache Access source.
Before you begin
For the tutorial, we want to make sure you have some basic data to work with. So we’ll start by having you download an Apache log file. Of course, during normal operations you’ll be sourcing your own log files.
The file to download was created some time ago. Follow these steps to download the file and change the date to make it current.
- Download the file apache_access_logs_tutorial.txt. If clicking the link initially opens the file in a new browser window, right click the link and choose the "Download" or "Save As" option instead.
- Make a copy of the file, and open the copy in a text editor.
- Do a "find and replace" on the day and date, and replace it with the current day and date. For example, search for "Tue Feb 22" and replace it with the current date using the same format. Below is an example of how you might do this using a Mac OS default text editor where the highlighted text field should be today's date.
- Save the modified file.
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.
We’ll show you how to install a collector from the Collection page, which gives you the most options and flexibility. (You can also use the Setup wizard.)
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.
Sign in to Sumo Logic, if you’re not already signed in. Click your name on the left nav, and go to the Preferences page.
Click + in the My Access Keys section.
Add a label for the access key, and click Generate Key.
Sumo generates the ID and key. Copy them to a secure location, because they won’t be available again in the UI. Click Close.
Now that you have an access ID and key, you can download the collector package and install a collector.
Download the collector package
Select Manage Data > Collection > Collection from the left nav to open the Collection page.
Click Add Collector.
Click Installed Collector.
Select your operating system. For this tutorial we’ll 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.
Install the collector
Open the downloaded installer file. If prompted, enter the root or Administrator username and password for your local machine.
Click Next on the Welcome page.
Accept the license agreement and click Next.
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. Click Advanced Settings if you want to change any settings, such as the collector name. Jot down the collector name, which you’ll need when adding a source. For our example, we're calling the collector prod_webserver. Click Next.
Select Access Key as the option to connect the collector to the Sumo Logic service.
Paste in the access ID and key that you generated before starting the collector installation, and click Next.
The installer confirms the connection to the Sumo Logic service and completes the installation. Click Finish to close the installer.
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.
Good work! You've completed these tasks in Part 1 of the Set Up Sumo Logic Tutorial.
- Downloaded a static Apache Access log file to your local machine and modified it for use in this tutorial.
- Installed a collector on your local machine.
In Part 2, you'll learn how to add a source for the collector to collect a particular type of data.