Skip to content

Commit 13766c0

Browse files
authored
Add link to quickstarts and other edits to Infra get started (elastic#2714)
Fixes elastic#2414
1 parent 25e44f8 commit 13766c0

File tree

1 file changed

+18
-19
lines changed

1 file changed

+18
-19
lines changed

solutions/observability/infra-and-hosts/get-started-with-system-metrics.md

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,13 @@ products:
1010
- id: cloud-serverless
1111
---
1212

13-
% Stateful get started is much more detailed, but I'm not sure it needs to be. I've considerably pared it down here, but we should go through the actual steps in here.
14-
1513
# Get started with system metrics [logs-metrics-get-started]
1614

17-
In this guide you’ll learn how to onboard system metrics data from a machine or server, then observe the data in Elastic Observability. This guide describes how to use a {{fleet}}-managed {{agent}}. To get started quickly with a standalone agent that does not require {{fleet}}, follow the steps described in the [quickstart](/solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md).
15+
In this guide you can learn how to onboard system metrics data from a machine or server using {{fleet}}-managed {{agent}}.
1816

17+
:::{tip}
18+
To get started quickly without {{fleet}}, follow the steps described in the [quickstarts](/solutions/observability/get-started/quickstarts.md).
19+
:::
1920

2021
## Prerequisites [logs-metrics-prereqs]
2122

@@ -29,7 +30,7 @@ To follow the steps in this guide, you need an {{stack}} deployment that include
2930

3031
* {{es}} for storing and searching data
3132
* {{kib}} for visualizing and managing data
32-
* Kibana user with `All` privileges on {{fleet}} and Integrations. Since many Integrations assets are shared across spaces, users need the Kibana privileges in all spaces.
33+
* Kibana user with `All` privileges on {{fleet}} and Integrations. Because many Integrations assets are shared across spaces, users need the Kibana privileges in all spaces.
3334
* Integrations Server (included by default in every {{ech}} deployment)
3435

3536
To get started quickly, create an {{ech}} deployment and host it on AWS, GCP, or Azure. [Try it out for free](https://cloud.elastic.co/registration?page=docs&placement=docs-body).
@@ -46,8 +47,6 @@ The **Admin** role or higher is required to onboard system metrics data. To lear
4647
::::
4748

4849

49-
50-
5150
## Onboard system metrics data [add-system-integration]
5251

5352
::::{tab-set}
@@ -62,26 +61,26 @@ In this step, add the System integration to monitor host logs and metrics.
6261

6362
1. Find **Integrations** in the main menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
6463
2. In the query bar, search for **System** and select the integration to see more details about it.
65-
3. Click **Add System**.
64+
3. Select **Add System**.
6665
4. Configure the integration name and optionally add a description. Make sure that **Collect logs from System instances** and **Collect metrics from System instances** are turned on.
67-
5. Expand each configuration section to verify that the settings are correct for your host. For example, if you’re deploying {{agent}} on macOS hosts, you need to add a new path to the *System syslog logs* section by clicking **Add row** and specifying `/var/log/system.log`.
66+
5. Expand each configuration section to verify that the settings are correct for your host. For example, if you're deploying {{agent}} on macOS hosts, you need to add a new path to the *System syslog logs* section by clicking **Add row** and specifying `/var/log/system.log`.
6867

6968
:::{image} /solutions/images/observability-kibana-agent-add-log-path.png
7069
:alt: Configuration page for adding log paths to the {{agent}} System integration
7170
:screenshot:
7271
:::
7372

74-
6. Click **Save and continue**. This step takes a minute or two to complete. When its done, you’ll have an agent policy that contains a system integration policy for the configuration you just specified.
73+
6. Select **Save and continue**. This step takes a minute or two to complete. When it's done, the new agent policy contains a system integration policy for the configuration you specified.
7574

7675
:::{image} /solutions/images/observability-kibana-system-policy.png
7776
:alt: Configuration page for adding the {{agent}} System integration
7877
:screenshot:
7978
:::
8079

81-
7. In the popup, click **Add {{agent}} to your hosts** to open the **Add agent** flyout.
80+
7. In the dialog, select **Add {{agent}} to your hosts** to open the **Add agent** flyout.
8281

8382
::::{tip}
84-
If you accidentally close the popup, go to **{{fleet}} > Agents**, then click **Add agent** to access the flyout.
83+
If you accidentally close the popup, go to **{{fleet}} > Agents**, then select **Add agent** to access the flyout.
8584
::::
8685

8786
:::
@@ -91,12 +90,12 @@ In this step, add the System integration to monitor host logs and metrics.
9190

9291
1. [Create a new {{obs-serverless}} project](/solutions/observability/get-started.md), or open an existing one.
9392
2. In your {{obs-serverless}} project, go to **Project Settings****Integrations**.
94-
3. Type **System** in the search bar, then select the integration to see more details about it.
95-
4. Click **Add System**.
93+
3. Enter **System** in the search bar, then select the integration to see more details about it.
94+
4. Select **Add System**.
9695
5. Follow the in-product steps to install the System integration and deploy an {{agent}}. The sequence of steps varies depending on whether you have already installed an integration.
9796

9897
* When configuring the System integration, make sure that **Collect metrics from System instances** is turned on.
99-
* Expand each configuration section to verify that the settings are correct for your host. For example, you may want to turn on **System core metrics** to get a complete view of your infrastructure.
98+
* Expand each configuration section to verify that the settings are correct for your host. For example, you might want to turn on **System core metrics** to get a complete view of your infrastructure.
10099

101100
## Install and run an {{agent}} on your machine [add-agent-to-fleet]
102101

@@ -105,7 +104,7 @@ The **Add agent** flyout has two options: **Enroll in {{fleet}}** and **Run stan
105104
1. Skip the **Select enrollment token** step. The enrollment token you need is already selected.
106105

107106
::::{note}
108-
The enrollment token is specific to the {{agent}} policy that you just created. When you run the command to enroll the agent in {{fleet}}, you will pass in the enrollment token.
107+
The enrollment token is specific to the {{agent}} policy that you created. When you run the command to enroll the agent in {{fleet}}, you pass in the enrollment token.
109108
::::
110109

111110
2. Download, install, and enroll the {{agent}} on your host by selecting your host operating system and following the **Install {{agent}} on your host** step.
@@ -115,14 +114,14 @@ The **Add agent** flyout has two options: **Enroll in {{fleet}}** and **Run stan
115114
:screenshot:
116115
:::
117116

118-
It takes about a minute for {{agent}} to enroll in {{fleet}}, download the configuration specified in the policy you just created, and start collecting data.
117+
It takes about a minute for {{agent}} to enroll in {{fleet}}, download the configuration specified in the policy you created, and start collecting data.
119118

120119
Notice that you can also configure the integration to collect logs.
121120

122121
::::{note}
123-
**What if {{agent}} is already running on my host?**
122+
**What if {{agent}} is already running on the host?**
124123

125-
Do not try to deploy a second {{agent}} to the same system. You have a couple options:
124+
Don't try to deploy a second {{agent}} to the same system. You have a couple options:
126125

127126
* **Use the System integration to collect system logs and metrics.** To do this, uninstall the standalone agent you deployed previously, then follow the in-product steps to install the System integration and deploy an {{agent}}.
128127
* **Configure your existing standalone agent to collect metrics.** To do this, edit the deployed {{agent}}'s YAML file and add metric inputs to the configuration manually. Manual configuration is a time-consuming process. To save time, you can follow the in-product steps that describe how to deploy a standalone {{agent}}, and use the generated configuration as source for the input configurations that you need to add to your standalone config file.
@@ -140,7 +139,7 @@ After the agent is installed and successfully streaming metrics data, go to **In
140139

141140
## Next steps [observability-get-started-with-metrics-next-steps]
142141

143-
Now that you’ve added metrics and explored your data, learn how to onboard other types of data:
142+
Now that you have added metrics and explored your data, learn how to onboard other types of data:
144143

145144
* [Get started with system logs](/solutions/observability/logs/get-started-with-system-logs.md)
146145
* [Stream any log file](/solutions/observability/logs/stream-any-log-file.md)

0 commit comments

Comments
 (0)