Skip to content

Latest commit

 

History

History
71 lines (70 loc) · 58.1 KB

ea-settings.md

File metadata and controls

71 lines (70 loc) · 58.1 KB

EA Settings

Name Type Default                               Description                                                             Validation                               Min Max
API_TIMEOUT number 30000 The number of milliseconds a request can be pending before returning a timeout error for data provider request - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 60000
API_VERBOSE boolean false Toggle whether the response from the EA should contain just the results or also include the full response body from the queried API.
BACKGROUND_EXECUTE_MS_HTTP number 1000 Time in milliseconds to sleep between HTTP transports' background execute calls, when there are no requests to send - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 10000
BACKGROUND_EXECUTE_MS_SSE number 1000 Time in milliseconds to sleep between SSE transports' background execute calls - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 10000
BACKGROUND_EXECUTE_MS_WS number 1000 Time in milliseconds to sleep between WS transports' background execute calls - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 10000
BACKGROUND_EXECUTE_TIMEOUT number 90000 The maximum amount of time in milliseconds to wait for a background execute to finish - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1000 600000
BASE_URL string / Starting path for the EA handler endpoint
CACHE_LOCK_DEFERRAL_MS number 60000 The amount of time (in ms) to wait before attempting to lock the cache
CACHE_LOCK_DURATION number 10000 Time (in ms) used as a baseline for the acquisition and extension of cache locks
CACHE_LOCK_RETRIES number 10 Number of retries to acquire a cache lock
CACHE_MAX_AGE number 90000 Maximum amount of time (in ms) that a response will stay cached - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1000 3600000
CACHE_MAX_ITEMS number 10000 The maximum number of items that remain in the cache - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1000 50000
CACHE_POLLING_MAX_RETRIES number 10 Max amount of times to attempt to find EA response in the cache after the Transport has been set up - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 20
CACHE_POLLING_SLEEP_MS number 200 The number of ms to sleep between each retry to fetch the EA response in the cache - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
10 1000
CACHE_PREFIX string Specifies a prefix to use for cache keys
CACHE_REDIS_CONNECTION_TIMEOUT number 15000 Connection timeout for redis client - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
3000 60000
CACHE_REDIS_HOST string 127.0.0.1 Hostname for the Redis instance to be used
CACHE_REDIS_MAX_RECONNECT_COOLDOWN number 3000 Max cooldown (in ms) before attempting redis reconnection - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
3000 10000
CACHE_REDIS_PASSWORD string undefined The password required for redis auth
CACHE_REDIS_PATH string undefined The UNIX socket string of the Redis server
CACHE_REDIS_PORT number 6379 Port for the Redis instance to be used - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 65535
CACHE_REDIS_TIMEOUT number 500 Timeout to fail a Redis server request if no response (ms) - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
500 10000
CACHE_REDIS_URL string undefined The URL of the Redis server. Format: [redis[s]:]//[[user][:password@]][host][:port][/db-number][?db=db-number[&password=bar[&option=value]]] - Value must be a valid URL
CACHE_TYPE enum local The type of cache to use throughout the EA
CENSOR_SENSITIVE_LOGS boolean false Controls whether the logging of sensitive information is enabled or disabled
COMPOSITE_TRANSPORT boolean false Whether to use enableCompositeTransport parameter in AdapterEndpoint
CORRELATION_ID_ENABLED boolean true Flag to enable correlation IDs for sent requests in logging
DEBUG boolean false Toggles debug mode
DEBUG_ENDPOINTS boolean false Whether to enable debug enpoints (/debug/*) for this adapter. Enabling them might consume more resources.
DEFAULT_CACHE_KEY string DEFAULT_CACHE_KEY Default key to be used when one cannot be determined from request parameters
EA_HOST string :: Host this EA will listen for REST requests on (if mode is set to "reader" or "reader-writer") - Value must be a valid IP address
EA_MODE enum reader-writer Port this EA will listen for REST requests on (if mode is set to "reader" or "reader-writer")
EA_PORT number 8080 Port through which the EA will listen for REST requests (if mode is set to "reader" or "reader-writer") - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 65535
EXPERIMENTAL_METRICS_ENABLED boolean true Flag to specify whether or not to collect metrics. Used as fallback for METRICS_ENABLED
FEED_ID_JSON boolean false Flag to specify whether make feed id always a JSON string or not
LOG_LEVEL string info Minimum level required for logs to be output
MAX_COMMON_KEY_SIZE number 300 Maximum amount of characters that the common part of the cache key or feed ID can have - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
150 500
MAX_HTTP_REQUEST_QUEUE_LENGTH number 200 The maximum amount of queued requests for Http transports before new ones push oldest ones out of the queue - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 2000
MAX_PAYLOAD_SIZE_LIMIT number 1048576 Max payload size limit for the Fastify server - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1048576 1073741824
MAX_WS_CONNECTION_AGE_SECONDS number undefined Opt-in maximum age (in seconds) a WebSocket connection is allowed to live before the adapter proactively closes and reopens it, to avoid the risk of it going stale on the data provider side. A hardcoded 20% jitter is subtracted from this value so that not all instances reconnect at the same time (the connection will never live longer than this value). Disabled (no forced reconnection) by default. - Value must be an integer
- Value must be above the minimum
300
METRICS_ENABLED boolean true Flag to specify whether or not to startup the metrics server
METRICS_PORT number 9080 Port metrics will be exposed to - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 65535
METRICS_USE_BASE_URL boolean undefined Flag to specify whether or not to prepend the BASE_URL to the metrics endpoint
MTLS_ENABLED boolean false Flag to specify whether mutual TLS/SSL is enabled or not
RATE_LIMIT_API_TIER string undefined Rate limiting tier to use from the available options for the adapter. If not present, the adapter will run using the first tier on the list.
RATE_LIMIT_CAPACITY number undefined Used as rate limit capacity per minute and ignores tier settings if defined - Value must be an integer
- Value must be above the minimum
0
RATE_LIMIT_CAPACITY_MINUTE number undefined Used as rate limit capacity per minute and ignores tier settings if defined. Supercedes RATE_LIMIT_CAPACITY if both vars are set - Value must be an integer
- Value must be above the minimum
0
RATE_LIMIT_CAPACITY_SECOND number undefined Used as rate limit capacity per second and ignores tier settings if defined - Value must be an integer
- Value must be above the minimum
0
RATE_LIMITING_STRATEGY enum fixed-interval The rate limiting strategy to use for outbound requests
REQUESTER_SLEEP_BEFORE_REQUEUEING_MS number 0 Time to sleep after a failed HTTP request before re-queueing the request (in ms) - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 120000
RETRY number 1 Retry count for failed HTTP requests - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 10
SSE_KEEPALIVE_SLEEP number 60000 Maximum amount of time (in ms) between each SSE keepalive request - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 120000
SSE_SUBSCRIPTION_TTL number 300000 Maximum amount of time (in ms) an SSE subscription will be cached before being unsubscribed - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 3600000
STREAM_HANDLER_RETRY_EXP_FACTOR number 3 The factor for exponential back-off to wait before running the stream handler (1 = no change from STREAM_HANDLER_RETRY_MIN_MS) - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1 10
STREAM_HANDLER_RETRY_MAX_MS number 1200000 The maximum time (ms) to wait before running the stream handler (takes precedent over STREAM_HANDLER_RETRY_MIN_MS - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
3000 86400000
STREAM_HANDLER_RETRY_MIN_MS number 100 The minimum/base time (ms) to wait before trying to run the stream handler - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
100 10000
SUBSCRIPTION_SET_MAX_ITEMS number 10000 The maximum number of subscriptions set - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1000 10000
TLS_CA string undefined CA certificate to use for authenticating client certificates
TLS_ENABLED boolean false Flag to specify whether TLS/SSL is enabled or not
TLS_PASSPHRASE string Password to be used to generate an encryption key
TLS_PRIVATE_KEY string undefined Base64 Private Key of TSL/SSL certificate - Value must be a valid base64 string
TLS_PUBLIC_KEY string undefined Base64 Public Key of TSL/SSL certificate - Value must be a valid base64 string
WARMUP_SUBSCRIPTION_TTL number 300000 TTL for batch warmer subscriptions - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 3600000
WS_CONNECTION_OPEN_TIMEOUT number 10000 The maximum amount of time in milliseconds to wait for the websocket connection to open (including custom open handler) - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
500 30000
WS_HEARTBEAT_INTERVAL_MS number 10000 The number of ms between each hearbeat message that EA sends to server, only works if heartbeat handler is provided - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
5000 300000
WS_SUBSCRIPTION_TTL number 120000 The time in ms a request will live in the subscription set before becoming stale - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
0 3600000
WS_SUBSCRIPTION_UNRESPONSIVE_TTL number 120000 The maximum acceptable time (in milliseconds) since the last message was received and stored in the cache on a WebSocket connection before it is considered unresponsive, causing the adapter to close and attempt to reopen it. - Value must be an integer
- Value must be above the minimum
- Value must be below the maximum
1000 180000