Skip to content

[Security] Update Elastic Defend troubleshooting#5312

Merged
natasha-moore-elastic merged 6 commits intomainfrom
issue-399-defend-ts
Mar 11, 2026
Merged

[Security] Update Elastic Defend troubleshooting#5312
natasha-moore-elastic merged 6 commits intomainfrom
issue-399-defend-ts

Conversation

@natasha-moore-elastic
Copy link
Copy Markdown
Contributor

@natasha-moore-elastic natasha-moore-elastic commented Feb 27, 2026

Summary

Resolves https://github.com/elastic/docs-content-internal/issues/399:

  • Adds new entries to the troubleshooting guide.
  • Updates the Agent-Endpoint connection issues section.
  • Converts dropdowns into level 2 sections to address the following issues:
  1. The headings can be clicked on to expand them but when I do I don't get a link change to the URL. This makes it hard to link others to exact troubleshooting steps. It would be nice if I could share such links.
  2. The "On this page" links on the right to exhibit the URL-change behavior, but the actual drill down options don't correspond to the top-level sections on the main page and don't change the page content.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 27, 2026

Vale Linting Results

Summary: 4 suggestions found

💡 Suggestions (4)
File Line Rule Message
troubleshoot/security/elastic-defend.md 23 Elastic.Wordiness Consider using 'sometimes' instead of 'In some cases'.
troubleshoot/security/elastic-defend.md 46 Elastic.WordChoice Consider using 'deactivated, deselected, hidden, turned off, unavailable' instead of 'Disabled', unless the term is in the UI.
troubleshoot/security/elastic-defend.md 149 Elastic.Wordiness Consider using 'because' instead of 'since'.
troubleshoot/security/elastic-defend.md 247 Elastic.WordChoice Consider using 'deactivate, deselect, hide, turn off' instead of 'Disable', unless the term is in the UI.

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.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 27, 2026

🔍 Preview links for changed docs

@natasha-moore-elastic natasha-moore-elastic marked this pull request as ready for review March 9, 2026 17:08
@natasha-moore-elastic natasha-moore-elastic requested a review from a team as a code owner March 9, 2026 17:08
Comment thread troubleshoot/security/elastic-defend.md
Copy link
Copy Markdown
Contributor

@ferullo ferullo left a comment

Choose a reason for hiding this comment

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

The changes look great (thanks!) but I'm going to defer to @intxgo 's approval since he's the expert.

FYI @joeypoon

@intxgo
Copy link
Copy Markdown

intxgo commented Mar 10, 2026

The changes look great (thanks!) but I'm going to defer to @intxgo 's approval since he's the expert.

The changes are good, but we have so little documentation about the orphaned state that I think it's worth to add the sentece.

btw @ferullo I've just checked on serverless, still only Agent gets the orphaned status, but endpoint goes offline. We've discussed that some time ago, I thought it was going to be applied also on the Endpoints view.

Copy link
Copy Markdown
Contributor

@benironside benironside left a comment

Choose a reason for hiding this comment

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

LGTM, I like the reorg to use fewer notes. Left one suggestion for your consideration.

Comment thread troubleshoot/security/elastic-defend.md Outdated
natasha-moore-elastic and others added 2 commits March 11, 2026 14:48
Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
@natasha-moore-elastic natasha-moore-elastic enabled auto-merge (squash) March 11, 2026 14:54
@natasha-moore-elastic natasha-moore-elastic merged commit fc93ba5 into main Mar 11, 2026
7 of 8 checks passed
@natasha-moore-elastic natasha-moore-elastic deleted the issue-399-defend-ts branch March 11, 2026 14:58
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.

4 participants