Skip to content

Commit

Permalink
update the logs resource guide
Browse files Browse the repository at this point in the history
  • Loading branch information
mdbirnstiehl committed Dec 18, 2023
1 parent 2bbc904 commit b72adb9
Showing 1 changed file with 14 additions and 7 deletions.
21 changes: 14 additions & 7 deletions docs/en/observability/logs-checklist.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,23 @@
= Logs resource guide

++++
<titleabbrev>Resource guide</titleabbrev>
<titleabbrev>Logs resource guide</titleabbrev>
++++

In this guide, you'll find resources on sending log data to {es}, configuring your logs, and analyzing your logs.
Logs are an important tool for ensuring the performance and reliability of your applications and infrastructure. They provide important information for debugging, analyzing performance, and managing compliance.

In this guide, you'll find resources for sending log data to {es}, configuring your logs, and analyzing your logs.

[discrete]
[[logs-getting-started-checklist]]
== Get started with logs

If you're new to ingesting, viewing, and analyzing logs with Elastic, see <<logs-metrics-get-started, Get started with logs and metrics>> for an overview of adding integrations, installing and running an {agent}, and monitoring logs.

To get started with your log data, See <<logs-stream>> to learn how to send a log file to {es} using a standalone {agent} and configure the {agent} and your data streams using the `elastic-agent.yml` file.

Refer to the following sections for more information on additional options for sending your data to {es}.

[discrete]
[[logs-send-data-checklist]]
== Send logs data to {es}
Expand All @@ -39,11 +45,10 @@ See {fleet-guide}/install-fleet-managed-elastic-agent.html[install {fleet}-manag

* *Standalone {agent}*
+
Install an {agent} and manually configure it locally on the system where its installed.
Install an {agent} and manually configure it locally on the system where it's installed.
You are responsible for managing and upgrading the agents.
This approach is reserved for advanced users only.
+
See {fleet-guide}/install-standalone-elastic-agent.html[install standalone {agent}].
See <<logs-stream>> to learn how to send a log file to {es} using a standalone {agent} and configure the {agent} and your data streams using the `elastic-agent.yml` file.

* *{agent} in a containerized environment*
+
Expand All @@ -65,9 +70,11 @@ https://www.elastic.co/products/logstash[Logstash] for indexing.

[discrete]
[[logs-configure-data-checklist]]
== Configure logs
== Parse and organize your logs

To get started parsing and organizing your logs, refer to <<logs-parse>> for information on breaking unstructured log data into meaningful fields you can use to filter and aggregate your data.

The following resources provide information on configuring your logs:
The following resources provide additional information on concepts that are important when organizing your logs:

- {ref}/data-streams.html[Data streams] – Efficiently store append-only time series data in multiple backing indices partitioned by time and size.
- {kibana-ref}/data-views.html[Data views] – Query log entries from the data streams of specific datasets or namespaces.
Expand Down

0 comments on commit b72adb9

Please sign in to comment.