API.md

TorrentNG API Reference

TorrentNG exposes the same client-facing API families in both native-engine mode and the Track 1 rTorrent sidecar:

• Native API — /api/v1/ — JSON REST, snake_case, designed for the WebUI and direct integrations. In native-engine mode this is backed by durable engine state; in Track 1 it is a sidecar facade over rTorrent.
• qBittorrent compat API — /api/v2/ and /api/qb/v2/ — targeted as a drop-in replacement for the qBittorrent Web API v2; used by Prowlarr, Sonarr, Radarr, autobrr, cross-seed, etc.
• Transmission RPC — /transmission/rpc and /api/transmission/rpc — compatibility facade over the same torrent registry.
• Deluge RPC — Deluge-compatible facade for clients that expect Deluge method names, with parity tracked in the compatibility matrix.

All surfaces are served on the same port (default 8080).

The API strategy is compatibility-first: existing tools should be able to keep speaking the client dialect they already support while TorrentNG projects those calls onto one native model. Endpoint availability does not by itself mean full semantic parity; current native, partial, compatibility-only, and gap status is tracked in CLIENT_COMPATIBILITY_MATRICES.md.

For engine selection and native-vs-rTorrent behavior, see ENGINE_REWRITE.md.

---

Authentication

When auth.api_tokens is configured, all non-public endpoints require one of:

Authorization: Bearer <token>
Cookie: tng_session=<token>

Public endpoints (never require auth): /health, /metrics, /api/v1/auth/login, /api/qb/v2/auth/login

Request Correlation

Non-static API responses include an X-Request-Id header. If a client supplies a bounded, printable X-Request-Id, TorrentNG preserves it in structured request logs and echoes it back; otherwise the runtime generates a tng-N id. Health, metrics, websocket, and static asset requests are intentionally excluded from request logging noise. Request logs also include the socket peer address when the runtime has connect-info available; forwarded headers are not trusted for that field.

---

Health And Capability Manifest

GET /health reports native-engine readiness and a machine-readable capability manifest. Existing readiness fields remain stable (status, ready, native_engine, torrent_count), and the nested engine.capabilities object advertises rewrite-level support for v1/v2/hybrid identity, btih/btmh magnets, durable session/job state, storage safety, DHT/uTP policy, native REST, qBittorrent, Transmission, Deluge, migration, metrics, and diagnostics. The uTP section distinguishes implementation capability from active runtime paths through utp_transport_paths, which can include outgoing_peer_wire, metadata_fetch, and incoming_peer_wire depending on the current TNG_UTP_* environment policy.

Native /api/v1/engine also exposes the selected backend adapter and its capabilities. Adapter capability flags cover tags, categories, file priority, tracker edit, recheck, torrent export, webseed reads, piece state/hash reads, peer snapshots, explicit peer add/ban, queue ordering, per-torrent/global/share limits, qBittorrent-style mode flags, location updates, torrent/file renames, runtime user-agent changes, rTorrent config overlay, and backend restart. Where a flag is false, native/backend endpoints return an explicit unsupported result or the documented compatibility empty response instead of pretending mutation success.

The engine.track1_sidecar_required field is always false for native-engine mode; Track 1 remains a migration/facade layer, not a runtime dependency for the rewritten engine.

---

Native API — /api/v1

Auth

Method	Path	Description
POST	/api/v1/auth/login	Native WebUI session login. With auth.api_tokens, username or password must match an API token; success returns Ok. and a tng_session cookie.
POST	/api/v1/auth/logout	Native WebUI logout probe; expires the tng_session cookie.

Torrents

Method	Path	Description
GET	/api/v1/torrents	List torrents with filter/sort/page
POST	/api/v1/torrents	Add torrent (multipart: torrent file or magnet URL, save_path, category, start)
GET	/api/v1/torrents/:hash	Get single torrent by hash
PUT	/api/v1/torrents/:hash	Update torrent metadata ({ name, save_path }; at least one required)
DELETE	/api/v1/torrents/:hash	Remove torrent (?delete_files=true to also delete data)
POST	/api/v1/torrents/:hash/start	Start torrent
POST	/api/v1/torrents/:hash/resume	Resume torrent (alias of start)
POST	/api/v1/torrents/:hash/stop	Stop torrent
POST	/api/v1/torrents/:hash/pause	Pause torrent (alias of stop)
POST	/api/v1/torrents/:hash/recheck	Force hash check
POST	/api/v1/torrents/:hash/reannounce	Force tracker announce
GET	/api/v1/torrents/:hash/trackers	List trackers
PATCH	/api/v1/torrents/:hash/trackers	Add/remove/edit trackers ({ add: ["url"], remove: ["url"], edit: [{ orig_url, new_url }] }); native daemon applies this by replacing the engine tracker list after the patch
GET	/api/v1/torrents/:hash/files	List files
PATCH	/api/v1/torrents/:hash/files	Set file priorities and/or paths ({ files: [{index, priority, path}] }); native daemon routes each file priority and rename update through the engine
PUT	/api/v1/torrents/:hash/category	Set or clear category ({ category: "name" }, or null/empty to clear)
GET	/api/v1/torrents/:hash/limits	Read per-torrent limits and mode flags
PUT	/api/v1/torrents/:hash/limits	Merge per-torrent limits (download_limit, upload_limit, max_connections, seed_ratio_limit, seed_idle_limit, sequential_download, first_last_piece_prio, force_start, super_seeding, auto_tmm, auto_management; use null for nullable limits)
POST	/api/v1/torrents/:hash/peers	Add explicit peers ({ peers: ["host:port"] })
POST	/api/v1/torrents/queue	Move torrents in queue order ({ hashes: ["..."], move: "up" | "down" | "top" | "bottom" })
PATCH	/api/v1/torrents/:hash/tags	Add/remove tags ({ add: ["a"], remove: ["b"] }); native daemon routes tag changes through the engine label update path
GET	/api/v1/events	Server-sent torrent delta stream
GET	/api/v1/jobs	List active durable engine jobs with progress, checkpoint, and last-error fields
GET	/api/v1/session-events	Recent durable native session events; query: limit, torrent, kind, level, last_known_id
GET	/api/v1/logs	Recent durable TorrentNG app/backend events plus rTorrent log-ingest events when that adapter is selected; query: limit, kind, level, last_known_id
GET	/api/v1/transfer/limits	Read global transfer limits and speed-limits mode
PUT	/api/v1/transfer/limits	Merge global transfer limits (download_limit, upload_limit, speed_limits_mode)
GET	/api/v1/session/features	Read runtime network feature switches (dht, pex)
PUT	/api/v1/session/features	Merge runtime network feature switches; DHT starts/stops at runtime and PEX affects future peer extension handshakes

/api/v1/logs returns retained operator events newest-first. Important kind values include sidecar_started, rtorrent_log, rtorrent_log_ingest_error, rtorrent_log_ingest_recovered, rtorrent_sync_error, rtorrent_sync_recovered, rtorrent_stats_error, rtorrent_stats_recovered, rtorrent_user_agent_error, torrent_added, torrent_removed, torrent_updated, categories_updated, tags_updated, saved_views_updated, ratio_groups_updated, rss_rules_updated, workflows_updated, workflow_runs_updated, settings_changed, and admin_restart_requested. The rtorrent_sync_* and rtorrent_stats_* names are retained as legacy event kinds, but their payloads include the selected backend. Payloads are sanitized: magnet URLs, auth material, full filesystem paths, and raw user-agent strings are not stored.

GET /api/v1/torrents query parameters

Parameter	Type	Description
filter	string	Name substring match (case-insensitive)
status	string	seeding | downloading | stopped | checking | error
category	string	Exact category name
tag	string	Exact tag name
sort	string	name | size | added | ratio | speed_down | speed_up | progress
dir	string	asc | desc
limit	int	Max rows (1–5000, default 200)
offset	int	Pagination offset

Response: { total: int, torrents: TorrentRow[] }

Native API list, delta-stream, and torrent-detail snapshots are charged to the api_snapshot memory class. When that budget is exhausted the API returns 503 with api snapshot memory budget exhausted instead of cloning an unbounded response.

The qBittorrent facade applies the same budget to /api/qb/v2/torrents/info and /api/qb/v2/sync/maindata, because those endpoints clone the largest compatibility snapshots under high torrent counts.

