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.

@Isengo1989
Copy link
Contributor Author

Maybe we can move this to draft until the feature is out of the experimental phase. Also saw there is an open PR on this topic for some time

FriendsOfShopware/FroshTools#367

@Isengo1989 Isengo1989 marked this pull request as draft October 14, 2025 08:04
@Isengo1989 Isengo1989 added the Blocked Block PRs from merging label Oct 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Blocked Block PRs from merging

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants