Stabilize disaggregated decode burst handoff
Burst decode can sit in disaggregation prealloc/transfer queues while health probes still need an immediate scheduler-alive response, and EAGLE prebuilt metadata must outlive the synthetic prebuilt step until the first real decode consume. The transfer path also needs to send final aux metadata even when there are no new KV pages in the final chunk. This keeps decode metadata slot ownership narrow instead of cloning EAGLE tensors, adds fail-safe cleanup for prebuilt exceptions/finished prebuilt requests, fixes final empty chunk metadata transfer, and records the investigation ledger for future debugging. Constraint: bs=1 historically worked, so decode compute/sampling behavior must not be changed without direct evidence. Rejected: Clone EAGLE metadata tensors on transfer commit | avoids lifetime issues but adds hot-path CPU/GPU memory traffic. Rejected: Treat prefill AbortReq logs as root cause | current evidence shows they can be downstream of decode/router aborts. Confidence: medium Scope-risk: moderate Directive: Do not move EAGLE metadata slot release earlier than first real decode result processing without proving the H2D/spec_info consume point changed. Tested: g0034 docker py_compile for touched scheduler/disagg/test files; PYTHONPATH=python python -m pytest -q test/registered/unit/disaggregation/test_decode_queue_compaction.py test/registered/unit/mem_cache/test_req_to_token_pool.py test/registered/unit/managers/test_scheduler_health_check.py -> 24 passed Not-tested: Fresh end-to-end burst traffic after restart; decode node_rank=1 persistent log capture.
This commit is contained in:
@@ -14,7 +14,10 @@ from sglang.srt.disaggregation.decode import (
|
||||
DecodeTransferQueue,
|
||||
SchedulerDisaggregationDecodeMixin,
|
||||
)
|
||||
from sglang.srt.disaggregation.utils import ReqToMetadataIdxAllocator
|
||||
from sglang.srt.disaggregation.utils import (
|
||||
DisaggregationMode,
|
||||
ReqToMetadataIdxAllocator,
|
||||
)
|
||||
from sglang.srt.managers.scheduler_output_processor_mixin import (
|
||||
SchedulerOutputProcessorMixin,
|
||||
)
|
||||
@@ -41,6 +44,13 @@ class FakeReq:
|
||||
self.cached_tokens = 0
|
||||
self.init_next_round_calls = []
|
||||
self.sampling_params = SimpleNamespace(max_new_tokens=0)
|
||||
self.return_hidden_states = False
|
||||
self.grammar = None
|
||||
self.token_ids_logprob = None
|
||||
self.top_logprobs_num = 0
|
||||
self.multimodal_inputs = None
|
||||
self.mamba_ping_pong_track_buffer = None
|
||||
self.to_finish = None
|
||||
|
||||
class FakeTimeStats:
|
||||
def __init__(self):
|
||||
@@ -64,6 +74,12 @@ class FakeReq:
|
||||
def set_quick_finish_time(self):
|
||||
return None
|
||||
|
||||
def set_last_decode_finish_time(self):
|
||||
return None
|
||||
|
||||
def set_completion_time(self):
|
||||
return None
|
||||
|
||||
self.time_stats = FakeTimeStats()
|
||||
|
||||
def add_latency(self, stage):
|
||||
@@ -75,7 +91,7 @@ class FakeReq:
|
||||
def init_next_round_input(self, tree_cache):
|
||||
self.init_next_round_calls.append(tree_cache)
|
||||
|
||||
def check_finished(self):
|
||||
def check_finished(self, *args):
|
||||
return None
|
||||
|
||||
def finished(self):
|
||||
@@ -146,6 +162,18 @@ class FakeAllocator(ReqToMetadataIdxAllocator):
|
||||
self.freed.append(free_index)
|
||||
|
||||
|
||||
class FakeTokenToKVAllocator:
|
||||
def __init__(self):
|
||||
self.begin_calls = 0
|
||||
self.end_calls = 0
|
||||
|
||||
def free_group_begin(self):
|
||||
self.begin_calls += 1
|
||||
|
||||
def free_group_end(self):
|
||||
self.end_calls += 1
|
||||
|
||||
|
||||
class TestDecodeQueueCompaction(CustomTestCase):
|
||||
def test_decode_transfer_queue_compacts_in_one_pass(self):
|
||||
streamed = []
|
||||
@@ -692,12 +720,127 @@ class TestDecodeQueueCompaction(CustomTestCase):
|
||||
captured["batch"].processed,
|
||||
[(scheduler.server_args, scheduler.future_map)],
|
||||
)
|
||||
self.assertEqual(allocator.freed, [20, 21, 22])
|
||||
# EAGLE metadata slots are intentionally held past process_prebuilt().
|
||||
# The initial draft state is consumed by the first real decode forward,
|
||||
# so releasing here would let burst transfers overwrite the pinned CPU
|
||||
# source views before the GPU copy/consume is complete.
|
||||
self.assertEqual(allocator.freed, [])
|
||||
for req in captured["reqs"]:
|
||||
self.assertEqual(req.metadata_buffer_index, -1)
|
||||
self.assertIsNone(getattr(req, "output_topk_p", None))
|
||||
self.assertIsNone(getattr(req, "output_topk_index", None))
|
||||
self.assertIsNone(getattr(req, "hidden_states_tensor", None))
|
||||
self.assertGreaterEqual(req.metadata_buffer_index, 20)
|
||||
|
||||
def test_get_new_prebuilt_batch_frees_metadata_on_prebuilt_error(self):
|
||||
allocator = FakeAllocator()
|
||||
scheduler = cast(Any, SimpleNamespace())
|
||||
scheduler.grammar_manager = SimpleNamespace(
|
||||
has_waiting_grammars=lambda: False,
|
||||
get_ready_grammar_requests=lambda: [],
|
||||
)
|
||||
scheduler._add_request_to_queue = lambda req: None
|
||||
req0 = FakeReq("req-0", 0)
|
||||
scheduler.waiting_queue = [req0]
|
||||
scheduler.running_batch = SimpleNamespace(batch_size=lambda: 0)
|
||||
scheduler.req_to_token_pool = SimpleNamespace(size=8)
|
||||
scheduler.max_running_requests = 8
|
||||
scheduler.tree_cache = object()
|
||||
scheduler.token_to_kv_pool_allocator = object()
|
||||
scheduler.model_config = object()
|
||||
scheduler.enable_overlap = False
|
||||
scheduler.spec_algorithm = object()
|
||||
scheduler.server_args = object()
|
||||
scheduler.future_map = object()
|
||||
scheduler.req_to_metadata_buffer_idx_allocator = allocator
|
||||
scheduler._free_decode_metadata_index_if_held = (
|
||||
SchedulerOutputProcessorMixin._free_decode_metadata_index_if_held.__get__(
|
||||
scheduler
|
||||
)
|
||||
)
|
||||
req0.metadata_buffer_index = 42
|
||||
|
||||
class FailingBatch(FakeBatch):
|
||||
def process_prebuilt(self, server_args, future_map):
|
||||
raise RuntimeError("prebuilt failed")
|
||||
|
||||
with patch(
|
||||
"sglang.srt.disaggregation.decode.ScheduleBatch.init_new",
|
||||
lambda reqs, *args, **kwargs: FailingBatch(),
|
||||
):
|
||||
with self.assertRaisesRegex(RuntimeError, "prebuilt failed"):
|
||||
SchedulerDisaggregationDecodeMixin.get_new_prebuilt_batch(scheduler)
|
||||
|
||||
self.assertEqual(allocator.freed, [42])
|
||||
self.assertEqual(req0.metadata_buffer_index, -1)
|
||||
|
||||
def test_process_batch_result_prebuilt_frees_finished_metadata(self):
|
||||
allocator = FakeAllocator()
|
||||
scheduler = SchedulerOutputProcessorMixin.__new__(SchedulerOutputProcessorMixin)
|
||||
scheduler.disaggregation_mode = DisaggregationMode.DECODE
|
||||
scheduler.req_to_metadata_buffer_idx_allocator = allocator
|
||||
scheduler.tree_cache = object()
|
||||
scheduler.stream_output = lambda reqs, return_logprob: None
|
||||
|
||||
req = FakeReq("finished", 0)
|
||||
req.metadata_buffer_index = 43
|
||||
req.output_topk_p = torch.ones((1,), dtype=torch.float32)
|
||||
req.output_topk_index = torch.ones((1,), dtype=torch.int64)
|
||||
req.hidden_states_tensor = torch.ones((4,), dtype=torch.float32)
|
||||
req.finished_reason = FINISH_ABORT("done")
|
||||
batch = SimpleNamespace(reqs=[req], return_logprob=False)
|
||||
|
||||
with patch(
|
||||
"sglang.srt.managers.scheduler_output_processor_mixin.release_kv_cache",
|
||||
lambda *args, **kwargs: None,
|
||||
):
|
||||
scheduler.process_batch_result_prebuilt(batch)
|
||||
|
||||
self.assertEqual(allocator.freed, [43])
|
||||
self.assertEqual(req.metadata_buffer_index, -1)
|
||||
|
||||
def test_process_batch_result_decode_releases_prebuilt_metadata_after_consume(self):
|
||||
allocator = FakeAllocator()
|
||||
token_allocator = FakeTokenToKVAllocator()
|
||||
scheduler = SchedulerOutputProcessorMixin.__new__(SchedulerOutputProcessorMixin)
|
||||
scheduler.req_to_metadata_buffer_idx_allocator = allocator
|
||||
scheduler.server_args = SimpleNamespace(
|
||||
disaggregation_decode_enable_offload_kvcache=False
|
||||
)
|
||||
scheduler.enable_hisparse = False
|
||||
scheduler.enable_overlap = False
|
||||
scheduler.enable_metrics = False
|
||||
scheduler.token_to_kv_pool_allocator = token_allocator
|
||||
scheduler.tree_cache = object()
|
||||
scheduler.forward_ct_decode = 0
|
||||
scheduler.num_generated_tokens = 0
|
||||
scheduler.stream_output = lambda reqs, return_logprob: None
|
||||
scheduler.report_decode_stats = lambda *args, **kwargs: None
|
||||
scheduler.update_spec_metrics = lambda *args, **kwargs: None
|
||||
scheduler._maybe_log_eagle_accept_debug = lambda *args, **kwargs: None
|
||||
|
||||
req = FakeReq("decode", 0)
|
||||
req.metadata_buffer_index = 44
|
||||
req.output_topk_p = torch.ones((1,), dtype=torch.float32)
|
||||
req.output_topk_index = torch.ones((1,), dtype=torch.int64)
|
||||
req.hidden_states_tensor = torch.ones((4,), dtype=torch.float32)
|
||||
batch = SimpleNamespace(
|
||||
reqs=[req],
|
||||
return_logprob=False,
|
||||
spec_algorithm=SimpleNamespace(is_none=lambda: True),
|
||||
is_spec_v2=False,
|
||||
)
|
||||
result = SimpleNamespace(
|
||||
copy_done=None,
|
||||
logits_output=SimpleNamespace(hidden_states=None, customized_info=None),
|
||||
next_token_ids=torch.tensor([5], dtype=torch.int64),
|
||||
can_run_cuda_graph=True,
|
||||
num_accepted_tokens=1,
|
||||
)
|
||||
|
||||
scheduler.process_batch_result_decode(batch, result)
|
||||
|
||||
self.assertEqual(allocator.freed, [44])
|
||||
self.assertEqual(req.metadata_buffer_index, -1)
|
||||
self.assertEqual(req.output_ids, [5])
|
||||
self.assertEqual(token_allocator.begin_calls, 1)
|
||||
self.assertEqual(token_allocator.end_calls, 1)
|
||||
|
||||
def test_get_new_prebuilt_batch_keeps_waiting_queue_when_no_capacity(self):
|
||||
scheduler = cast(Any, SimpleNamespace())
|
||||
|
||||
Reference in New Issue
Block a user