The Deluge facade applies the same budget to web.update_ui, core.get_torrents_status, and core.get_torrent_status. The Transmission facade applies it to torrent-get, scaled by torrent count and requested field count. The rTorrent XMLRPC facade applies it to d.multicall/d.multicall2, scaled by torrent count and requested command count.

TorrentRow fields

{
  "hash": "abc123...",
  "name": "Example.Torrent.Name",
  "size_bytes": 10737418240,
  "bytes_done": 10737418240,
  "down_rate": 0,
  "up_rate": 1048576,
  "up_total": 53687091200,
  "down_total": 10737418240,
  "ratio": 5000,
  "is_active": true,
  "is_open": true,
  "complete": true,
  "state": 1,
  "priority": 0,
  "category": "Movies",
  "base_path": "/data/downloads/Example.Torrent.Name",
  "directory": "/data/downloads",
  "creation_date": 1700000000,
  "timestamp_finished": 1700001000,
  "tracker_focus": 0,
  "peers_connected": 12,
  "peers_complete": 400,
  "message": "",
  "tracker_url": "https://tracker.example.com/announce",
  "tags": "hd,4k",
  "updated_at": 1700100000
}

Notes:

• ratio is integer × 1000 (5000 = ratio 5.0)
• tags is a comma-separated string of tag names
• state: 0=idle, 1=active, 2=checking, 3=error

Categories

Method	Path	Description
GET	/api/v1/categories	List all categories
POST	/api/v1/categories	Create or update category ({ name, save_path })
DELETE	/api/v1/categories/:name	Delete category

Tags

Method	Path	Description
GET	/api/v1/tags	List all tag names
POST	/api/v1/tags	Create tag ({ name })
DELETE	/api/v1/tags/:name	Delete tag (also removes from all torrents)

Storage

Method	Path	Description
GET	/api/v1/storage	List configured storage roots with total/used/free bytes, readonly status, and per-root errors
POST	/api/v1/storage/plan	Preview move/import/delete storage plans ({ operation, source, destination, target, bytes, available_bytes, hardlink_or_copy, roots, completed_steps }); import uses staged copy unless hardlink_or_copy allows same-filesystem hardlinks, and completed-step resume indexes are validated against the generated plan
POST	/api/v1/storage/execute	Execute a root-confined move/import/delete storage plan through durable engine storage-plan jobs (roots is required; delete execution also uses dry_run_approved; completed_steps resumes only validated plan steps from the matching previewed plan)
GET	/api/v1/tracker-health	Aggregate cached torrents by tracker URL with torrent/active/complete/error/peer counts
GET	/api/v1/engine	Runtime backend type/capabilities plus rTorrent provenance, XMLRPC probes, tracker-stack telemetry, and profile drift when the selected backend is rTorrent
GET	/api/v1/engine/commands	Full XMLRPC command index exposed by the running rTorrent build; rTorrent-only
POST	/api/v1/cross-seed	Preview/apply cross-seed helper ({ hashes, trackers, reannounce, dry_run })

Saved Views

Method	Path	Description
GET	/api/v1/saved-views	List saved torrent filter/sort views
POST	/api/v1/saved-views	Create/update saved view ({ id, name, params })
DELETE	/api/v1/saved-views/:id	Delete saved view

Ratio Groups

Method	Path	Description
GET	/api/v1/ratio-groups	List configured ratio groups
POST	/api/v1/ratio-groups	Create/update ratio group ({ name, ratio_limit, seeding_time_limit, category, tracker, enabled })
POST	/api/v1/ratio-groups/:name	Apply ratio group to matching cached torrents ({ dry_run })
DELETE	/api/v1/ratio-groups/:name	Delete ratio group

Workflow Rules

Method	Path	Description
GET	/api/v1/workflows	List workflow rules
POST	/api/v1/workflows	Create/update workflow rule for completed, added, or category_changed events
POST	/api/v1/workflows/:id	Run workflow rule ({ dry_run }); native actions and webhook POST actions execute, script actions require [workflows].allow_scripts=true and pass the configured directory allowlist
DELETE	/api/v1/workflows/:id	Delete workflow rule
GET	/api/v1/workflow-runs	List the most recent workflow run audit records, capped to the latest 200

RSS Rules

