@downtrace/protocol 0.4.0 → 0.6.0

package/README.md

@@ -4,7 +4,7 @@ The ingestion contract between Downtrace agents and the Downtrace cloud, as a JS
 
 - `schema/v0/aggregates.schema.json` — the contract. Everything else derives from it.
 - `schema/v0/fixtures/{valid,invalid}/` — examples every implementation must accept and reject.
-- Exports: `PROTOCOL_VERSION`, `AGGREGATES_PATH`, `AGGREGATES_SCHEMA_V0`, `LATENCY_BOUNDARIES_V0`, `LATENCY_BUCKETS_V0`, `latencyBucket()`, `CALLS_PER_REQUEST_BOUNDARIES_V0`, `CALLS_PER_REQUEST_BUCKETS_V0`, `callsPerRequestBucket()`, and the types `AggregatesBatch`, `Interval`, `Endpoint`, `LatencyHistogram`, `Dependency`, `PostgresStats`, …
+- Exports: `PROTOCOL_VERSION`, `ACCEPTED_PROTOCOL_VERSIONS_V0`, `AGGREGATES_PATH`, `AGGREGATES_SCHEMA_V0`, `LATENCY_BOUNDARIES_V0`, `LATENCY_BUCKETS_V0`, `latencyBucket()`, `CALLS_PER_REQUEST_BOUNDARIES_V0`, `CALLS_PER_REQUEST_BUCKETS_V0`, `callsPerRequestBucket()`, and the types `AggregatesBatch`, `Interval`, `Endpoint`, `LatencyHistogram`, `Dependency`, `PostgresStats`, …
 
 ## v0 in one sentence
 
@@ -16,7 +16,11 @@ Since **0.2.0** an endpoint may also carry `postgres`: how many queries each req
 
 ## How the protocol changes
 
-Fields are only ever **added**, and always optional. Each addition bumps the minor version, and the batch's `protocol` field is an enum of every published minor, so a cloud that speaks 0.2 still accepts an agent that speaks 0.1. Removing or renaming a field, or moving a histogram's bucket bounds, would be a major version on a new path. Bucket bounds are declared in the schema itself (`x-latency-boundaries-ms`, `x-queries-per-request-boundaries`), so they are part of the generated contract rather than a constant someone has to keep in sync.
+**The package version is the protocol version.** `@downtrace/protocol@0.5.0` speaks protocol `0.5.0`, and CI refuses to publish a release where the two disagree, so you can read the contract off the version in your lockfile. A release that changes the package without touching the contract moves the patch segment only.
+
+Since **0.6.0** a batch may also carry `profile`: what each route normally does, on its own cadence rather than with every interval. Each operation is a `hash` — the identity, which is what groups them — plus an optional normalised `text`, so a sender who would rather not ship the text of their queries keeps the whole analysis and loses only the label. Queries and error signatures share one shape, so the next kind needs no new field.
+
+Fields are only ever **added**, and always optional. Each addition bumps the minor version, and the batch's `protocol` field is an enum of every published minor, so a cloud that speaks 0.2 still accepts an agent that speaks 0.1. Removing or renaming a field, or moving a histogram's bucket bounds, would be a major version on a new path. Bucket bounds are declared in the schema itself (`x-latency-boundaries-ms`, `x-calls-per-request-boundaries`), and so are the versions themselves and the ingestion path (`x-ingest-path`), so they are part of the generated contract rather than a constant someone has to keep in sync.
 
 ## Source
 

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+//#region src/generated/paths.d.ts
+/** Path, relative to the ingest URL, that receives AggregatesBatch payloads. */
+declare const AGGREGATES_PATH = "/v0/aggregates";
+//#endregion
 //#region src/generated/aggregates.d.ts
 /**
  * A batch of per-interval, per-route aggregates sent by an agent to the cloud (POST /v0/aggregates).
@@ -6,7 +10,7 @@ interface AggregatesBatch {
   /**
    * Protocol version this batch conforms to. Every published minor of v0 stays acceptable.
    */
-  protocol: "0.1.0" | "0.2.0" | "0.3.0" | "0.4.0" | "0.5.0";
+  protocol: "0.1.0" | "0.2.0" | "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0";
   agent: AgentInfo;
   instance: InstanceInfo;
   deploy: DeployInfo;
