Loading

Basic configuration

The table below contains the most important initialization parameters that you can use.

Parameter Data type Description
adapter Symbol A specific adapter for Faraday (for example, :patron).
api_key String, Hash For API key Authentication. Either the base64 encoding of id and api_key joined by a colon as a string, or a hash with the id and api_key values.
compression Boolean Whether to compress requests. Gzip compression is used. Defaults to false. Responses are automatically inflated if they are compressed. If a custom transport object is used, it must handle the request compression and response inflation.
enable_meta_header Boolean Whether to enable sending the meta data header to Cloud. Defaults to true.
hosts String, Array Single host passed as a string or hash, or multiple hosts passed as an array; host or url keys are also valid.
log Boolean Whether to use the default logger. Disabled by default.
logger Object An instance of a Logger-compatible object.
opaque_id_prefix String Sets a prefix for X-Opaque-Id when initializing the client. This is prepended to the id you set before each request if you’re using X-Opaque-Id.
opentelemetry_tracer_provider OpenTelemetry::Trace::TracerProvider An explicit TracerProvider to use instead of the global one with OpenTelemetry. This enables better dependency injection and simplifies testing.
randomize_hosts Boolean Whether to shuffle connections on initialization and reload. Defaults to false.
reload_connections Boolean, Number Whether to reload connections after X requests. Defaults to false.
reload_on_failure Boolean Whether to reload connections after failure. Defaults to false.
request_timeout Integer The request timeout to be passed to transport in options.
resurrect_after Integer Specifies after how many seconds a dead connection should be tried again.
retry_on_failure Boolean, Number Whether to retry X times when request fails before raising and exception. Defaults to false.
retry_on_status Array, Number Specifies which status code needs to be returned to retry.
selector Constant An instance of selector strategy implemented with {Elastic<>TransportTransport<>ConnectionsSelector::Base}.
send_get_body_as String Specifies the HTTP method to use for GET requests with a body. Defaults to GET.
serializer_class Constant Specifies a serializer class to use. It is initialized by the transport and passed the transport instance.
sniffer_timeout Integer Specifies the timeout for reloading connections in seconds. Defaults to 1.
trace Boolean Whether to use the default tracer. Disabled by default.
tracer Object Specifies an instance of a Logger-compatible object.
transport Object Specifies a transport instance.
transport_class Constant Specifies a transport class to use. It is initialized by the client and passed hosts and all arguments.
transport_options Hash Specifies the options to be passed to the Faraday::Connection constructor.