Method	Path	Description
GET	/api/v1/rss-rules	List RSS automation rules
POST	/api/v1/rss-rules	Create/update RSS rule ({ id, name, enabled, feed_url, include, exclude, category, save_path, tags, start })
POST	/api/v1/rss-rules/test	Test a sample { title, link } against configured rules
POST	/api/v1/rss-rules/apply	Preview or apply a sample { title, link, dry_run }; real runs submit matched links with rule category/save path/start settings
DELETE	/api/v1/rss-rules/:id	Delete RSS rule

Bulk operations

POST /api/v1/bulk/:action

Actions: start, stop, recheck, reannounce, set-category, set-location

Body: { hashes: ["abc123", ...], dry_run: false }

For set-category, include category (empty string clears it). For set-location, include non-empty save_path.

Response: { applied: ["abc123"], errors: [], dry_run: false }

Pass dry_run: true to preview what would be affected without making changes.

Settings

Method	Path	Description
GET	/api/v1/settings/user-agent	Get current runtime user-agent string when supported by the selected backend
PUT	/api/v1/settings/user-agent	Set user-agent ({ user_agent: "..." }) when supported; rTorrent packaged builds apply it immediately

Infrastructure

Method	Path	Description
GET	/health	Health check. Sidecar mode returns generic backend reachability in backend, preserves legacy rtorrent, and includes cache count. Supported sidecar backends are rTorrent, qBittorrent, Transmission, Deluge, and TorrentNG native.
GET	/metrics	Prometheus text format metrics
GET	/ws	WebSocket — upgrade to receive live events

When configured with backend.type = "torrentng", the sidecar forwards torrent add/remove, pause/resume, recheck/reannounce, category/tag changes, location/name updates, file-priority and file-rename changes, and tracker patch operations to a native torrentngd daemon over these /api/v1 endpoints.

WebSocket events

{ "type": "torrent_updated", "hash": "abc123" }
{ "type": "torrent_removed", "hash": "abc123" }
{ "type": "stats", "upload_speed": 1048576, "download_speed": 524288 }

---

qBittorrent Compat API — /api/v2 or /api/qb/v2

Implements the qBittorrent Web API v2. By default it advertises qBittorrent 5.0.0 / Web API 2.11.0; lab builds can override those API-facing values with the TNG_QBITTORRENT_* identity environment variables. Configure external tools to point at this server as if it were qBittorrent.

Auth

Method	Path	Notes
POST	/api/qb/v2/auth/login	qBittorrent-compatible login probe; accepts credentials and returns Ok. with a SID cookie for clients that require qBit session shape
POST	/api/qb/v2/auth/logout	Expires the qBittorrent-compatible SID cookie

App

Method	Path	Notes
GET	/api/qb/v2/app/version
GET	/api/qb/v2/app/webapiVersion
GET	/api/qb/v2/app/buildInfo
GET	/api/qb/v2/app/preferences	Includes queue defaults plus backend-derived dht/pex status when known and network_http_user_agent when supported
GET	/api/qb/v2/app/defaultSavePath
POST	/api/qb/v2/app/setPreferences	Form: json preference object; applies dht, pex, and network_http_user_agent when backend-supported; unsupported keys are accepted and ignored
GET	/api/qb/v2/app/getCookies	Returns facade-stored cookie objects sorted by host/name
POST	/api/qb/v2/app/setCookies	Accepts JSON array, { "cookies": [...] }, or form cookies=<json array>
POST	/api/qb/v2/app/rotateAPIKey	Stores and returns a generated facade API key as { "apiKey": "..." }
POST	/api/qb/v2/app/deleteAPIKey	Clears the facade API key

Torrents