@@ -15,6 +19,7 @@ interface AggregatesBatch {
    * @maxItems 6
    */
   intervals: [Interval] | [Interval, Interval] | [Interval, Interval, Interval] | [Interval, Interval, Interval, Interval] | [Interval, Interval, Interval, Interval, Interval] | [Interval, Interval, Interval, Interval, Interval, Interval];
+  profile?: Profile;
 }
 interface AgentInfo {
   name: string;
@@ -204,6 +209,64 @@ interface RuntimeHealth {
    */
   inFlightMax: number;
 }
+/**
+ * What each route normally does, sent once a minute rather than with every interval: a profile changes when the code changes, and at the aggregates' cadence it would not fit in the project's row budget (ADR 0017).
+ */
+interface Profile {
+  /**
+   * Profile window start, Unix epoch milliseconds.
+   */
+  start: number;
+  durationMs: number;
+  /**
+   * @maxItems 4096
+   */
+  endpoints: ProfileEndpoint[];
+}
+interface ProfileEndpoint {
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "OTHER";
+  /**
+   * Normalised route template, e.g. /products/:id, or (other).
+   */
+  route: string;
+  /**
+   * @maxItems 64
+   */
+  operations: Operation[];
+}
+/**
+ * One thing this route does, identified by a hash and labelled by an optional normalised text. The hash is the identity, so suppressing the text keeps the analysis whole (ADR 0017, invariant 5).
+ */
+interface Operation {
+  /**
+   * What kind of operation this is.
+   */
+  kind: "query" | "error";
+  /**
+   * Stable identity of the operation, or `(other)` for the bucket that holds the rest.
+   */
+  hash: string;
+  /**
+   * Normalised text, e.g. `SELECT id FROM products WHERE id = ?`. Optional: a user who would rather not send it keeps the whole analysis, only without the label.
+   */
+  text?: string;
+  /**
+   * Executions across every request on this route.
+   */
+  count: number;
+  /**
+   * Sum of their durations, in milliseconds.
+   */
+  totalMs: number;
+  /**
+   * Executions that failed.
+   */
+  errors?: number;
+  /**
+   * Only on the `(other)` bucket: how many distinct operations it merges, so a cap does not become a lie by omission.
+   */
+  distinct?: number;
+}
 //#endregion
 //#region src/generated/boundaries.d.ts
 /** Upper bounds (ms) of the fixed latency buckets; the last bucket is open-ended. */
@@ -215,20 +278,20 @@ declare const CALLS_PER_REQUEST_BOUNDARIES_V0: readonly number[];
 /** Number of calls-per-request buckets: boundaries + 1 open-ended bucket. */
 declare const CALLS_PER_REQUEST_BUCKETS_V0 = 8;
 //#endregion
+//#region src/generated/versions.d.ts
+/** Every published minor of v0, oldest first. The cloud never stops accepting one it published (ADR 0008). */
+declare const ACCEPTED_PROTOCOL_VERSIONS_V0: readonly ["0.1.0", "0.2.0", "0.3.0", "0.4.0", "0.5.0", "0.6.0"];
+/** The newest published minor: what an up-to-date agent stamps on every batch. */
+declare const PROTOCOL_VERSION = "0.6.0";
+//#endregion
 //#region src/index.d.ts
-/**
- * Version of the ingestion protocol this package speaks. Every published minor of v0 stays acceptable to the
- * cloud, so an agent on an older minor keeps working: fields are only ever added, and always optional (ADR 0008).
- */
-declare const PROTOCOL_VERSION = "0.5.0";
-/** Path, relative to the ingest URL, that receives AggregatesBatch payloads. */
-declare const AGGREGATES_PATH = "/v0/aggregates";
 /** The JSON Schema (draft 2020-12) for AggregatesBatch, for validators on either side. */
 declare const AGGREGATES_SCHEMA_V0: {
   $schema: string;
   $id: string;
   title: string;
   description: string;
+  "x-ingest-path": string;
   type: string;
   additionalProperties: boolean;
   required: string[];
@@ -255,6 +318,9 @@ declare const AGGREGATES_SCHEMA_V0: {
         $ref: string;
       };
     };
+    profile: {
+      $ref: string;
+    };
   };
   $defs: {
     AgentInfo: {
@@ -588,6 +654,96 @@ declare const AGGREGATES_SCHEMA_V0: {
         };
       };
     };
