You are viewing docs on Elastic's new documentation system, currently in technical preview. For all other Elastic docs, visit elastic.co/guide.

Get started with system logs

Learn how to onboard your system log data quickly.

Required role

The Admin role or higher is required to onboard log data. To learn more, refer to Assign user roles and privileges.

In this guide you'll learn how to onboard system log data from a machine or server, then observe the data in Logs Explorer.

To onboard system log data:

  1. Create a new Observability project, or open an existing one.
  2. In your Observability project, go to Add data.
  3. Under Collect and analyze logs, click Stream host system logs. When the page loads, the system integration is installed automatically, and a new API key is created. Make sure you copy the API key and store it in a secure location.
  4. Follow the in-product steps to install and configure the Elastic Agent. Notice that you can choose to download the agent's config automatically to avoid adding it manually.

After the agent is installed and successfully streaming log data, you can view the data in the UI:

  1. From the navigation menu, go to Discover and select the Logs Explorer tab. The view shows all log datasets. Notice you can add fields, change the view, expand a document to see details, and perform other actions to explore your data.
  2. Click All log datasets and select System → syslog to show syslog logs.

Next steps

Now that you've added system logs and explored your data, learn how to onboard other types of data:

To onboard other types of data, select Add Data from the main menu.

On this page