From 786d09456ee790e7e7650989fd4368d4765200a0 Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Mon, 16 Dec 2024 13:57:19 -0500 Subject: [PATCH 1/3] Add placeholder for 'transform to OTel Collector' docs --- .../elastic-agent/otel-agent-transform.asciidoc | 7 +++++++ .../en/ingest-management/elastic-agent/otel-agent.asciidoc | 2 ++ 2 files changed, 9 insertions(+) create mode 100644 docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc diff --git a/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc new file mode 100644 index 000000000..c1404b06f --- /dev/null +++ b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc @@ -0,0 +1,7 @@ +[[otel-agent-transform]] += Transform an installed {agent} to run as an OTel Collector + +preview::[] + +If you have a currently installed {agent}, you can follow these steps to run it as an <>. + diff --git a/docs/en/ingest-management/elastic-agent/otel-agent.asciidoc b/docs/en/ingest-management/elastic-agent/otel-agent.asciidoc index 4defa6edd..99c79989c 100644 --- a/docs/en/ingest-management/elastic-agent/otel-agent.asciidoc +++ b/docs/en/ingest-management/elastic-agent/otel-agent.asciidoc @@ -8,3 +8,5 @@ The link:https://opentelemetry.io/docs/collector/[OpenTelemetry Collector] is a When you run {agent} in `otel` mode it supports the standard OTel Collector configuration format that defines a set of receivers, processors, exporters, and connectors. Logs, metrics, and traces can be ingested using OpenTelemetry data formats. For a full overview and steps to configure {agent} in `otel` mode, including a guided onboarding, refer to the link:/~https://github.com/elastic/opentelemetry/tree/main[Elastic Distributions for OpenTelemetry] repository in GitHub. You can also check the <> in the {fleet} and {agent} Command reference. + +// If you have a currently running {agent} you can <>. From b47e657db8a049e160d41b3306ac30d8245e2128 Mon Sep 17 00:00:00 2001 From: David Kilfoyle Date: Mon, 16 Dec 2024 14:37:12 -0500 Subject: [PATCH 2/3] Add include statement (commented out) --- .../elastic-agent/otel-agent-transform.asciidoc | 17 +++++++++++++++-- docs/en/ingest-management/index.asciidoc | 2 ++ 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc index c1404b06f..0ef89ed15 100644 --- a/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc +++ b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc @@ -1,7 +1,20 @@ [[otel-agent-transform]] -= Transform an installed {agent} to run as an OTel Collector +== Transform an installed {agent} to run as an OTel Collector preview::[] -If you have a currently installed {agent}, you can follow these steps to run it as an <>. +If you have a currently installed {agent}, you change it to run as an <>. + +To transform {agent} to an OTel Collector: + +. Some instruction. + +. Some other instruction. Run the 'elastic-agent -transform-otel` command: ++ +[source,shell] +---- +elastic-agent -switch-me-to-otel-please +---- + + diff --git a/docs/en/ingest-management/index.asciidoc b/docs/en/ingest-management/index.asciidoc index 7190ee36f..dfcef8796 100644 --- a/docs/en/ingest-management/index.asciidoc +++ b/docs/en/ingest-management/index.asciidoc @@ -71,6 +71,8 @@ include::elastic-agent/configuration/env/container-envs.asciidoc[leveloffset=+3] include::elastic-agent/otel-agent.asciidoc[leveloffset=+2] +//include::elastic-agent/otel-agent-transform.asciidoc[leveloffset=+2] + include::elastic-agent/elastic-agent-unprivileged-mode.asciidoc[leveloffset=+2] include::elastic-agent/install-agent-msi.asciidoc[leveloffset=+2] From ba944ecc9966d4e404c2bb80c9567980e17ddaf8 Mon Sep 17 00:00:00 2001 From: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com> Date: Mon, 16 Dec 2024 15:12:15 -0500 Subject: [PATCH 3/3] Update docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com> --- .../elastic-agent/otel-agent-transform.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc index 0ef89ed15..1c70cda60 100644 --- a/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc +++ b/docs/en/ingest-management/elastic-agent/otel-agent-transform.asciidoc @@ -9,7 +9,7 @@ To transform {agent} to an OTel Collector: . Some instruction. -. Some other instruction. Run the 'elastic-agent -transform-otel` command: +. Some other instruction. Run the `elastic-agent -transform-otel` command: + [source,shell] ----