+    Profile: {
+      type: string;
+      additionalProperties: boolean;
+      description: string;
+      required: string[];
+      properties: {
+        start: {
+          type: string;
+          minimum: number;
+          description: string;
+        };
+        durationMs: {
+          type: string;
+          minimum: number;
+        };
+        endpoints: {
+          type: string;
+          maxItems: number;
+          items: {
+            $ref: string;
+          };
+        };
+      };
+    };
+    ProfileEndpoint: {
+      type: string;
+      additionalProperties: boolean;
+      required: string[];
+      properties: {
+        method: {
+          enum: string[];
+        };
+        route: {
+          type: string;
+          minLength: number;
+          maxLength: number;
+          description: string;
+        };
+        operations: {
+          type: string;
+          maxItems: number;
+          items: {
+            $ref: string;
+          };
+        };
+      };
+    };
+    Operation: {
+      type: string;
+      additionalProperties: boolean;
+      description: string;
+      required: string[];
+      properties: {
+        kind: {
+          enum: string[];
+          description: string;
+        };
+        hash: {
+          type: string;
+          minLength: number;
+          maxLength: number;
+          description: string;
+        };
+        text: {
+          type: string;
+          maxLength: number;
+          description: string;
+        };
+        count: {
+          type: string;
+          minimum: number;
+          description: string;
+        };
+        totalMs: {
+          type: string;
+          minimum: number;
+          description: string;
+        };
+        errors: {
+          type: string;
+          minimum: number;
+          description: string;
+        };
+        distinct: {
+          type: string;
+          minimum: number;
+          description: string;
+        };
+      };
+    };
   };
 };
 /** Index of the bucket a latency (ms) falls into: first boundary >= latency, else the open-ended last bucket. */
@@ -595,4 +751,4 @@ declare function latencyBucket(ms: number): number;
 /** Index of the bucket a call count falls into: first boundary >= count, else the open-ended last bucket. */
 declare function callsPerRequestBucket(calls: number): number;
 //#endregion
-export { AGGREGATES_PATH, AGGREGATES_SCHEMA_V0, type AgentInfo, type AggregatesBatch, CALLS_PER_REQUEST_BOUNDARIES_V0, CALLS_PER_REQUEST_BUCKETS_V0, type Dependency, type DeployInfo, type Endpoint, type InstanceInfo, type Interval, LATENCY_BOUNDARIES_V0, LATENCY_BUCKETS_V0, type LatencyHistogram, PROTOCOL_VERSION, type PostgresStats, type RuntimeHealth, type StatusClasses, callsPerRequestBucket, latencyBucket };
+export { ACCEPTED_PROTOCOL_VERSIONS_V0, AGGREGATES_PATH, AGGREGATES_SCHEMA_V0, type AgentInfo, type AggregatesBatch, CALLS_PER_REQUEST_BOUNDARIES_V0, CALLS_PER_REQUEST_BUCKETS_V0, type Dependency, type DeployInfo, type Endpoint, type InstanceInfo, type Interval, LATENCY_BOUNDARIES_V0, LATENCY_BUCKETS_V0, type LatencyHistogram, PROTOCOL_VERSION, type PostgresStats, type RuntimeHealth, type StatusClasses, callsPerRequestBucket, latencyBucket };

package/dist/index.js

