Skip to content

Commit eea8445

Browse files
mdbirnstiehlnastasha-solomonbmorelli25
authored
[Observability] Add Logs Essentials get started docs (#2405)
This PR closes #2312 and adds the Logs Essentials get started. --------- Co-authored-by: Nastasha Solomon <[email protected]> Co-authored-by: Brandon Morelli <[email protected]>
1 parent 24be8f9 commit eea8445

File tree

2 files changed

+144
-1
lines changed

2 files changed

+144
-1
lines changed
Lines changed: 142 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,142 @@
1+
---
2+
navigation_title: Logs Essentials
3+
applies_to:
4+
serverless: ga
5+
products:
6+
- id: cloud-serverless
7+
- id: observability
8+
---
9+
10+
# Get started with {{obs-serverless}} Logs Essentials [logs-essentials-get-started]
11+
12+
```{note}
13+
Use this guide to get started with the Logs Essentials feature tier of {{obs-serverless}}. Refer to the main [{{observability}} getting started](/solutions/observability/get-started.md) docs to get started with {{obs-serverless}} Complete, which includes APM and Infrastructure metrics.
14+
```
15+
% Note should link to the feature tier comparison docs once published.
16+
17+
New to {{obs-serverless}} Logs Essentials? Discover more about its features and how to get started. The following instructions guide you through setting up your first Elastic {{observability}} Logs Essentials deployment, collecting log data, and exploring your data.
18+
19+
## Get started with your use case [get-started-with-use-case]
20+
21+
Learn how to create an {{obs-serverless}} project and use Elastic {{observability}} to gain deeper insight into the behavior of your applications and systems.
22+
23+
:::::::{stepper}
24+
25+
::::::{step} Create an Observability project
26+
27+
An {{obs-serverless}} project allows you to run {{obs-serverless}} in an autoscaled and fully-managed environment, where you don’t have to manage the underlying {{es}} cluster or {{kib}} instances.
28+
29+
::::{dropdown} Steps for creating a project
30+
:::{note}
31+
The **Admin** role or higher is required to create projects. Refer to [Assign user roles and privileges](/deploy-manage/users-roles/cloud-organization/manage-users.md#general-assign-user-roles).
32+
:::
33+
34+
1. Navigate to [cloud.elastic.co](https://cloud.elastic.co/) and log in to your account, or create one.
35+
1. Select **Create serverless project**.
36+
1. Under **Elastic for Observability**, select **Next**.
37+
1. Enter a name for your project.
38+
1. (Optional) Under **Settings** you can change the following:
39+
40+
* **Cloud provider**: The cloud platform where you’ll deploy your project. We currently support Amazon Web Services (AWS).
41+
* **Region**: The [region](/deploy-manage/deploy/elastic-cloud/regions.md) where your project will live.
42+
43+
1. Select **Edit settings**, and select **Observability Logs Essentials**.
44+
1. Select **Create serverless project**. It takes a few minutes to create your project.
45+
1. When the project is ready, click **Continue**.
46+
47+
::::::
48+
49+
::::::{step} Collect infrastructure logs
50+
51+
Bring logs from your hosts and services into Elastic {{observability}} to monitor the health and performance of your infrastructure. You can collect this data from hosts, containers, Kubernetes, and Cloud services.
52+
53+
:::::{dropdown} Steps for collecting infrastructure logs and metrics
54+
55+
::::{tab-set}
56+
:::{tab-item} Hosts
57+
58+
Elastic {{observability}} can collect logs from hosts through the Elastic Distribution of OpenTelemetry (EDOT) Collector or the Elastic Agent.
59+
60+
1. Select **Add data** from the main menu and then select **Host**.
61+
2. Select one of these options:
62+
* **OpenTelemetry: Logs**: Collect native OpenTelemetry logs.
63+
* **Elastic Agent: Logs**: Bring data from Elastic integrations.
64+
3. Follow the instructions for your platform.
65+
66+
For an overview of the EDOT, refer to [Elastic Distribution of OpenTelemetry (EDOT)](opentelemetry://reference/index.md).
67+
68+
:::
69+
70+
:::{tab-item} Kubernetes
71+
72+
Elastic {{observability}} can collect logs from Kubernetes through the Elastic Distribution of OpenTelemetry (EDOT) Collector or the Elastic Agent.
73+
74+
1. Select **Add data** from the main menu and then select **Kubernetes**.
75+
2. Select one of these options:
76+
* **OpenTelemetry: Logs**: Collect native OpenTelemetry metrics and logs.
77+
* **Elastic Agent: Logs**: Bring data from Elastic integrations.
78+
3. Follow the instructions for your platform.
79+
80+
For an overview of EDOT, refer to [Elastic Distribution of OpenTelemetry (EDOT)](opentelemetry://reference/index.md).
81+
82+
:::
83+
84+
:::{tab-item} Cloud
85+
86+
Elastic {{observability}} can collect logs from cloud services through Elastic integrations.
87+
88+
1. Select **Add data** from the main menu and then select **Cloud**.
89+
2. Select your Cloud provider to view the collection of integrations available for that provider.
90+
3. Select the integration you want to add.
91+
4. Select **Add**.
92+
:::
93+
94+
:::::
95+
96+
::::::
97+
98+
::::::{step} Explore logs in Discover
99+
100+
**Discover** lets you quickly search and filter your log data, get information about the structure of your log fields, and display findings in a visualization. Instead of having to log into different servers, change directories, and view individual files, all your logs are available in a single view.
101+
102+
For more information on exploring your logs in **Discover**, refer to [Explore logs in Discover](/solutions/observability/logs/discover-logs.md).
103+
::::::
104+
105+
::::::{step} Create your first dashboards
106+
107+
Elastic provides a wide range of prebuilt dashboards for visualizing observability data from a variety of sources. These dashboards are loaded automatically when you install [Elastic integrations](https://docs.elastic.co/integrations). You can also create new dashboards and visualizations based on your data views.
108+
109+
To create a new dashboard, select **Create Dashboard** and begin adding visualizations. You can create charts, graphs, maps, tables, and other types of visualizations from your data, or you can add visualizations from the library. You can also add other types of panels, such as filters and controls.
110+
111+
For more information about creating dashboards, refer to [Create your first dashboard](/explore-analyze/dashboards/create-dashboard-of-panels-with-web-server-data.md).
112+
113+
::::::
114+
115+
::::::{step} Set up alerts
116+
117+
Elastic {{observability}} lets you define rules of different types which detect complex conditions and trigger relevant actions. Elastic {{observability}} can send alerts to email, Slack, and other third-party systems. Refer to [Create and manage rules](/solutions/observability/incident-management/create-manage-rules.md) to get started.
118+
119+
::::::
120+
121+
:::::::
122+
123+
## Related resources
124+
125+
Use these resources to learn more about {{observability}} or get started in a different way.
126+
127+
### Quickstarts
128+
129+
Quickstarts are compact hands-on guides that help you experiment with Elastic {{observability}} features. Each quickstart provides a highly opinionated, fast path to data ingestion, with minimal configuration required.
130+
131+
[Browse the Elastic {{observability}} quickstarts](/solutions/observability/get-started/quickstarts.md) to get started with specific use cases.
132+
133+
### Observability integrations
134+
135+
Many {{observability}} integrations are available to collect and process your data. Refer to [Elastic integrations](https://www.elastic.co/docs/reference/integrations) for more information.
136+
137+
### Other resources
138+
139+
* [What's Elastic {{observability}}](/solutions/observability/get-started/what-is-elastic-observability.md)
140+
* [What’s new in Elastic Stack](/release-notes/elastic-observability/index.md)
141+
* [{{obs-serverless}} billing dimensions](/deploy-manage/cloud-organization/billing/elastic-observability-billing-dimensions.md)
142+
* [Log monitoring](/solutions/observability/logs.md)

solutions/toc.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,7 @@ toc:
109109
children:
110110
- file: observability/get-started/other-tutorials/tutorial-monitor-java-application.md
111111
- file: observability/get-started/other-tutorials/add-data-from-splunk.md
112+
- file: observability/get-started/logs-essentials.md
112113
- file: observability/applications/index.md
113114
children:
114115
- file: observability/apm/index.md
@@ -666,7 +667,7 @@ toc:
666667
- file: security/explore/users-page.md
667668
- file: security/advanced-entity-analytics.md
668669
children:
669-
- file: security/advanced-entity-analytics/overview.md
670+
- file: security/advanced-entity-analytics/overview.md
670671
- file: security/advanced-entity-analytics/entity-risk-scoring.md
671672
children:
672673
- file: security/advanced-entity-analytics/entity-risk-scoring-requirements.md

0 commit comments

Comments
 (0)