Files
kumomta/docs/reference/http/proxy-server/api_admin_task_dump_get.md
T
Wez Furlong 1c5221ba00 add /api/admin/task-dump api endpoint
This dumps out a trace of all tokio tasks.  It is quite expensive,
and currently unsettles the tokio runtime such that you need to
repeatedly call this endpoint in order for a subsequent graceful
shutdown to clock through and complete.
2026-03-11 15:19:23 +00:00

1.0 KiB

tags
tags
debugging

GET /api/admin/task-dump

!!! info This page was generated by extracting information from a JSON Schema data file for the API. It may be missing some information, or otherwise suggest approximate or placeholder values based on information in the schema file; this is due to limitations on how that data is extracted from the underlying Rust code and into the JSON Schema, and then again from there and into these docs.

Returns a dump of the runtime task state. {{since('dev')}}

The output is not machine parseable and may change without notice between versions of kumomta.

Capturing the dump is very expensive and can take several seconds. Capturing a dump is not guaranteed to succeed.

At the time of writing, capturing a dump can cause a subsequent graceful shutdown to get stuck, unless you repeatedly trigger this API endpoint a few more times to "clock through" the shutdown process and enable it to complete successfully.

Responses

Status 200

data was returned