@@ -4,6 +4,7 @@ var aggregates_schema_default = {
 	$id: "https://downtrace.io/schema/v0/aggregates.schema.json",
 	title: "AggregatesBatch",
 	description: "A batch of per-interval, per-route aggregates sent by an agent to the cloud (POST /v0/aggregates).",
+	"x-ingest-path": "/v0/aggregates",
 	type: "object",
 	additionalProperties: false,
 	required: [
@@ -21,7 +22,8 @@ var aggregates_schema_default = {
 				"0.2.0",
 				"0.3.0",
 				"0.4.0",
-				"0.5.0"
+				"0.5.0",
+				"0.6.0"
 			],
 			"description": "Protocol version this batch conforms to. Every published minor of v0 stays acceptable."
 		},
@@ -33,7 +35,8 @@ var aggregates_schema_default = {
 			"minItems": 1,
 			"maxItems": 6,
 			"items": { "$ref": "#/$defs/Interval" }
-		}
+		},
+		"profile": { "$ref": "#/$defs/Profile" }
 	},
 	$defs: {
 		"AgentInfo": {
@@ -458,6 +461,112 @@ var aggregates_schema_default = {
 					"description": "Time requests spent waiting to be able to talk to this dependency, on top of the time spent talking to it: a saturated connection pool shows up here and nowhere else. Optional; agents that cannot see it omit it."
 				}
 			}
+		},
+		"Profile": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "What each route normally does, sent once a minute rather than with every interval: a profile changes when the code changes, and at the aggregates' cadence it would not fit in the project's row budget (ADR 0017).",
+			"required": [
+				"start",
+				"durationMs",
+				"endpoints"
+			],
+			"properties": {
+				"start": {
+					"type": "integer",
+					"minimum": 0,
+					"description": "Profile window start, Unix epoch milliseconds."
+				},
+				"durationMs": {
+					"type": "integer",
+					"minimum": 1
+				},
+				"endpoints": {
+					"type": "array",
+					"maxItems": 4096,
+					"items": { "$ref": "#/$defs/ProfileEndpoint" }
+				}
+			}
+		},
+		"ProfileEndpoint": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"method",
+				"route",
+				"operations"
+			],
+			"properties": {
+				"method": { "enum": [
+					"GET",
+					"POST",
+					"PUT",
+					"PATCH",
+					"DELETE",
+					"HEAD",
+					"OPTIONS",
+					"OTHER"
+				] },
+				"route": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 256,
+					"description": "Normalised route template, e.g. /products/:id, or (other)."
+				},
+				"operations": {
+					"type": "array",
+					"maxItems": 64,
+					"items": { "$ref": "#/$defs/Operation" }
+				}
+			}
+		},
+		"Operation": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "One thing this route does, identified by a hash and labelled by an optional normalised text. The hash is the identity, so suppressing the text keeps the analysis whole (ADR 0017, invariant 5).",
+			"required": [
+				"kind",
+				"hash",
+				"count",
+				"totalMs"
+			],
+			"properties": {
+				"kind": {
+					"enum": ["query", "error"],
+					"description": "What kind of operation this is."
+				},
+				"hash": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 64,
+					"description": "Stable identity of the operation, or `(other)` for the bucket that holds the rest."
+				},
+				"text": {
+					"type": "string",
+					"maxLength": 1024,
+					"description": "Normalised text, e.g. `SELECT id FROM products WHERE id = ?`. Optional: a user who would rather not send it keeps the whole analysis, only without the label."
+				},
+				"count": {
+					"type": "integer",
+					"minimum": 0,
+					"description": "Executions across every request on this route."
+				},
+				"totalMs": {
+					"type": "number",
+					"minimum": 0,
+					"description": "Sum of their durations, in milliseconds."
+				},
+				"errors": {
+					"type": "integer",
+					"minimum": 0,
+					"description": "Executions that failed."
+				},
+				"distinct": {
+					"type": "integer",
+					"minimum": 0,
+					"description": "Only on the `(other)` bucket: how many distinct operations it merges, so a cap does not become a lie by omission."
+				}
+			}
 		}
 	}
 };
