Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

HTTP API: perf

Počítadla práce a časování fází tohoto procesu: co se stalo jednou při startu a co se děje při každém volání, pro strukturální testy a důkazy z měření výkonu.

Vykresleno z docs/generated/openapi.json, který spustitelný soubor generuje ze svého registru schopností a CI jej odmítne, je-li zastaralý. Surový dokument je na /openapi.json; běžící server servíruje stejný dokument na vlastní /openapi.json a Swagger UI na /swagger.

perf

Počítadla práce a časování fází tohoto procesu: co se stalo jednou při startu a co se děje při každém volání, pro strukturální testy a důkazy z měření výkonu.

GET /api/v1/perf perf.counters

Čítače výkonu

Počitadla tohoto procesu: skeny repozitáře, sestavení indexu a registru, generování schémat, sestavení projekcí, provedení, vyvolání handlerů, zásahy, minutí a vyřazení cache a časování fází, tak jak právě stojí.

  • query
  • behaviorally_verified
  • vyžaduje se měření výkonu
  • cache vypnuta
  • nástroj MCP majordomus_perf

Žádné parametry.

Vyzkoušejte

Port je ten, který server zalogoval; 8741 je ten, o který žádá jako první. Hodnoty jsou první příklad operace.

curl -s "http://127.0.0.1:8741/api/v1/perf"

Testováno v apps/majordomus-cli/tests/http_serve.rs, který přehrává routu s těmito hodnotami proti serveru na skutečném socketu.

Odpovědi

statustělovýznam
200 CounterSnapshot Čítače výkonu: výsledek.
400 ErrorBody invalid_input: Vstup neodpovídá schématu: parametr špatného typu, neznámý parametr nebo hodnota, kterou schopnost odmítne.
404 ErrorBody not_found: Vstup pojmenovává něco, co repozitář nemá.
500 ErrorBody internal: Schopnost selhala z vlastního důvodu; zpráva ho pojmenovává.
výchozí ErrorBody Jakékoli jiné selhání, které transport hlásí: 405 method_not_allowed pro jinou metodu na této cestě, 400 invalid_input pro tělo, které není objektem JSON.

Schémata

Komponenty, které používají jen operace tohoto tagu. Každý řádek je pole daného typu, jeho doc komentář je popis; typ vlastněný jinou stránkou na ni odkazuje.

CounterSnapshot

object
Čítače a součty fází tohoto procesu v jednom okamžiku. Každá hodnota je počet nebo doba, které tento proces změřil; žádná není nikde zapsána ručně.
vlastnosttyppovinnépopis
repository_scans integer (uint64) ano Výčty deklarovaných zdrojů repozitáře.
index_builds integer (uint64) ano Sestavení indexu.
registry_builds integer (uint64) ano Buildy registru.
schema_generations integer (uint64) ano JSON Schemas odvozená z typů v Rustu.
mcp_projection_builds integer (uint64) ano Seznamy nástrojů a zdrojů MCP spočítány.
openapi_builds integer (uint64) ano Dokumenty OpenAPI sestaveny.
http_projection_builds integer (uint64) ano Sestavené HTTP routery.
graph_builds integer (uint64) ano Grafy odvozené z registru a indexu.
executions integer (uint64) ano Volání přes executor, každý transport.
handler_invocations integer (uint64) ano Skutečně spuštěné handlery.
cache_hits integer (uint64) ano Execution zodpovězené z cache.
cache_misses integer (uint64) ano Provedení cachované schopnosti, která spustila handler.
cache_evictions integer (uint64) ano Zahozené záznamy cache.
fáze mapa PhaseTotals → PhaseTotals ano Součty fází podle názvu fáze.

Používá perf.counters

PhaseTotals

object
Součty fáze.
vlastnosttyppovinnépopis
počet integer (uint64) ano Kolikrát fáze proběhla.
total_nanos integer (uint64) ano Nanosekundy v něm strávené, sečtené.

Používá CounterSnapshot

Prohledává názvy a popisy všech stránek, které tento web publikuje.