Method	Path	Notes
GET	/api/qb/v2/torrents/info	Filter params: filter, category, tag, sort, reverse, limit, offset
GET	/api/qb/v2/torrents/properties	Query: hash; returns cached torrent properties
POST	/api/qb/v2/torrents/add	Multipart: urls, savepath, category, tags, paused, stopped, skip_checking, autoTMM, contentLayout, ratioLimit, seedingTimeLimit, torrents (file)
POST	/api/qb/v2/torrents/pause / /stop	Form: hashes (pipe-separated or all)
POST	/api/qb/v2/torrents/resume / /start	Form: hashes
POST	/api/qb/v2/torrents/delete	Form: hashes, deleteFiles
POST	/api/qb/v2/torrents/recheck	Form: hashes
POST	/api/qb/v2/torrents/reannounce	Form: hashes
GET	/api/qb/v2/torrents/trackers	Query: hash
GET	/api/qb/v2/torrents/export	Query: hash; streams the persisted .torrent blob where supported
GET	/api/qb/v2/torrents/webseeds	Query: hash; backend-backed where supported, otherwise []
GET	/api/qb/v2/torrents/files	Query: hash
GET	/api/qb/v2/torrents/pieceStates	Query: hash; backend-backed where supported, otherwise []
GET	/api/qb/v2/torrents/pieceHashes	Query: hash; backend-backed where supported, otherwise []
GET	/api/qb/v2/torrents/export	Query: hash; streams application/x-bittorrent where the backend has the original torrent blob
POST	/api/qb/v2/torrents/filePrio	Form: hash, id (pipe-separated indices), priority
POST	/api/qb/v2/torrents/setCategory	Form: hashes, category
POST	/api/qb/v2/torrents/addTags	Form: hashes, tags (comma-separated)
POST	/api/qb/v2/torrents/removeTags	Form: hashes, tags
POST	/api/qb/v2/torrents/setTags	Form: hashes, tags (comma-separated replacement)
GET	/api/qb/v2/torrents/categories	Returns { "Name": { "name": "Name", "savePath": "/path" } }
POST	/api/qb/v2/torrents/createCategory	Form: category, savePath
POST	/api/qb/v2/torrents/editCategory	Form: category, savePath
POST	/api/qb/v2/torrents/removeCategories	Form: categories (newline-separated)
GET	/api/qb/v2/torrents/tags	Returns ["tag1", "tag2"]
POST	/api/qb/v2/torrents/createTags	Form: tags (comma-separated)
POST	/api/qb/v2/torrents/deleteTags	Form: tags
POST	/api/qb/v2/torrents/rename	Form: hash, name
POST	/api/qb/v2/torrents/renameFile	Form: hash, id, name
POST	/api/qb/v2/torrents/renameFolder	Form: hash, id, name
GET	/api/qb/v2/torrents/downloadLimit	Query: hashes; returns { "hash": limit } where supported
POST	/api/qb/v2/torrents/setDownloadLimit	Form: hashes, limit; backend-backed where supported
GET	/api/qb/v2/torrents/uploadLimit	Query: hashes; returns { "hash": limit } where supported
POST	/api/qb/v2/torrents/setUploadLimit	Form: hashes, limit; backend-backed where supported
POST	/api/qb/v2/torrents/setShareLimits	Form: hashes, ratioLimit, seedingTimeLimit
POST	/api/qb/v2/torrents/setLocation	Form: hashes, location
POST	/api/qb/v2/torrents/setSavePath	Form: hashes, location
POST	/api/qb/v2/torrents/addTrackers	Form: hashes, urls (newline-separated)
POST	/api/qb/v2/torrents/setAutoTMM	Backend-backed where supported
POST	/api/qb/v2/torrents/editTracker	Form: hash, origUrl, newUrl
POST	/api/qb/v2/torrents/removeTrackers	Form: hash, urls (pipe-separated)
POST	/api/qb/v2/torrents/toggleSequentialDownload	Form: hashes
POST	/api/qb/v2/torrents/addPeers	Engine-backed where supported
POST	/api/qb/v2/torrents/increasePrio	Engine-backed where supported
POST	/api/qb/v2/torrents/decreasePrio	Engine-backed where supported
POST	/api/qb/v2/torrents/topPrio	Engine-backed where supported
POST	/api/qb/v2/torrents/bottomPrio	Engine-backed where supported
POST	/api/qb/v2/torrents/setAutoManagement	Backend-backed where supported
POST	/api/qb/v2/torrents/setForceStart	Backend-backed where supported
POST	/api/qb/v2/torrents/setSuperSeeding	Backend-backed where supported
POST	/api/qb/v2/torrents/toggleFirstLastPiecePrio	Backend-backed where supported

Sync / Transfer

Method	Path
GET	/api/qb/v2/sync/maindata
GET	/api/qb/v2/transfer/info
GET	/api/qb/v2/transfer/speedLimitsMode
POST	/api/qb/v2/transfer/toggleSpeedLimitsMode
GET	/api/qb/v2/transfer/downloadLimit
POST	/api/qb/v2/transfer/setDownloadLimit
GET	/api/qb/v2/transfer/uploadLimit
POST	/api/qb/v2/transfer/setUploadLimit
POST	/api/qb/v2/transfer/banPeers

