Skip to content

Commit 5e20b22

Browse files
Fleetserver connectivity requirments when using an elasticsearch remote output (#4244)
In addition to connectivity check the fleet server also creates apikeys using the service token. This is currently not documented well, moreover we currently lead users astray telling them to ignore the output health. This PR only addresses the note, a more elaborate section should be added to guide the user. <!-- Thank you for contributing to the Elastic Docs! 🎉 Use this template to help us efficiently review your contribution. --> ## Summary <!-- Describe what your PR changes or improves. If your PR fixes an issue, link it here. If your PR does not fix an issue, describe the reason you are making the change. --> ## Generative AI disclosure <!-- To help us ensure compliance with the Elastic open source and documentation guidelines, please answer the following: --> 1. Did you use a generative AI (GenAI) tool to assist in creating this contribution? - [ ] Yes - [x] No <!-- 2. 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: --> --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> Co-authored-by: Visha Angelova <visha.angelova@elastic.co>
1 parent 53ea231 commit 5e20b22

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

reference/fleet/remote-elasticsearch-output.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ A remote {{es}} cluster supports the same [output settings](/reference/fleet/es-
2121

2222
These limitations apply to remote {{es}} output:
2323

24+
* {{fleet-server}} must be able to reach the remote {{es}} cluster with a service token to create API keys for any {{agents}} that use the remote {{es}} output.
2425
* Using a remote {{es}} output with a target cluster that has [network security](/deploy-manage/security/network-security.md) enabled is not currently supported.
2526
* Using {{elastic-defend}} when a remote {{es}} output is configured for an {{agent}} is not currently supported.
2627

@@ -118,5 +119,5 @@ If you choose not to synchronize integrations automatically, you need to make su
118119
::::{note}
119120
When you use a remote {{es}} output, {{fleet-server}} performs a test to ensure connectivity to the remote cluster. The result of that connectivity test is used to report whether the remote output is healthy or unhealthy, and is displayed on the **{{fleet}}****Settings****Outputs** page, in the **Status** column.
120121

121-
In some cases, the remote {{es}} output used for {{agent}} data can be reached by the {{agent}}s but not by {{fleet-server}}. In those cases, you can ignore the resulting unhealthy state of the output and the associated `Unable to connect` error on the UI.
122+
In some cases, the remote {{es}} output used for {{agent}} data can be reached by the {{agents}} but not by {{fleet-server}}. This will result in the unhealthy status of the output and an `Unable to connect` error on the UI. To generate API keys for {{agents}}, {{fleet-server}} requires connectivity to the remote cluster.
122123
::::

0 commit comments

Comments
 (0)