From 1dff7c655a74445c957ceb7109efd8c62e686152 Mon Sep 17 00:00:00 2001
From: natasha-moore-elastic
 <137783811+natasha-moore-elastic@users.noreply.github.com>
Date: Tue, 1 Aug 2023 14:17:42 +0100
Subject: [PATCH] [DOCS] Advise users to migrate from Filebeat to Elastic Agent
 (#36157)

## What does this PR do?

Adds a note to
[Modules](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-modules.html)
to advise users to migrate to Elastic Agent.

Preview:
[Modules](https://beats_36157.docs-preview.app.elstc.co/guide/en/beats/filebeat/master/filebeat-modules.html)

## Why is it important?

While Filebeat modules are still supported, we do not typically apply
bug fixes or enhancements to these modules, or ship any new modules. Our
focus is now entirely on Elastic Agent integrations.

## Checklist

<!-- Mandatory
Add a checklist of things that are required to be reviewed in order to
have the PR approved

List here all the items you have verified BEFORE sending this PR. Please
DO NOT remove any item, striking through those that do not apply. (Just
in case, strikethrough uses two tildes. ~~Scratch this.~~)
-->

- [x] My code follows the style guidelines of this project
~~- [ ] I have commented my code, particularly in hard-to-understand
areas~~ N/A
- [x] I have made corresponding changes to the documentation
~~- [ ] I have made corresponding change to the default configuration
files~~ N/A
~~- [ ] I have added tests that prove my fix is effective or that my
feature works~~ N/A
~~- [ ] I have added an entry in `CHANGELOG.next.asciidoc` or
`CHANGELOG-developer.next.asciidoc`.~~ N/A

## Related issues

* Resolves https://github.com/elastic/security-docs/issues/3576

---------

Co-authored-by: Janeen Mikell Roberts <57149392+jmikell821@users.noreply.github.com>
Co-authored-by: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com>
(cherry picked from commit e1267beba3110e117ead1def011b44233ae5a058)
---
 filebeat/docs/modules.asciidoc | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/filebeat/docs/modules.asciidoc b/filebeat/docs/modules.asciidoc
index efe3f1724895..9de23994c656 100644
--- a/filebeat/docs/modules.asciidoc
+++ b/filebeat/docs/modules.asciidoc
@@ -9,4 +9,6 @@ modules.
 
 Filebeat modules require Elasticsearch 5.2 or later.
 
+NOTE: While {filebeat} modules are still supported, we recommend {agent} integrations over {filebeat} modules. Integrations provide a streamlined way to connect data from a variety of vendors to the {stack}. Refer to the https://www.elastic.co/integrations/data-integrations[full list of integrations]. For more information, please refer to the {fleet-guide}/beats-agent-comparison.html[{beats} vs {agent} comparison documentation].
+
 include::modules_list.asciidoc[]