Skip to content

Commit 77bca6f

Browse files
authored
[DOCS][8.x] Update creating-classic-plugins.asciidoc (#127378) (#127401)
Manual "backport" of https://github.com/elastic/elasticsearch/pull/127323/files
1 parent c8957e4 commit 77bca6f

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

docs/plugins/development/creating-classic-plugins.asciidoc

+8-2
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,14 @@ The entitlements currently implemented and enforced in {es} that are available t
8989

9090
===== `manage_threads`
9191

92-
Allows code to call methods that create or modify properties on Java Threads, for example `Thread#start` or `ThreadGroup#setMaxPriority`. In general, setting the name, priority, daemon state and context class loader are things no plugins should do when executing on
93-
{es} threadpools; however, many 3rd party libraries that support async operations (e.g. Apache HTTP client) need to manage their own threads. In this case it is justifiable to request this entitlement.
92+
Allows code to call methods that create or modify properties on Java Threads, for example `Thread#start` or `ThreadGroup#setMaxPriority`.
93+
94+
[NOTE]
95+
====
96+
This entitlement is rarely necessary. Your plugin should use {es} thread pools and executors (see `Plugin#getExecutorBuilders`) instead of creating and managing its own threads. Plugins should avoid modifying thread name, priority, daemon state, and context class loader when executing on ES threadpools.
97+
98+
However, many 3rd party libraries that support async operations, such as the Apache HTTP client, need to create and manage their own threads. In such cases, it makes sense to request this entitlement.
99+
====
94100

95101
Example:
96102
```yaml

0 commit comments

Comments
 (0)