You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: solutions/observability/infra-and-hosts/get-started-with-system-metrics.md
+18-19Lines changed: 18 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,12 +10,13 @@ products:
10
10
- id: cloud-serverless
11
11
---
12
12
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
-
15
13
# Get started with system metrics [logs-metrics-get-started]
16
14
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}}.
18
16
17
+
:::{tip}
18
+
To get started quickly without {{fleet}}, follow the steps described in the [quickstarts](/solutions/observability/get-started/quickstarts.md).
19
+
:::
19
20
20
21
## Prerequisites [logs-metrics-prereqs]
21
22
@@ -29,7 +30,7 @@ To follow the steps in this guide, you need an {{stack}} deployment that include
29
30
30
31
* {{es}} for storing and searching data
31
32
* {{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.
33
34
* Integrations Server (included by default in every {{ech}} deployment)
34
35
35
36
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
46
47
::::
47
48
48
49
49
-
50
-
51
50
## Onboard system metrics data [add-system-integration]
52
51
53
52
::::{tab-set}
@@ -62,26 +61,26 @@ In this step, add the System integration to monitor host logs and metrics.
62
61
63
62
1. Find **Integrations** in the main menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
64
63
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**.
66
65
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`.
:alt: Configuration page for adding log paths to the {{agent}} System integration
71
70
:screenshot:
72
71
:::
73
72
74
-
6.Click**Save and continue**. This step takes a minute or two to complete. When it’s 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.
:alt: Configuration page for adding the {{agent}} System integration
78
77
:screenshot:
79
78
:::
80
79
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.
82
81
83
82
::::{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.
85
84
::::
86
85
87
86
:::
@@ -91,12 +90,12 @@ In this step, add the System integration to monitor host logs and metrics.
91
90
92
91
1.[Create a new {{obs-serverless}} project](/solutions/observability/get-started.md), or open an existing one.
93
92
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**.
96
95
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.
97
96
98
97
* 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.
100
99
101
100
## Install and run an {{agent}} on your machine [add-agent-to-fleet]
102
101
@@ -105,7 +104,7 @@ The **Add agent** flyout has two options: **Enroll in {{fleet}}** and **Run stan
105
104
1. Skip the **Select enrollment token** step. The enrollment token you need is already selected.
106
105
107
106
::::{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.
109
108
::::
110
109
111
110
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
115
114
:screenshot:
116
115
:::
117
116
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.
119
118
120
119
Notice that you can also configure the integration to collect logs.
121
120
122
121
::::{note}
123
-
**What if {{agent}} is already running on my host?**
122
+
**What if {{agent}} is already running on the host?**
124
123
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:
126
125
127
126
***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}}.
128
127
***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
140
139
141
140
## Next steps [observability-get-started-with-metrics-next-steps]
142
141
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:
144
143
145
144
*[Get started with system logs](/solutions/observability/logs/get-started-with-system-logs.md)
146
145
*[Stream any log file](/solutions/observability/logs/stream-any-log-file.md)
0 commit comments