Skip to content

[fortinet_fortiedr] Update documentation#17399

Open
taylor-swanson wants to merge 7 commits intoelastic:mainfrom
taylor-swanson:docs/fortinet_fortiedr
Open

[fortinet_fortiedr] Update documentation#17399
taylor-swanson wants to merge 7 commits intoelastic:mainfrom
taylor-swanson:docs/fortinet_fortiedr

Conversation

@taylor-swanson
Copy link
Contributor

@taylor-swanson taylor-swanson commented Feb 12, 2026

Proposed commit message

  • Update documentation
  • Generate knowledge base file
  • Fix typo in manifest

Assisted by Google Gemini and Claude Opus.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.
    - [ ] I have verified that any added dashboard complies with Kibana's Dashboard good practices

Related issues

  • Closes elastic/integration-experience#446

- Update documentation
- Fix typo in manifest file
@taylor-swanson taylor-swanson self-assigned this Feb 12, 2026
@taylor-swanson taylor-swanson added documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. Integration:fortinet_fortiedr Fortinet FortiEDR Logs Team:Integration-Experience Security Integrations Integration Experience [elastic/integration-experience] labels Feb 12, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 12, 2026

Vale Linting Results

Summary: 17 warnings, 14 suggestions found

⚠️ Warnings (17)
File Line Rule Message
packages/fortinet_fortiedr/docs/README.md 232 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/fortinet_fortiedr/docs/README.md 247 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/fortinet_fortiedr/docs/README.md 269 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 289 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/fortinet_fortiedr/docs/README.md 338 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 338 Elastic.DontUse Don't use 'please'.
packages/fortinet_fortiedr/docs/README.md 339 Elastic.DontUse Don't use 'Note that'.
packages/fortinet_fortiedr/docs/README.md 339 Elastic.DontUse Don't use 'note that'.
packages/fortinet_fortiedr/docs/README.md 339 Elastic.DontUse Don't use 'note that'.
packages/fortinet_fortiedr/docs/README.md 340 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 340 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 340 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 340 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/README.md 393 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/fortinet_fortiedr/docs/README.md 393 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/knowledge_base/service_info.md 82 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/fortinet_fortiedr/docs/knowledge_base/service_info.md 157 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
💡 Suggestions (14)
File Line Rule Message
packages/fortinet_fortiedr/_dev/build/docs/README.md 3 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/_dev/build/docs/README.md 20 Elastic.WordChoice Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 3 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 20 Elastic.WordChoice Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 331 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 338 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 338 Elastic.WordChoice Consider using 'deactivated, deselected, hidden, turned off, unavailable' instead of 'disabled', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 339 Elastic.WordChoice Consider using 'efficiently' instead of 'simply', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 339 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 389 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/fortinet_fortiedr/docs/README.md 404 Elastic.Wordiness Consider using 'all' instead of 'All of '.
packages/fortinet_fortiedr/docs/knowledge_base/service_info.md 95 Elastic.HeadingColons Capitalize ': l'.
packages/fortinet_fortiedr/docs/knowledge_base/service_info.md 108 Elastic.HeadingColons Capitalize ': t'.
packages/fortinet_fortiedr/docs/knowledge_base/service_info.md 124 Elastic.HeadingColons Capitalize ': u'.

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.

@elastic-vault-github-plugin-prod

🚀 Benchmarks report

To see the full report comment with /test benchmark fullreport

@mjwolf mjwolf added the enhancement New feature or request label Feb 12, 2026
@taylor-swanson taylor-swanson marked this pull request as ready for review February 12, 2026 18:36
@taylor-swanson taylor-swanson requested a review from a team as a code owner February 12, 2026 18:36
@elasticmachine
Copy link

Pinging @elastic/integration-experience (Team:Integration-Experience)

Copy link
Contributor

@mjwolf mjwolf left a comment

Choose a reason for hiding this comment

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

Thanks for working on this. It looks good to me, there are just some small changes needed. There's also some suggested linter changes (you don't need to make changes on the ECS fields or other generated text)

Comment on lines 7 to 12
This integration facilitates:
- Endpoint threat monitoring: You'll monitor real-time security events detected by FortiEDR to identify and respond to malware, ransomware, and unauthorized access attempts across your fleet.
- Audit and compliance: You'll maintain a comprehensive audit trail of administrative actions and user activities within the FortiEDR console to satisfy regulatory compliance requirements.
- Incident investigation: You'll leverage detailed process and network telemetry from FortiEDR logs to perform root cause analysis and reconstruct the timeline of security incidents.
- Operational health oversight: You'll track system-level events and operational status changes within the FortiEDR environment to ensure your security infrastructure is functioning optimally.

Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This integration facilitates:
- Endpoint threat monitoring: You'll monitor real-time security events detected by FortiEDR to identify and respond to malware, ransomware, and unauthorized access attempts across your fleet.
- Audit and compliance: You'll maintain a comprehensive audit trail of administrative actions and user activities within the FortiEDR console to satisfy regulatory compliance requirements.
- Incident investigation: You'll leverage detailed process and network telemetry from FortiEDR logs to perform root cause analysis and reconstruct the timeline of security incidents.
- Operational health oversight: You'll track system-level events and operational status changes within the FortiEDR environment to ensure your security infrastructure is functioning optimally.

This list can be removed, it's duplicated in the Supported use case section

- Message truncation:
For large security events sent using UDP, logs might be truncated. Increase the `max_message_size` and `read_buffer` in the **Custom UDP Options** if you notice incomplete payloads.

For vendor documentation links, see the [Vendor documentation links](#vendor-documentation-links) section.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this anchor link won't work in the published pages. It's ok to remove it completely

- [FortiEDR Administration Guide: Automated Incident Response - Playbooks](https://docs.fortinet.com/document/fortiedr/7.2.0/administration-guide/419440/automated-incident-response-playbooks-page)
- [Fortinet FortiEDR Administration Guide](https://docs.fortinet.com/document/fortiedr/7.2.0/administration-guide)
- [Fortinet Documentation Library](https://docs.fortinet.com/)
- [Elastic Fortinet FortiEDR Integration Reference](https://www.elastic.co/docs/reference/integrations/fortinet_fortiedr)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- [Elastic Fortinet FortiEDR Integration Reference](https://www.elastic.co/docs/reference/integrations/fortinet_fortiedr)

This can be removed, it will just link to itself


Choose the setup instructions below that match your configuration:

#### Log file input configuration
Copy link
Contributor

Choose a reason for hiding this comment

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

I think log input is the least used input type, so I think it makes more sense to put this below the TCP/UDP sections

@elasticmachine
Copy link

💚 Build Succeeded

History

cc @taylor-swanson

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. enhancement New feature or request Integration:fortinet_fortiedr Fortinet FortiEDR Logs Team:Integration-Experience Security Integrations Integration Experience [elastic/integration-experience]

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants