monitoringAggregation

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/flareapp-io/json-schema/flareapp-io-monitoring-aggregation-schema.json",
  "title": "monitoringAggregation",
  "description": "A performance aggregation representing a grouped span (e.g., a route, query, job).",
  "x-generated": "2026-11-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/flareapp-io-api-openapi.yml#/components/schemas/monitoringAggregation",
  "type": [
    "object"
  ],
  "properties": {
    "uuid": {
      "type": [
        "string"
      ],
      "description": "Unique identifier for the aggregation."
    },
    "type": {
      "type": [
        "string"
      ],
      "enum": [
        "routes",
        "queries",
        "jobs",
        "commands",
        "external-http",
        "views",
        "livewire-components",
        "browser-pages",
        "browser-components"
      ],
      "description": "The aggregation type."
    },
    "name": {
      "type": [
        "string"
      ],
      "description": "Human-readable name of the aggregation."
    },
    "detail": {
      "description": "Type-specific detail object. The shape varies by aggregation type.",
      "oneOf": [
        {
          "$ref": "#/$defs/routeDetail"
        },
        {
          "$ref": "#/$defs/queryDetail"
        },
        {
          "$ref": "#/$defs/jobDetail"
        },
        {
          "$ref": "#/$defs/commandDetail"
        },
        {
          "$ref": "#/$defs/externalHttpDetail"
        },
        {
          "$ref": "#/$defs/viewDetail"
        },
        {
          "$ref": "#/$defs/livewireComponentDetail"
        },
        {
          "$ref": "#/$defs/browserPageDetail"
        },
        {
          "$ref": "#/$defs/browserComponentDetail"
        }
      ]
    },
    "metrics": {
      "$ref": "#/$defs/monitoringMetrics"
    }
  },
  "$defs": {
    "browserComponentDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for browser component aggregations.",
      "properties": {
        "name": {
          "type": [
            "string"
          ],
          "description": "The browser component name."
        }
      }
    },
    "browserPageDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for browser page aggregations.",
      "properties": {
        "route": {
          "type": [
            "string"
          ],
          "description": "The browser page route pattern."
        },
        "kind": {
          "type": [
            "string"
          ],
          "description": "The kind of page load."
        },
        "source": {
          "type": [
            "string"
          ],
          "description": "How the route pattern was resolved."
        }
      }
    },
    "commandDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for artisan command aggregations.",
      "properties": {
        "command": {
          "type": [
            "string"
          ],
          "description": "The command signature."
        }
      }
    },
    "externalHttpDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for external HTTP request aggregations.",
      "properties": {
        "method": {
          "type": [
            "string"
          ],
          "description": "The HTTP request method."
        },
        "serverAddress": {
          "type": [
            "string"
          ],
          "description": "The external server address."
        },
        "urlPath": {
          "type": [
            "string"
          ],
          "description": "The URL path."
        },
        "http_code_1xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 1xx HTTP status codes."
        },
        "http_code_2xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 2xx HTTP status codes."
        },
        "http_code_3xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 3xx HTTP status codes."
        },
        "http_code_4xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 4xx HTTP status codes."
        },
        "http_code_5xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 5xx HTTP status codes."
        },
        "http_codes": {
          "type": [
            "object"
          ],
          "description": "Map of specific HTTP status codes to their counts.",
          "additionalProperties": {
            "type": [
              "integer"
            ]
          }
        }
      }
    },
    "jobDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for job aggregations.",
      "properties": {
        "name": {
          "type": [
            "string"
          ],
          "description": "The job name."
        },
        "class": {
          "type": [
            "string"
          ],
          "description": "The job class."
        }
      }
    },
    "livewireComponentDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for Livewire component aggregations.",
      "properties": {
        "name": {
          "type": [
            "string"
          ],
          "description": "The Livewire component name."
        },
        "class": {
          "type": [
            "string"
          ],
          "description": "The Livewire component class."
        }
      }
    },
    "monitoringMetrics": {
      "type": [
        "object"
      ],
      "description": "Aggregated performance metrics. All duration values are in milliseconds. Performance monitoring data is retained for 30 days in ClickHouse. Queries for older data will return empty results.",
      "properties": {
        "p50_ms": {
          "type": [
            "number"
          ],
          "description": "50th percentile duration in milliseconds."
        },
        "p90_ms": {
          "type": [
            "number"
          ],
          "description": "90th percentile duration in milliseconds."
        },
        "p95_ms": {
          "type": [
            "number"
          ],
          "description": "95th percentile duration in milliseconds."
        },
        "p99_ms": {
          "type": [
            "number"
          ],
          "description": "99th percentile duration in milliseconds."
        },
        "average_ms": {
          "type": [
            "number"
          ],
          "description": "Average duration in milliseconds."
        },
        "count": {
          "type": [
            "integer"
          ],
          "description": "Total number of occurrences."
        },
        "error_rate": {
          "type": [
            "number"
          ],
          "description": "Error rate as a decimal (0.0 to 1.0)."
        },
        "importance": {
          "type": [
            "null",
            "number"
          ],
          "description": "Computed importance score (available in list endpoints)."
        }
      }
    },
    "queryDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for database query aggregations.",
      "properties": {
        "statement": {
          "type": [
            "string"
          ],
          "description": "The SQL statement."
        },
        "system": {
          "type": [
            "string"
          ],
          "description": "The database system."
        },
        "laravel_connection": {
          "type": [
            "string"
          ],
          "description": "The Laravel database connection name."
        }
      }
    },
    "routeDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for route aggregations.",
      "properties": {
        "route": {
          "type": [
            "string"
          ],
          "description": "The HTTP route pattern."
        },
        "method": {
          "type": [
            "string"
          ],
          "description": "The HTTP request method."
        },
        "entry_point_handler_name": {
          "type": [
            "string"
          ],
          "description": "The handler name for this route."
        },
        "views": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Number of views rendered."
        },
        "exceptions": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Number of exceptions thrown."
        },
        "http_code_1xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 1xx HTTP status codes."
        },
        "http_code_2xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 2xx HTTP status codes."
        },
        "http_code_3xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 3xx HTTP status codes."
        },
        "http_code_4xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 4xx HTTP status codes."
        },
        "http_code_5xx": {
          "type": [
            "null",
            "integer"
          ],
          "description": "Count of 5xx HTTP status codes."
        },
        "http_codes": {
          "type": [
            "object"
          ],
          "description": "Map of specific HTTP status codes to their counts.",
          "additionalProperties": {
            "type": [
              "integer"
            ]
          }
        }
      }
    },
    "viewDetail": {
      "type": [
        "object"
      ],
      "description": "Detail for view aggregations.",
      "properties": {
        "name": {
          "type": [
            "string"
          ],
          "description": "The view name."
        },
        "type": {
          "type": [
            "string"
          ],
          "enum": [
            "view",
            "component",
            "inline_component"
          ],
          "description": "The view type."
        }
      }
    }
  }
}