Skip to main content

The CLIENT SETINFO command sets client library name and version information that will be shown in CLIENT LIST and CLIENT INFO commands. This helps identify which client library is being used and is useful for debugging and monitoring.

Warning

Upstash Redis does not allow CLIENT commands over the REST API, so clientSetinfo fails with ERR Command "CLIENT" is not allowed in REST.

Arguments#

attribute'LIB-NAME' | 'LIB-VER'required#

The attribute to set:

  • LIB-NAME or lib-name: Library name
  • LIB-VER or lib-ver: Library version
valuestringrequired#

The value to set for the attribute.

Response#

stringrequired

On Redis servers that allow CLIENT commands, returns OK if the attribute was set. Upstash Redis rejects the call (see the warning above).

Use Cases#

  • Debugging: Identify which client library version is being used
  • Monitoring: Track different client libraries connecting to Redis
  • Analytics: Understand client library distribution across connections
  • Support: Quickly identify client versions when troubleshooting issues

Viewing Client Information#

After setting client info, you can view it using the CLIENT LIST command:

Best Practices#

  1. Set on Connection: Set client info immediately after establishing a connection
  2. Include Version: Always set both library name and version
  3. Use Descriptive Names: Make library names easily identifiable
  4. Version Format: Use semantic versioning (e.g., “1.2.3”)
  5. Include Context: Add wrapper or framework info if applicable
Note

This command is available in Redis 7.2.0 and later. The attribute names are case-insensitive and will be normalized to uppercase.