docs: add application server setup and JAVA_TOOL_OPTIONS scope warning

[alexandra5000]

Summary

• Adds a new Application servers section to the EDOT Java setup page with a summary table
• Adds a note warning that applies to every JVM in scope, which can cause unintended instrumentation in multi-JVM environments (application servers, Kubernetes pods)
• Links to the upstream OpenTelemetry server config docs for full details

Closes elastic/docs-content#5773

[github-actions]

📋 Changelog

⚠️ Cannot generate changelog: no matching type label found on this PR.

🔖 Add one of these type labels to your PR:

Label	Type
breaking-change	breaking-change
bug	bug-fix
deprecation	deprecation
feature	feature
enhancement	enhancement
changelog:upstream-update	enhancement
docs	docs
documentation	docs

🔖 To skip changelog generation or configure label rules, see docs/changelog.yml.

[github-actions]

🔍 Preview links for changed docs

• docs/reference/edot-java/setup/index.md

[github-actions]

Vale Linting Results

Summary: 1 suggestion found

💡 Suggestions (1)

File	Line	Rule	Message
docs/reference/edot-java/setup/index.md	97	Elastic.Wordiness	Consider using 'impossible' instead of 'not possible'.

---

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.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d8492699-17ad-4b47-9cd6-8b8a1c4894ec

📥 Commits

Reviewing files that changed from the base of the PR and between b24dbdf and 2754db0.

📒 Files selected for processing (1)

• docs/reference/edot-java/setup/index.md

---

📝 Walkthrough

Walkthrough

The docs update clarifies Java agent configuration: it changes “Runtime attach” wording from “not possible” to “impossible”; replaces a terse JAVA_TOOL_OPTIONS note with an explicit example (export JAVA_TOOL_OPTIONS="-javaagent:/path/to/agent.jar"), warns that JAVA_TOOL_OPTIONS affects every JVM in the environment, and advises preferring server-specific -javaagent settings in startup scripts instead of system/pod-level variables. It adds an “Application servers” subsection with a table mapping common servers to the files/commands where -javaagent belongs and links to upstream server-configuration docs.

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	PR successfully addresses issue #5773 by adding application server configuration guidance and JAVA_TOOL_OPTIONS scope warnings as requested.
Out of Scope Changes check	✅ Passed	All changes are confined to documentation updates directly addressing the linked issue; no unrelated code modifications present.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

• 🛠️ Update Documentation: Commit on current branch
• 🛠️ Update Documentation: Create PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}