@@ -515,14 +624,24 @@ const CALLS_PER_REQUEST_BOUNDARIES_V0 = [
 /** Number of calls-per-request buckets: boundaries + 1 open-ended bucket. */
 const CALLS_PER_REQUEST_BUCKETS_V0 = 8;
 //#endregion
-//#region src/index.ts
-/**
-* Version of the ingestion protocol this package speaks. Every published minor of v0 stays acceptable to the
-* cloud, so an agent on an older minor keeps working: fields are only ever added, and always optional (ADR 0008).
-*/
-const PROTOCOL_VERSION = "0.5.0";
+//#region src/generated/paths.ts
 /** Path, relative to the ingest URL, that receives AggregatesBatch payloads. */
 const AGGREGATES_PATH = "/v0/aggregates";
+//#endregion
+//#region src/generated/versions.ts
+/** Every published minor of v0, oldest first. The cloud never stops accepting one it published (ADR 0008). */
+const ACCEPTED_PROTOCOL_VERSIONS_V0 = [
+	"0.1.0",
+	"0.2.0",
+	"0.3.0",
+	"0.4.0",
+	"0.5.0",
+	"0.6.0"
+];
+/** The newest published minor: what an up-to-date agent stamps on every batch. */
+const PROTOCOL_VERSION = "0.6.0";
+//#endregion
+//#region src/index.ts
 /** The JSON Schema (draft 2020-12) for AggregatesBatch, for validators on either side. */
 const AGGREGATES_SCHEMA_V0 = aggregates_schema_default;
 /** Index of the bucket a latency (ms) falls into: first boundary >= latency, else the open-ended last bucket. */
@@ -544,4 +663,4 @@ function callsPerRequestBucket(calls) {
 	return n;
 }
 //#endregion
-export { AGGREGATES_PATH, AGGREGATES_SCHEMA_V0, CALLS_PER_REQUEST_BOUNDARIES_V0, CALLS_PER_REQUEST_BUCKETS_V0, LATENCY_BOUNDARIES_V0, LATENCY_BUCKETS_V0, PROTOCOL_VERSION, callsPerRequestBucket, latencyBucket };
+export { ACCEPTED_PROTOCOL_VERSIONS_V0, AGGREGATES_PATH, AGGREGATES_SCHEMA_V0, CALLS_PER_REQUEST_BOUNDARIES_V0, CALLS_PER_REQUEST_BUCKETS_V0, LATENCY_BOUNDARIES_V0, LATENCY_BUCKETS_V0, PROTOCOL_VERSION, callsPerRequestBucket, latencyBucket };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downtrace/protocol",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Downtrace ingestion protocol: JSON Schema, fixtures and generated TypeScript types",
   "type": "module",
   "exports": {

package/schema/v0/aggregates.schema.json

@@ -3,13 +3,14 @@
   "$id": "https://downtrace.io/schema/v0/aggregates.schema.json",
   "title": "AggregatesBatch",
   "description": "A batch of per-interval, per-route aggregates sent by an agent to the cloud (POST /v0/aggregates).",
+  "x-ingest-path": "/v0/aggregates",
   "type": "object",
   "additionalProperties": false,
   "required": ["protocol", "agent", "instance", "deploy", "intervals"],
   "properties": {
     "protocol": {
       "type": "string",
-      "enum": ["0.1.0", "0.2.0", "0.3.0", "0.4.0", "0.5.0"],
+      "enum": ["0.1.0", "0.2.0", "0.3.0", "0.4.0", "0.5.0", "0.6.0"],
       "description": "Protocol version this batch conforms to. Every published minor of v0 stays acceptable."
     },
     "agent": {
@@ -28,6 +29,9 @@
       "items": {
         "$ref": "#/$defs/Interval"
       }
+    },
+    "profile": {
+      "$ref": "#/$defs/Profile"
     }
   },
   "$defs": {
@@ -364,6 +368,96 @@
           "description": "Time requests spent waiting to be able to talk to this dependency, on top of the time spent talking to it: a saturated connection pool shows up here and nowhere else. Optional; agents that cannot see it omit it."
         }
       }
+    },
+    "Profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "What each route normally does, sent once a minute rather than with every interval: a profile changes when the code changes, and at the aggregates' cadence it would not fit in the project's row budget (ADR 0017).",
+      "required": ["start", "durationMs", "endpoints"],
+      "properties": {
+        "start": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Profile window start, Unix epoch milliseconds."
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "endpoints": {
+          "type": "array",
+          "maxItems": 4096,
+          "items": {
+            "$ref": "#/$defs/ProfileEndpoint"
+          }
+        }
+      }
+    },
+    "ProfileEndpoint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["method", "route", "operations"],
+      "properties": {
+        "method": {
+          "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "OTHER"]
+        },
+        "route": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "description": "Normalised route template, e.g. /products/:id, or (other)."
+        },
+        "operations": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/Operation"
+          }
+        }
+      }
+    },
+    "Operation": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "One thing this route does, identified by a hash and labelled by an optional normalised text. The hash is the identity, so suppressing the text keeps the analysis whole (ADR 0017, invariant 5).",
+      "required": ["kind", "hash", "count", "totalMs"],
+      "properties": {
+        "kind": {
+          "enum": ["query", "error"],
+          "description": "What kind of operation this is."
+        },
+        "hash": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "description": "Stable identity of the operation, or `(other)` for the bucket that holds the rest."
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Normalised text, e.g. `SELECT id FROM products WHERE id = ?`. Optional: a user who would rather not send it keeps the whole analysis, only without the label."
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Executions across every request on this route."
+        },
+        "totalMs": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Sum of their durations, in milliseconds."
+        },
+        "errors": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Executions that failed."
+        },
+        "distinct": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Only on the `(other)` bucket: how many distinct operations it merges, so a cap does not become a lie by omission."
+        }
+      }
     }
   }
 }

package/schema/v0/fixtures/invalid/operation-without-hash.json

@@ -0,0 +1,64 @@
+{
+  "protocol": "0.6.0",
+  "agent": {
+    "name": "@downtrace/agent",
+    "version": "0.0.0",
+    "runtime": "node",
+    "runtimeVersion": "v24.0.0"
+  },
+  "instance": {
+    "id": "7d1e9c6a-4f2b-4c1e-9b0a-2f6d3e8a1c55",
+    "hostname": "web-1",
+    "pid": 4242
+  },
+  "deploy": {
+    "version": "8f71ac2",
+    "environment": "production"
+  },
+  "intervals": [
+    {
+      "start": 1756900000000,
+      "durationMs": 10000,
+      "endpoints": [
+        {
+          "method": "POST",
+          "route": "/checkout",
+          "count": 3,
+          "errors": 0,
+          "status": {
+            "success": 3,
+            "redirect": 0,
+            "clientError": 0,
+            "serverError": 0
+          },
+          "latency": {
+            "counts": [
+              0, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+            ],
+            "sum": 2.4,
+            "max": 0.9
+          }
+        }
+      ]
+    }
+  ],
+  "profile": {
+    "start": 1756900000000,
+    "durationMs": 60000,
+    "endpoints": [
+      {
+        "method": "POST",
+        "route": "/checkout",
+        "operations": [
+          {
+            "kind": "query",
+            "text": "SELECT id, price_cents FROM products WHERE id = ?",
+            "count": 1440,
+            "totalMs": 812.4,
+            "errors": 0
+          }
+        ]
+      }
+    ]
+  }
+}

package/schema/v0/fixtures/valid/profile.json

@@ -0,0 +1,86 @@
+{
+  "protocol": "0.6.0",
+  "agent": {
+    "name": "@downtrace/agent",
+    "version": "0.0.0",
+    "runtime": "node",
+    "runtimeVersion": "v24.0.0"
+  },
+  "instance": {
+    "id": "7d1e9c6a-4f2b-4c1e-9b0a-2f6d3e8a1c55",
+    "hostname": "web-1",
+    "pid": 4242
+  },
+  "deploy": {
+    "version": "8f71ac2",
+    "environment": "production"
+  },
+  "intervals": [
+    {
+      "start": 1756900000000,
+      "durationMs": 10000,
+      "endpoints": [
+        {
+          "method": "POST",
+          "route": "/checkout",
+          "count": 3,
+          "errors": 0,
+          "status": {
+            "success": 3,
+            "redirect": 0,
+            "clientError": 0,
+            "serverError": 0
+          },
+          "latency": {
+            "counts": [
+              0, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+            ],
+            "sum": 2.4,
+            "max": 0.9
+          }
+        }
+      ]
+    }
+  ],
+  "profile": {
+    "start": 1756900000000,
+    "durationMs": 60000,
+    "endpoints": [
+      {
+        "method": "POST",
+        "route": "/checkout",
+        "operations": [
+          {
+            "kind": "query",
+            "hash": "b7c1d0f2a3e45861",
+            "text": "SELECT id, price_cents FROM products WHERE id = ?",
+            "count": 1440,
+            "totalMs": 812.4,
+            "errors": 0
+          },
+          {
+            "kind": "query",
+            "hash": "9a02ff31b4c7d5e0",
+            "count": 720,
+            "totalMs": 190.1
+          },
+          {
+            "kind": "error",
+            "hash": "c4d5e6f708192a3b",
+            "text": "PoolTimeoutError",
+            "count": 3,
+            "totalMs": 15003.2,
+            "errors": 3
+          },
+          {
+            "kind": "query",
+            "hash": "(other)",
+            "count": 96,
+            "totalMs": 41.7,
+            "distinct": 7
+          }
+        ]
+      }
+    ]
+  }
+}