Skip to content

perf.counters

The counters of this process: repository scans, index and registry builds, schema generations, projection builds, executions, handler invocations, cache hits, misses and evictions, and the phase timings, as they stand now.

The counters of this process: repository scans, index and registry builds, schema generations, projection builds, executions, handler invocations, cache hits, misses and evictions, and the phase timings, as they stand now.

  • query
  • behaviorally_verified
  • module perf
  • #performance
  • #introspection

Exposure

Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.

surfaceas
MCPtool majordomus_perf
HTTPGET /api/v1/perf operationId perf.counters
command line—

Schemas

The canonical input and output, from the Rust types; the MCP tool schema and the OpenAPI parameters and responses are derived from these.

input · Empty

No input.

No properties: the capability takes no input.

JSON Schema 
{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

output · CounterSnapshot

The counters and phase totals of this process at one moment. Every value is a count or a duration this process measured; none is written anywhere by hand.

propertytyperequireddescription
cache_evictions integer yes Cache entries dropped.
cache_hits integer yes Executions answered from the cache.
cache_misses integer yes Executions of a cached capability that ran the handler.
executions integer yes Calls through the executor, every transport.
graph_builds integer yes Graphs derived from the registry and the index.
handler_invocations integer yes Handlers actually run.
http_projection_builds integer yes HTTP routers built.
index_builds integer yes Index builds.
mcp_projection_builds integer yes MCP tool and resource listings computed.
openapi_builds integer yes OpenAPI documents built.
phases object yes Phase totals by phase name.
registry_builds integer yes Registry builds.
repository_scans integer yes Enumerations of the repository's declared sources.
schema_generations integer yes JSON Schemas derived from Rust types.
JSON Schema 
{
  "$defs": {
    "PhaseTotals": {
      "description": "A phase's totals.",
      "properties": {
        "count": {
          "description": "How many times the phase ran.",
          "format": "uint64",
          "minimum": 0,
          "type": "integer"
        },
        "total_nanos": {
          "description": "Nanoseconds spent in it, summed.",
          "format": "uint64",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "count",
        "total_nanos"
      ],
      "type": "object"
    }
  },
  "description": "The counters and phase totals of this process at one moment. Every value is a count\nor a duration this process measured; none is written anywhere by hand.",
  "properties": {
    "cache_evictions": {
      "description": "Cache entries dropped.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "cache_hits": {
      "description": "Executions answered from the cache.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "cache_misses": {
      "description": "Executions of a cached capability that ran the handler.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "executions": {
      "description": "Calls through the executor, every transport.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "graph_builds": {
      "description": "Graphs derived from the registry and the index.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "handler_invocations": {
      "description": "Handlers actually run.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "http_projection_builds": {
      "description": "HTTP routers built.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "index_builds": {
      "description": "Index builds.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "mcp_projection_builds": {
      "description": "MCP tool and resource listings computed.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "openapi_builds": {
      "description": "OpenAPI documents built.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "phases": {
      "additionalProperties": {
        "$ref": "#/$defs/PhaseTotals"
      },
      "description": "Phase totals by phase name.",
      "type": "object"
    },
    "registry_builds": {
      "description": "Registry builds.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "repository_scans": {
      "description": "Enumerations of the repository's declared sources.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "schema_generations": {
      "description": "JSON Schemas derived from Rust types.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "repository_scans",
    "index_builds",
    "registry_builds",
    "schema_generations",
    "mcp_projection_builds",
    "openapi_builds",
    "http_projection_builds",
    "graph_builds",
    "executions",
    "handler_invocations",
    "cache_hits",
    "cache_misses",
    "cache_evictions",
    "phases"
  ],
  "title": "CounterSnapshot",
  "type": "object"
}

Policies

benchmark
required — a target on every transport the exposure declares; the cases are the input type's
cache
disabled — every call runs the handler

Benchmark targets

Derived from the registry for this repository: one requirement per transport, and the cases the input type provides. The whole matrix is on the benchmarks page.

transportstatecasestargets
directcovered1default
mcpcovered1default
httpcovered1default

The moments this answers