Search project metrics - Veryfront

Query project-scoped metrics. Use this after logs or traces when you need counters, rates, latency buckets, usage, or runtime health metrics. Raw PromQL is not accepted; the API injects project scope.

Tool details

Field	Value
Name	`search_project_metrics`
Group	Metrics

Playground

Input schema

input-schema.json

{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "metric": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Prometheus metric name. Raw PromQL is not accepted."
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "Start time in ISO 8601 format."
    },
    "end": {
      "type": "string",
      "format": "date-time",
      "description": "End time in ISO 8601 format."
    },
    "step": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Prometheus query step, for example 60s.",
      "default": "60s"
    },
    "aggregation": {
      "type": "string",
      "enum": [
        "none",
        "sum",
        "avg",
        "min",
        "max",
        "count"
      ],
      "description": "Aggregation to apply to the project-scoped metric selector.",
      "default": "none"
    },
    "labels": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "description": "Additional structured values supplied to the tool."
      },
      "description": "Optional allowlisted label filters such as service_name or status_code."
    }
  },
  "required": [
    "metric"
  ],
  "additionalProperties": false,
  "description": "Input schema for the search_project_metrics tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

output-schema.json

{
  "type": "object",
  "properties": {
    "series": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "metric": {
            "type": "string",
            "description": "The metric associated with this tool result."
          },
          "labels": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "description": "Additional structured values associated with this result."
            },
            "description": "Structured labels details associated with this tool result."
          },
          "points": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "timestamp": {
                  "type": "string",
                  "description": "The timestamp associated with this tool result."
                },
                "value": {
                  "type": "number",
                  "description": "The value associated with this tool result."
                }
              },
              "required": [
                "timestamp",
                "value"
              ],
              "additionalProperties": false,
              "description": "One point item associated with this tool result."
            },
            "description": "List of points associated with this tool result."
          }
        },
        "required": [
          "metric",
          "labels",
          "points"
        ],
        "additionalProperties": false,
        "description": "One sery item associated with this tool result."
      },
      "description": "List of series associated with this tool result."
    },
    "stats": {
      "type": "object",
      "properties": {
        "query_time_ms": {
          "type": "number",
          "description": "The query time ms associated with this tool result."
        }
      },
      "required": [
        "query_time_ms"
      ],
      "additionalProperties": false,
      "description": "Structured stats details associated with this tool result."
    }
  },
  "required": [
    "series",
    "stats"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the search_project_metrics tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}