Log / Search / RSS

These compatibility endpoints are present so qBittorrent clients can probe them safely. Search keeps plugin and job lifecycle state while returning inert local result sets; RSS keeps in-memory folder, feed, and rule mutation state and can later project native RSS rules.

Method	Path	Notes
GET	/api/qb/v2/log/main	Returns retained app/session/rTorrent log events in qBittorrent log shape; supports limit, last_known_id, normal, info, warning, critical
GET	/api/qb/v2/log/peers	Returns backend peer snapshots in qBittorrent peer log shape where supported; otherwise []
GET	/api/qb/v2/search/status	Returns stopped/running status plus known plugin state
GET	/api/qb/v2/search/categories	Returns enabled compatibility plugin categories
GET	/api/qb/v2/search/plugins	Returns installed compatibility plugin records
POST	/api/qb/v2/search/installPlugin	Records plugin source/name metadata
POST	/api/qb/v2/search/uninstallPlugin	Removes plugin records
POST	/api/qb/v2/search/enablePlugin	Updates plugin enabled state
POST	/api/qb/v2/search/updatePlugins	Safe compatibility refresh probe; local plugin records are unchanged
POST	/api/qb/v2/search/start	Returns a stable per-process search job id
POST	/api/qb/v2/search/stop	Stops the requested compatibility search job
GET	/api/qb/v2/search/results	Returns the requested job plus empty local result set
POST	/api/qb/v2/search/delete	Deletes the requested compatibility search job
GET	/api/qb/v2/rss/items	Returns compatibility folder/feed state
GET	/api/qb/v2/rss/rules	Returns compatibility qBit-shaped rule map
GET	/api/qb/v2/rss/matchingArticles	Returns known rule names
POST	/api/qb/v2/rss/setRule	Creates/updates compatibility RSS rule JSON
POST	/api/qb/v2/rss/renameRule	Renames compatibility RSS rule
POST	/api/qb/v2/rss/removeRule	Deletes compatibility RSS rule
POST	/api/qb/v2/rss/addFolder, /addFeed, /removeItem, /moveItem, /markAsRead, /refreshItem	Maintains qBit-shaped compatibility folder/feed item state

---

Prometheus Metrics

Exposed at GET /metrics in Prometheus text format:

Native mode exposes engine/session/API metrics from torrentngd. Sidecar mode additionally exposes backend sync-loop counters because it polls the selected backend adapter.

