Skip to content

docs(otel): add contrib collector to self-managed Elastic guide#7032

Open
alexandra5000 wants to merge 5 commits into
elastic:mainfrom
alexandra5000:upstream-collector-tutorial
Open

docs(otel): add contrib collector to self-managed Elastic guide#7032
alexandra5000 wants to merge 5 commits into
elastic:mainfrom
alexandra5000:upstream-collector-tutorial

Conversation

@alexandra5000

@alexandra5000 alexandra5000 commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Summary

Closes #6972

Adds a how-to guide for forwarding telemetry from an upstream contrib OpenTelemetry Collector to a self-managed Elastic Stack using an EDOT Collector gateway:

contrib otelcol-contrib → EDOT Collector (gateway mode) → Elasticsearch

Generative AI disclosure

Did you use a generative AI (GenAI) tool to assist in creating this contribution?

  • Yes
  • No

If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).
Tool(s) and model(s) used: Claude Opus 4.8

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

Comment on lines +292 to +293
- name: ELASTIC_AGENT_OTEL
value: "true"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That flag is documented for Fleet-managed Elastic Agent to toggle OTel mode. To be confirmed if it is also necessary for standalone (or if something else should be set).

export ELASTIC_API_KEY=your-encoded-api-key
```

Then create `gateway.yml`:

@alexandra5000 alexandra5000 Jun 22, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I based the gateway.yml on: elastic-agent/internal/edot/samples/linux/gateway.yml

Comment on lines +140 to +142
```bash
elastic-agent otel --config gateway.yml
```

@alexandra5000 alexandra5000 Jun 22, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this right?

Removes the "Deploy on k8s" section from the bare-metal guide and
replaces it with a Next steps link to the upcoming kubernetes.md page.
Keeps the bare-metal guide self-contained so it can merge independently.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add E2E tutorial: otelcol-contrib → EDOT Collector (inside Elastic Agent) → Elasticsearch with OTel native mode

1 participant