Skip to main content

Redis

Experimental
Creates:
Assets

Configure in the UI

This plugin can be configured directly in the Marmot UI with a step-by-step wizard.

View Guide

The Redis plugin discovers logical databases (db0–db15) from Redis instances. It uses the INFO command to collect server metadata and parses the Keyspace section to identify databases that contain keys.

Required Permissions

The connecting user needs permission to run the INFO command. By default all users can run INFO, but if you are using Redis ACLs:

ACL SETUSER marmot_reader on >password ~* &* +info +ping +select

Example Configuration


host: "localhost"
port: 6379
password: "secret"
discover_all_databases: true
filter:
include:
- "^db[0-3]$"
tags:
- "redis"
- "cache"

Configuration

The following configuration options are available:

PropertyTypeRequiredDescription
dbintfalseDefault database number
discover_all_databasesboolfalseDiscover all databases with keys (db0-db15)
external_links[]ExternalLinkfalseExternal links to show on all assets
filterplugin.FilterfalseFilter databases by name pattern
hoststringfalseRedis server hostname or IP address
passwordstringfalsePassword for authentication
portintfalseRedis server port
tagsTagsConfigfalseTags to apply to discovered assets
tlsboolfalseEnable TLS connection
tls_insecureboolfalseSkip TLS certificate verification
usernamestringfalseUsername for ACL authentication

Available Metadata

The following metadata fields are available:

FieldTypeDescription
avg_ttl_msint64Average TTL in milliseconds
connected_clientsstringNumber of connected clients
databasestringDatabase name (e.g. db0)
expires_countint64Number of keys with an expiration
hoststringRedis server hostname
key_countint64Number of keys in the database
maxmemory_policystringEviction policy when maxmemory is reached
portintRedis server port
redis_versionstringRedis server version
rolestringReplication role (master/slave)
uptime_secondsstringServer uptime in seconds
used_memory_humanstringHuman-readable used memory