MageSmith
MessageQueue · group Consumers · Magento 2.4.9

consumers_runner

consumers_runner is a Magento 2 cron job declared by the MessageQueue module in the Consumers group. It runs every minute (* * * * *) and dispatches Magento\MessageQueue\Model\Cron\ConsumersRunner::run() on every tick.

Wiring

Group
Consumers (consumers)
Module
MessageQueue (magento/module-message-queue)
Schedule
* * * * *
Frequency
every minute
Handler
Magento\MessageQueue\Model\Cron\ConsumersRunner::run()
Source file
vendor/magento/module-message-queue/etc/crontab.xml

Run the consumers_runner cron job manually

Magento doesn't have a per-job CLI invocation — the smallest unit is a group. The command below runs every job in the consumers group whose schedule is due. The --bootstrap flag bypasses the lock-file check so the job runs even when the system cron is configured.

php bin/magento cron:run --group=consumers --bootstrap=standaloneProcessStarted=1

Define your own job like this one

Want a job that fires on the same cadence in your own module? Drop these two files in — adjust the vendor/module namespace, the job name, and the body of run.

1. etc/crontab.xml

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Cron:etc/crontab.xsd">
    <group id="consumers">
        <job name="vendor_module_consumers_runner_clone"
             instance="Vendor\Module\Cron\ConsumersRunner"
             method="run">
            <schedule>* * * * *</schedule>
        </job>
    </group>
</config>

2. Cron handler class

<?php
declare(strict_types=1);

namespace Vendor\Module\Cron;

use Psr\Log\LoggerInterface;

class ConsumersRunner
{
    public function __construct(
        private readonly LoggerInterface $logger,
    ) {
    }

    public function run(): void
    {
        $this->logger->info('consumers_runner cron tick');

        // Your scheduled work here. Keep this short — long jobs
        // should enqueue work onto the message queue rather than
        // running inline in the cron tick.
    }
}

Need a full module scaffolded around this cron job? Module Generator wires the crontab.xml, handler class, and module registration for you.

Other cron jobs in MessageQueue

Sibling cron jobs declared by the same module. See all MessageQueue cron jobs →

Cron handlers often dispatch Magento 2 events on each tick — observers bound to those events run as part of the scheduled work. The CLI Reference covers cron:run, cron:install, and the rest of the cron:* namespace.

Every Magento dev tool, in one hosted workspace.

Free to sign up. Nothing to install. Drafts, audits, and projects saved across every tool.