You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This mode performs flag evaluations locally (in-process). Flag configurations for evaluation are obtained via gRPC protocol using [sync protobuf schema](https://buf.build/open-feature/flagd/file/main:sync/v1/sync_service.proto) service definition.
38
38
39
-
Consider following example to create a `FlagdProvider` with in-process evaluations,
39
+
Consider the following example to create a `FlagdProvider` with in-process evaluations,
40
40
41
41
```java
42
42
FlagdProvider flagdProvider =newFlagdProvider(
@@ -47,8 +47,8 @@ FlagdProvider flagdProvider = new FlagdProvider(
47
47
48
48
In the above example, in-process handlers attempt to connect to a sync service on address `localhost:8013` to obtain [flag definitions](https://github.com/open-feature/schemas/blob/main/json/flagd-definitions.json).
49
49
50
-
In-process resolver can also work in an offline mode. To enable this mode, you should provide a valid flag configuration file with the option `offlineFlagSourcePath`.
51
-
The file must contain a valid flagd flag source file.
50
+
In-process resolvers can also work in an offline mode.
51
+
To enable this mode, you should provide a valid flag configuration file with the option `offlineFlagSourcePath`.
52
52
53
53
```java
54
54
FlagdProvider flagdProvider =newFlagdProvider(
@@ -59,7 +59,7 @@ FlagdProvider flagdProvider = new FlagdProvider(
59
59
```
60
60
61
61
Provider will not detect file changes nor re-read the file after the initial read.
62
-
This mode is useful for local development, test cases and for offline application.
62
+
This mode is useful for local development, test cases, and offline applications.
63
63
For a full-featured, production-ready file-based implementation, use the RPC evaluator in combination with the flagd standalone application, which can be configured to watch files for changes.
64
64
65
65
### Configuration options
@@ -90,13 +90,13 @@ Given below are the supported configurations:
90
90
91
91
### Unix socket support
92
92
93
-
Unix socket communication with flag is facilitated via usage of the linux-native `epoll` library on `linux-x86_64`
94
-
only (ARM support is pending relase of `netty-transport-native-epoll` v5). Unix sockets are not supported on other
93
+
Unix socket communication with flagd is facilitated by usaging of the linux-native `epoll` library on `linux-x86_64`
94
+
only (ARM support is pending the release of `netty-transport-native-epoll` v5). Unix sockets are not supported on other
95
95
platforms or architectures.
96
96
97
97
### Reconnection
98
98
99
-
Reconnection is supported by the underlying GRPCBlockingStub. If connection to flagd is lost, it will reconnect
99
+
Reconnection is supported by the underlying GRPCBlockingStub. If the connection to flagd is lost, it will reconnect
100
100
automatically.
101
101
102
102
### Deadline (gRPC call timeout)
@@ -106,7 +106,7 @@ If the gRPC call is not completed within this deadline, the gRPC call is termina
106
106
and the evaluation will default.
107
107
The default deadline is 500ms, though evaluations typically take on the order of 10ms.
108
108
For the in-process provider, the deadline is used when establishing the initial streaming connection.
109
-
A failure to connect within this timeout will result an [error event](https://openfeature.dev/docs/reference/concepts/events#provider_error) from the provider, though it will attempt to reconnect indefinitely.
109
+
A failure to connect within this timeout will result in an [error event](https://openfeature.dev/docs/reference/concepts/events#provider_error) from the provider, though it will attempt to reconnect indefinitely.
110
110
111
111
### TLS
112
112
@@ -129,34 +129,34 @@ FlagdProvider flagdProvider = new FlagdProvider(
129
129
### Caching (RPC only)
130
130
131
131
> [!NOTE]
132
-
> The in-process resolver does not benefit from caching, since all evaluations are done locally and do not involve I/O.
132
+
> The in-process resolver does not benefit from caching since all evaluations are done locally and do not involve I/O.
133
133
134
134
The provider attempts to establish a connection to flagd's event stream (up to 5 times by default).
135
-
If the connection is successful and caching is enabled each flag returned with reason `STATIC` is cached until an event is received
136
-
concerning the cached flag (at which point it is removed from cache).
135
+
If the connection is successful and caching is enabled, each flag returned with the reason `STATIC` is cached until an event is received
136
+
concerning the cached flag (at which point it is removed from the cache).
137
137
138
-
On invocation of a flag evaluation (if caching is available) an attempt is made to retrieve the entry from cache, if
139
-
found the flag is returned with reason `CACHED`.
138
+
On invocation of a flag evaluation (if caching is available), an attempt is made to retrieve the entry from the cache, if
139
+
found the flag is returned with the reason `CACHED`.
140
140
141
141
By default, the provider is configured to
142
142
use [least recently used (lru)](https://commons.apache.org/proper/commons-collections/apidocs/org/apache/commons/collections4/map/LRUMap.html)
143
143
caching with up to 1000 entries.
144
144
145
145
### OpenTelemetry tracing (RPC only)
146
146
147
-
flagd provider support OpenTelemetry traces for gRPCbacked remote evaluations.
147
+
flagd provider support OpenTelemetry traces for gRPC-backed remote evaluations.
148
148
149
149
There are two ways you can configure OpenTelemetry for the provider,
0 commit comments