redis

func CacheTTL ¶

func CacheTTL(ttl time.Duration) FeatureStoreOption

CacheTTL creates an option for NewRedisFeatureStoreFactory to set the amount of time that recently read or updated items should remain in an in-memory cache. This reduces the amount of database access if the same feature flags are being evaluated repeatedly.

The default value is DefaultCacheTTL. A value of zero disables in-memory caching completely. A negative value means data is cached forever (i.e. it will only be read again from the database if the SDK is restarted). Use the "cached forever" mode with caution: it means that in a scenario where multiple processes are sharing the database, and the current process loses connectivity to LaunchDarkly while other processes are still receiving updates and writing them to the database, the current process will have stale data.

factory, err := redis.NewRedisFeatureStoreFactory(redis.CacheTTL(30*time.Second))

func DialOptions ¶

func DialOptions(options ...r.DialOption) FeatureStoreOption

DialOptions creates an option for NewRedisFeatureStoreFactory to specify any of the advanced Redis connection options supported by Redigo, such as DialPassword.

import (
    redigo "github.com/garyburd/redigo/redis"
    "gopkg.in/launchdarkly/go-server-sdk.v4/redis"
)
factory, err := redis.NewRedisFeatureStoreFactory(redis.DialOption(redigo.DialPassword("verysecure123")))

Note that some Redis client features can also be specified as part of the URL: see comments on the URL() option.

func HostAndPort ¶

func HostAndPort(host string, port int) FeatureStoreOption

HostAndPort creates an option for NewRedisFeatureStoreWithDefaults to specify the Redis host address as a hostname and port.

factory, err := redis.NewRedisFeatureStoreFactory(redis.HostAndPort("my-redis-host", 6379))

func Logger ¶

func Logger(logger ld.Logger) FeatureStoreOption

Logger creates an option for NewRedisFeatureStore, to specify where to send log output.

If you use NewConsulFeatureStoreFactory rather than the deprecated constructors, you do not need to specify a logger because it will use the same logging configuration as the SDK client.

store, err := redis.NewRedisFeatureStore(redis.Logger(myLogger))

func Pool ¶

func Pool(pool *r.Pool) FeatureStoreOption

Pool creates an option for NewRedisFeatureStoreFactory to make the feature store use a specific connection pool configuration. If not specified, it will create a default configuration (see package description). Specifying this option will cause any address specified with RedisURL or RedisHostAndPort to be ignored.

factory, err := redis.NewRedisFeatureStoreFactory(redis.Pool(myPool))

If you only need to change basic connection options such as providing a password, it is simpler to use DialOptions.

func Prefix ¶

func Prefix(prefix string) FeatureStoreOption

Prefix creates an option for NewRedisFeatureStoreFactory to specify a string that should be prepended to all Redis keys used by the feature store. A colon will be added to this automatically. If this is unspecified or empty, DefaultPrefix will be used.

factory, err := redis.NewRedisFeatureStoreFactory(redis.Prefix("ld-data"))

func URL ¶

func URL(url string) FeatureStoreOption

URL creates an option for NewRedisFeatureStoreFactory to specify the Redis host URL. If not specified, the default value is DefaultURL.

factory, err := redis.NewRedisFeatureStoreFactory(redis.URL("redis://my-redis-host:6379"))

Note that some Redis client features can also be specified as part of the URL: Redigo supports the redis:// syntax (https://www.iana.org/assignments/uri-schemes/prov/redis), which can include a password and a database number, as well as rediss:// (https://www.iana.org/assignments/uri-schemes/prov/rediss), which enables TLS.