Metric	Type	Description
torrentng_torrents_total	gauge	Total torrents in session
torrentng_torrents_seeding	gauge	Currently seeding
torrentng_torrents_downloading	gauge	Currently downloading
torrentng_torrents_stopped	gauge	Stopped
torrentng_torrents_errored	gauge	In error state
torrentng_torrents_activity_{hot,warm,dormant}	gauge	Activity-tier classification counts from the native tier policy
torrentng_torrent_tasks_active	gauge	Active per-torrent runtime tasks
torrentng_fastresume_dirty_pieces	gauge	Pieces validated since the last completed durability barrier
torrentng_completed_piece_verify_from_{memory,disk}_total	counter	Completed-piece verification source; memory verifies avoid read-after-write disk rereads
torrentng_peers_connected	gauge	Connected peers across all torrents
torrentng_dht_*	gauge	Native DHT routing table, lookup, tracked torrent, and announced peer cache counts
torrentng_storage_file_pool_*	gauge/counter	Native scheduler open-file cache capacity, open files, metadata bytes, hits, misses, evictions, and idle closes
torrentng_storage_*_queue_depth	gauge	Native disk I/O and hashing queue depths
torrentng_storage_device_queue_{capacity,available}	gauge	Process-level per-device storage queue permits across running torrent schedulers
torrentng_storage_queued_disk_bytes	gauge	Process-owned payload bytes currently reserved by queued or active disk, hash, and peer-read elevator jobs
torrentng_storage_queue_full_total	counter	Disk or hash jobs denied because the bounded per-mount storage queue was full
torrentng_storage_{read,write}_ops_total	counter	Positioned disk operations through native schedulers
torrentng_storage_bytes_{read,written}_total	counter	Bytes moved through native schedulers
torrentng_storage_*_by_class_total{class=...}	counter	Read/write operation and byte counters split by scheduler I/O class
torrentng_storage_backend_selected{backend=...}	gauge	Global storage backend selected at runtime (pread or explicit uring)
torrentng_storage_backend_fixed_buffers_supported	gauge	Whether the selected backend can use registered fixed buffers
torrentng_storage_backend_registered_files_supported	gauge	Whether the selected backend can use registered file slots
torrentng_storage_backend_{max_batch_len,fixed_buffer_bytes}	gauge	Selected backend batching and fixed-buffer sizing
torrentng_storage_backend_fixed_buffer_strategy{strategy=...}	gauge	Active fixed-buffer strategy (disabled, reserved worker_copy, or frame_pool_slots)
torrentng_storage_backend_fixed_buffer_worker_copy	gauge	Whether fixed-buffer submissions copy through backend-private worker buffers
torrentng_storage_backend_frame_pool_slots_supported	gauge	Whether fixed-buffer submissions use registered storage frame-pool slots directly
torrentng_storage_backend_read_*	counter	Actual backend disk read operations and bytes, excluding peer-read cache hits
torrentng_storage_*_latency_nanoseconds	histogram/counter	Storage queue plus execution latency buckets and cumulative totals for read, write, sync, and hash work
torrentng_storage_*_latency_nanoseconds_by_device{device=...,profile=...}	histogram/counter	Storage read/write/sync/hash latency histograms and totals split by resolved storage device/profile
torrentng_storage_{sync,hash}_ops_total	counter	Durability syncs and hashing-pool work
torrentng_storage_preallocation_*_total	counter	Preallocation failures and fallback events
torrentng_storage_peer_read_cache_*	gauge/counter	Peer-read readahead cache entries, hits, and misses
torrentng_storage_peer_read_elevator_*	gauge/counter	Peer-read elevator enablement, queue state, queue-full backpressure, backend batches, and coalesced requests
torrentng_storage_page_cache_advise_*	counter	Page-cache advice calls (SEQUENTIAL, WILLNEED, DONTNEED) and failures from the storage scheduler
torrentng_storage_sparse_*	counter	Sparse recheck data extents, skipped hole bytes, and seek fallback count
torrentng_piece_assembly_*	gauge/counter	In-memory completed-piece assembly buffers, bytes, and budget evictions
torrentng_peer_request_window_reductions_total	counter	Peer request refills reduced because memory pressure limited in-flight piece data
torrentng_peer_{rx,tx}_buffer_bytes	gauge	Process-owned peer buffer pressure from outstanding receive requests and upload buffers; upload block assembly is also charged to the peer_buffer memory class while in flight
torrentng_peer_command_queue_*	gauge/counter	Active peer command queue capacity, depth, and full-send backpressure events
torrentng_tracker_peer_cache_*	gauge/counter	Tracker peer addresses retained or dropped by bounded per-torrent peer caches
torrentng_hot_torrent_memory_estimated_bytes{rank,info_hash}	gauge	Top active torrents by estimated process-owned memory, capped to the largest ten torrents
torrentng_hot_torrent_piece_assembly_bytes{rank,info_hash}	gauge	Piece-assembly portion of each hot-torrent memory estimate
torrentng_hot_torrent_peer_buffer_bytes{rank,info_hash}	gauge	Peer rx/tx buffer portion of each hot-torrent memory estimate
torrentng_hot_torrent_tracker_peer_bytes{rank,info_hash}	gauge	Tracker peer-cache portion of each hot-torrent memory estimate
torrentng_hot_torrent_peer_command_queue_bytes{rank,info_hash}	gauge	Peer command queue portion of each hot-torrent memory estimate
torrentng_hot_torrent_storage_cache_bytes{rank,info_hash}	gauge	Per-torrent storage cache portion of each hot-torrent memory estimate
torrentng_memory_*	gauge/counter	Resource governor cap, current process-owned usage, pressure state, per-class caps/usage, and denied allocations, including the queued_disk class
torrentng_api_requests_total	counter	API requests served
torrentng_sync_cycles_total	counter	Sidecar backend sync cycles completed
torrentng_sync_errors_total	counter	Sidecar backend sync cycle errors