{"record":{"id":"085357fa51ffb957","repo":"vllm-project/vllm","slug":"unknown-event-publisher-kind","errorCode":null,"errorMessage":"Unknown event publisher '{kind}'","messagePattern":"Unknown event publisher '(.+?)'","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"vllm/distributed/kv_events.py","lineNumber":559,"sourceCode":"    def create(\n        cls, config: KVEventsConfig | None, data_parallel_rank: int = 0\n    ) -> EventPublisher:\n        \"\"\"Create publisher from a config mapping.\"\"\"\n        if (\n            config is None\n            or not config.enable_kv_cache_events\n            or config.publisher == \"null\"\n        ):\n            return NullEventPublisher()\n\n        config_dict = asdict(config)\n\n        kind = config_dict.pop(\"publisher\")\n        config_dict.pop(\"enable_kv_cache_events\")\n        try:\n            constructor = cls._registry[kind]\n        except KeyError as exc:\n            raise ValueError(f\"Unknown event publisher '{kind}'\") from exc\n        return constructor(data_parallel_rank=data_parallel_rank, **config_dict)\n","sourceCodeStart":541,"sourceCodeEnd":561,"githubUrl":"https://github.com/vllm-project/vllm/blob/c794754062d49a8fdb63ab3c5215b488b865030c/vllm/distributed/kv_events.py#L541-L561","documentation":"Error \"Unknown event publisher '{kind}'\" thrown in vllm-project/vllm.","triggerScenarios":"Raised at vllm/distributed/kv_events.py:559 when validation fails: Unknown event publisher. Typically triggered by an incompatible or incomplete vLLM configuration, an unsupported platform/backend combination, or a runtime resource/dependency that is missing.","commonSituations":"Commonly encountered at vllm/distributed/kv_events.py:559 during vLLM startup/config validation or runtime setup when: (1) conflicting CLI flags or config fields are combined, (2) the current platform (CUDA/ROCm/CPU/XPU) or installed optional packages do not support the requested feature, or (3) a required value is absent or out of range. Resolve by correcting the configuration as described in the message, or by selecting a supported alternative.","solutions":["Use a known event publisher kind (e.g. 'zmq' or 'null')."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c794754062d49a8fdb63ab3c5215b488b865030c","analyzedAt":"2026-08-14T21:17:39.825Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}