Skip to content

Conversation

Isengo1989
Copy link
Contributor

Add Redis Cache Tag Cleanup Documentation

What

Adds comprehensive documentation about Redis cache tag cleanup issues and solutions to the performance guides.

Why

Cache tags accumulate over time without proper cleanup, causing memory bloat in Redis. This addresses a common production issue with practical solutions.

Changes

  • New "Redis Cache Tag Cleanup" section in guides/hosting/performance/caches.md
  • Documents the problem, root causes, and solutions using FroshTools
  • Includes automation examples and best practices for production environments

Key additions

  • Problem explanation with Redis CLI verification examples
  • FroshTools cleanup commands (frosh:redis-namespace:cleanup, frosh:redis-tag:cleanup)
  • Deployment integration and cron job examples
  • Best practices for Redis cache management

Fixes documentation gap for teams using Redis as cache backend with cache.adapter.redis_tag_aware.

@Isengo1989 Isengo1989 requested a review from shyim August 14, 2025 12:00
@Isengo1989
Copy link
Contributor Author

@shyim, not sure if this is not better suited in the core 🤔 ? I am not aware of how often this happens in production environments, and therefore, it should be addressed in-house.


The [FroshTools](https://github.com/FriendsOfShopware/FroshTools) extension provides commands to clean up Redis namespaces and tags:

```bash
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we have here an experimental banner?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants