IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

« Configuration Advanced configuration »

› ›

Basic configuration

edit

Basic configuration

edit

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::Transport::Transport::Connections::Selector::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.

« Configuration Advanced configuration »