Redis connector reference


Redis connector referenceedit

The Redis connector is built with the Elastic connectors Python framework and is available as a self-managed connector client. View the source code for this connector (branch 8.13, compatible with Elastic 8.13).

Availability and prerequisitesedit

This connector was introduced in Elastic 8.13.0, available as a self-managed connector client.

To use this connector, satisfy all connector client prerequisites. Importantly, you must deploy the connectors service on your own infrastructure. You have two deployment options:

This connector is in technical preview and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Technical preview features are not subject to the support SLA of official GA features.


To set up this connector in the UI, select the Redis tile when creating a new connector under Search → Connectors.

For additional operations, see Using connectors.

Deploy with Dockeredit

You can deploy the Redis connector as a self-managed connector client using Docker. Follow these instructions.

Step 1: Download sample configuration file

Download the sample configuration file. You can either download it manually or run the following command:

curl --output ~/connectors-config/config.yml

Remember to update the --output argument value if your directory name is different, or you want to use a different config file name.

Step 2: Update the configuration file for your self-managed connector

Update the configuration file with the following settings to match your environment:

  • elasticsearch.api_key
  • connectors

If you’re running the connector service against a Dockerized version of Elasticsearch and Kibana, your config file will look like this:

# When connecting to your cloud deployment you should edit the host value http://host.docker.internal:9200
elasticsearch.api_key: <ELASTICSEARCH_API_KEY>

    connector_id: <CONNECTOR_ID_FROM_KIBANA>
    service_type: redis
    api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead

Using the elasticsearch.api_key is the recommended authentication method. However, you can also use elasticsearch.username and elasticsearch.password to authenticate with your Elasticsearch instance.

Note: You can change other default configurations by simply uncommenting specific settings in the configuration file and modifying their values.

Step 3: Run the Docker image

Run the Docker image with the Connector Service using the following command:

docker run \
-v ~/connectors-config:/config \
--network "elastic" \
--tty \
--rm \ \
/app/bin/elastic-ingest \
-c /config/config.yml

Refer to in the elastic/connectors repo for more details.

Find all available Docker images in the official registry.

We also have a quickstart self-managed option using Docker Compose, so you can spin up all required services at once: Elasticsearch, Kibana, and the connectors service. Refer to this README in the elastic/connectors repo for more information.


host (required)

The IP of your Redis server/cloud. Example:

port (required)

Port where the Redis server/cloud instance is hosted. Example:

  • 6379
username (optional)

Username for your Redis server/cloud. Example:

  • default
password (optional)

Password for your Redis server/cloud instance. Example:

  • changeme
database (required)

List of database index for your Redis server/cloud. * will fetch data from all databases. Example:

  • 0,1,2
  • *

    This field is ignored when using advanced sync rules.

Toggle to use SSL/TLS. Disabled by default.
Toggle to use secure mutual SSL/TLS. Ensure that your Redis deployment supports mutual SSL/TLS connections. Disabled by default. Depends on ssl_enabled.
Specifies the certificate from the Certificate Authority. The value of the certificate is used to validate the certificate presented by the Redis instance. Depends on mutual_tls_enabled.
Specifies the client private key. The value of the key is used to validate the connection in the Redis instance. Depends on mutual_tls_enabled.

Documents and syncsedit

The connector syncs the following objects and entities:

  • KEYS and VALUES of every database index
  • Permissions are not synced. All documents indexed to an Elastic deployment will be visible to all users with access to the relevant Elasticsearch index.

Sync rulesedit

Basic sync rules are identical for all connectors and are available by default.

Advanced Sync Rulesedit

Advanced sync rules are defined through a source-specific DSL JSON snippet.

Use advanced sync rules to filter data at the Redis source, without needing to index all data into Elasticsearch.

They take the following parameters:

  1. database: Specify the Redis database index as an integer value.
  2. key_pattern: 2. key_pattern: Pattern for finding keys in Redis.
  3. type: Key type for the Redis.

    Supported values:

    • HASH
    • LIST
    • SET
    • STREAM
    • STRING
    • ZSET

Provide at least one of the following: key_pattern or type, or both.

Advanced sync rules examplesedit

Example 1edit

Fetch database records where keys start with alpha:

    "database": 0,
    "key_pattern": "alpha*"
Example 2edit

Fetch database records with exact match by specifying the full key name:

    "database": 0,
    "key_pattern": "alpha"
Example 3edit

Fetch database records where keys start with test1, test2 or test3:

    "database": 0,
    "key_pattern": "test[123]"
Example 4edit

Exclude database records where keys start with test1, test2 or test3:

    "database": 0,
    "key_pattern": "test[^123]"
Example 5edit

Fetch all database records:

    "database": 0,
    "key_pattern": "*"
Example 6edit

Fetch all database records where type is SET:

    "database": 0,
    "key_pattern": "*",
    "type": "SET"
Example 7edit

Fetch database records where type is SET:

    "database": 0,
    "type": "SET"

Connector Client operationsedit

End-to-end Testingedit

The connector framework enables operators to run functional tests against a real data source, using Docker Compose. You don’t need a running Elasticsearch instance or Redis source to run this test.

Refer to Connector testing for more details.

To perform E2E testing for the Redis connector, run the following command:

$ make ftest NAME=redis

For faster tests, add the DATA_SIZE=small flag:

make ftest NAME=redis DATA_SIZE=small


Known issuesedit

  • The last modified time is unavailable when retrieving keys/values from the Redis database. As a result, all objects are indexed each time an advanced sync rule query is executed.

Refer to Known issues for a list of known issues for all connectors.


See Troubleshooting.


See Security.