@x12i/countex 1.0.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +192 -3
- package/dist/backup/export.d.ts +2 -0
- package/dist/backup/export.d.ts.map +1 -1
- package/dist/backup/export.js +2 -0
- package/dist/backup/export.js.map +1 -1
- package/dist/cli.d.ts +12 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +190 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/buffer.d.ts +4 -3
- package/dist/core/buffer.d.ts.map +1 -1
- package/dist/core/buffer.js +65 -9
- package/dist/core/buffer.js.map +1 -1
- package/dist/core/countex.d.ts.map +1 -1
- package/dist/core/countex.js +30 -3
- package/dist/core/countex.js.map +1 -1
- package/dist/core/extraction.d.ts +14 -2
- package/dist/core/extraction.d.ts.map +1 -1
- package/dist/core/extraction.js +117 -1
- package/dist/core/extraction.js.map +1 -1
- package/dist/core/mapping.d.ts.map +1 -1
- package/dist/core/mapping.js +44 -1
- package/dist/core/mapping.js.map +1 -1
- package/dist/core/timeframe.d.ts +7 -0
- package/dist/core/timeframe.d.ts.map +1 -1
- package/dist/core/timeframe.js +88 -0
- package/dist/core/timeframe.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/insights/advisors/fanout-health.d.ts +3 -0
- package/dist/insights/advisors/fanout-health.d.ts.map +1 -0
- package/dist/insights/advisors/fanout-health.js +3 -0
- package/dist/insights/advisors/fanout-health.js.map +1 -0
- package/dist/insights/advisors/map-health.d.ts +6 -0
- package/dist/insights/advisors/map-health.d.ts.map +1 -0
- package/dist/insights/advisors/map-health.js +154 -0
- package/dist/insights/advisors/map-health.js.map +1 -0
- package/dist/insights/advisors/resource-advisor.d.ts +4 -0
- package/dist/insights/advisors/resource-advisor.d.ts.map +1 -0
- package/dist/insights/advisors/resource-advisor.js +102 -0
- package/dist/insights/advisors/resource-advisor.js.map +1 -0
- package/dist/insights/advisors/retention-advisor.d.ts +2 -0
- package/dist/insights/advisors/retention-advisor.d.ts.map +1 -0
- package/dist/insights/advisors/retention-advisor.js +6 -0
- package/dist/insights/advisors/retention-advisor.js.map +1 -0
- package/dist/insights/advisors-subpath.d.ts +4 -0
- package/dist/insights/advisors-subpath.d.ts.map +1 -0
- package/dist/insights/advisors-subpath.js +10 -0
- package/dist/insights/advisors-subpath.js.map +1 -0
- package/dist/insights/anomaly/baseline.d.ts +4 -0
- package/dist/insights/anomaly/baseline.d.ts.map +1 -0
- package/dist/insights/anomaly/baseline.js +54 -0
- package/dist/insights/anomaly/baseline.js.map +1 -0
- package/dist/insights/anomaly/detect-anomalies.d.ts +6 -0
- package/dist/insights/anomaly/detect-anomalies.d.ts.map +1 -0
- package/dist/insights/anomaly/detect-anomalies.js +245 -0
- package/dist/insights/anomaly/detect-anomalies.js.map +1 -0
- package/dist/insights/anomaly/ewma.d.ts +2 -0
- package/dist/insights/anomaly/ewma.d.ts.map +1 -0
- package/dist/insights/anomaly/ewma.js +15 -0
- package/dist/insights/anomaly/ewma.js.map +1 -0
- package/dist/insights/anomaly/missing-activity.d.ts +3 -0
- package/dist/insights/anomaly/missing-activity.d.ts.map +1 -0
- package/dist/insights/anomaly/missing-activity.js +8 -0
- package/dist/insights/anomaly/missing-activity.js.map +1 -0
- package/dist/insights/anomaly/robust-zscore.d.ts +2 -0
- package/dist/insights/anomaly/robust-zscore.d.ts.map +1 -0
- package/dist/insights/anomaly/robust-zscore.js +9 -0
- package/dist/insights/anomaly/robust-zscore.js.map +1 -0
- package/dist/insights/anomaly-subpath.d.ts +7 -0
- package/dist/insights/anomaly-subpath.d.ts.map +1 -0
- package/dist/insights/anomaly-subpath.js +20 -0
- package/dist/insights/anomaly-subpath.js.map +1 -0
- package/dist/insights/comparison/compare-periods.d.ts +5 -0
- package/dist/insights/comparison/compare-periods.d.ts.map +1 -0
- package/dist/insights/comparison/compare-periods.js +64 -0
- package/dist/insights/comparison/compare-periods.js.map +1 -0
- package/dist/insights/comparison/growth-rate.d.ts +3 -0
- package/dist/insights/comparison/growth-rate.d.ts.map +1 -0
- package/dist/insights/comparison/growth-rate.js +3 -0
- package/dist/insights/comparison/growth-rate.js.map +1 -0
- package/dist/insights/comparison/moving-average.d.ts +2 -0
- package/dist/insights/comparison/moving-average.d.ts.map +1 -0
- package/dist/insights/comparison/moving-average.js +6 -0
- package/dist/insights/comparison/moving-average.js.map +1 -0
- package/dist/insights/comparison/trend.d.ts +5 -0
- package/dist/insights/comparison/trend.d.ts.map +1 -0
- package/dist/insights/comparison/trend.js +84 -0
- package/dist/insights/comparison/trend.js.map +1 -0
- package/dist/insights/errors.d.ts +25 -0
- package/dist/insights/errors.d.ts.map +1 -0
- package/dist/insights/errors.js +54 -0
- package/dist/insights/errors.js.map +1 -0
- package/dist/insights/forecast/budget.d.ts +2 -0
- package/dist/insights/forecast/budget.d.ts.map +1 -0
- package/dist/insights/forecast/budget.js +6 -0
- package/dist/insights/forecast/budget.js.map +1 -0
- package/dist/insights/forecast/capacity.d.ts +2 -0
- package/dist/insights/forecast/capacity.d.ts.map +1 -0
- package/dist/insights/forecast/capacity.js +3 -0
- package/dist/insights/forecast/capacity.js.map +1 -0
- package/dist/insights/forecast/forecast.d.ts +5 -0
- package/dist/insights/forecast/forecast.d.ts.map +1 -0
- package/dist/insights/forecast/forecast.js +103 -0
- package/dist/insights/forecast/forecast.js.map +1 -0
- package/dist/insights/forecast/retention.d.ts +2 -0
- package/dist/insights/forecast/retention.d.ts.map +1 -0
- package/dist/insights/forecast/retention.js +3 -0
- package/dist/insights/forecast/retention.js.map +1 -0
- package/dist/insights/index.d.ts +4 -0
- package/dist/insights/index.d.ts.map +1 -0
- package/dist/insights/index.js +23 -0
- package/dist/insights/index.js.map +1 -0
- package/dist/insights/insights-client.d.ts +33 -0
- package/dist/insights/insights-client.d.ts.map +1 -0
- package/dist/insights/insights-client.js +344 -0
- package/dist/insights/insights-client.js.map +1 -0
- package/dist/insights/llm-subpath.d.ts +4 -0
- package/dist/insights/llm-subpath.d.ts.map +1 -0
- package/dist/insights/llm-subpath.js +10 -0
- package/dist/insights/llm-subpath.js.map +1 -0
- package/dist/insights/optimization/cost-optimizer.d.ts +6 -0
- package/dist/insights/optimization/cost-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/cost-optimizer.js +98 -0
- package/dist/insights/optimization/cost-optimizer.js.map +1 -0
- package/dist/insights/optimization/latency-optimizer.d.ts +3 -0
- package/dist/insights/optimization/latency-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/latency-optimizer.js +3 -0
- package/dist/insights/optimization/latency-optimizer.js.map +1 -0
- package/dist/insights/optimization/threshold-advisor.d.ts +2 -0
- package/dist/insights/optimization/threshold-advisor.d.ts.map +1 -0
- package/dist/insights/optimization/threshold-advisor.js +3 -0
- package/dist/insights/optimization/threshold-advisor.js.map +1 -0
- package/dist/insights/optimization/token-optimizer.d.ts +4 -0
- package/dist/insights/optimization/token-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/token-optimizer.js +133 -0
- package/dist/insights/optimization/token-optimizer.js.map +1 -0
- package/dist/insights/ranking/contribution.d.ts +2 -0
- package/dist/insights/ranking/contribution.d.ts.map +1 -0
- package/dist/insights/ranking/contribution.js +6 -0
- package/dist/insights/ranking/contribution.js.map +1 -0
- package/dist/insights/ranking/helpers.d.ts +22 -0
- package/dist/insights/ranking/helpers.d.ts.map +1 -0
- package/dist/insights/ranking/helpers.js +88 -0
- package/dist/insights/ranking/helpers.js.map +1 -0
- package/dist/insights/ranking/pareto.d.ts +2 -0
- package/dist/insights/ranking/pareto.d.ts.map +1 -0
- package/dist/insights/ranking/pareto.js +6 -0
- package/dist/insights/ranking/pareto.js.map +1 -0
- package/dist/insights/ranking/slices.d.ts +2 -0
- package/dist/insights/ranking/slices.d.ts.map +1 -0
- package/dist/insights/ranking/slices.js +6 -0
- package/dist/insights/ranking/slices.js.map +1 -0
- package/dist/insights/ranking/top-bottom.d.ts +2 -0
- package/dist/insights/ranking/top-bottom.d.ts.map +1 -0
- package/dist/insights/ranking/top-bottom.js +7 -0
- package/dist/insights/ranking/top-bottom.js.map +1 -0
- package/dist/insights/recommendations/evidence.d.ts +2 -0
- package/dist/insights/recommendations/evidence.d.ts.map +1 -0
- package/dist/insights/recommendations/evidence.js +3 -0
- package/dist/insights/recommendations/evidence.js.map +1 -0
- package/dist/insights/recommendations/recommendation.d.ts +6 -0
- package/dist/insights/recommendations/recommendation.d.ts.map +1 -0
- package/dist/insights/recommendations/recommendation.js +25 -0
- package/dist/insights/recommendations/recommendation.js.map +1 -0
- package/dist/insights/recommendations/severity.d.ts +2 -0
- package/dist/insights/recommendations/severity.d.ts.map +1 -0
- package/dist/insights/recommendations/severity.js +3 -0
- package/dist/insights/recommendations/severity.js.map +1 -0
- package/dist/insights/rules/evaluate-rules.d.ts +5 -0
- package/dist/insights/rules/evaluate-rules.d.ts.map +1 -0
- package/dist/insights/rules/evaluate-rules.js +156 -0
- package/dist/insights/rules/evaluate-rules.js.map +1 -0
- package/dist/insights/types.d.ts +405 -0
- package/dist/insights/types.d.ts.map +1 -0
- package/dist/insights/types.js +3 -0
- package/dist/insights/types.js.map +1 -0
- package/dist/insights/utils/formatting.d.ts +4 -0
- package/dist/insights/utils/formatting.d.ts.map +1 -0
- package/dist/insights/utils/formatting.js +21 -0
- package/dist/insights/utils/formatting.js.map +1 -0
- package/dist/insights/utils/grouping.d.ts +2 -0
- package/dist/insights/utils/grouping.d.ts.map +1 -0
- package/dist/insights/utils/grouping.js +8 -0
- package/dist/insights/utils/grouping.js.map +1 -0
- package/dist/insights/utils/query-builder.d.ts +21 -0
- package/dist/insights/utils/query-builder.d.ts.map +1 -0
- package/dist/insights/utils/query-builder.js +107 -0
- package/dist/insights/utils/query-builder.js.map +1 -0
- package/dist/insights/utils/row-value.d.ts +5 -0
- package/dist/insights/utils/row-value.d.ts.map +1 -0
- package/dist/insights/utils/row-value.js +36 -0
- package/dist/insights/utils/row-value.js.map +1 -0
- package/dist/insights/utils/stats.d.ts +28 -0
- package/dist/insights/utils/stats.d.ts.map +1 -0
- package/dist/insights/utils/stats.js +125 -0
- package/dist/insights/utils/stats.js.map +1 -0
- package/dist/query/formatter.d.ts.map +1 -1
- package/dist/query/formatter.js +202 -24
- package/dist/query/formatter.js.map +1 -1
- package/dist/query/planner.d.ts +10 -2
- package/dist/query/planner.d.ts.map +1 -1
- package/dist/query/planner.js +39 -2
- package/dist/query/planner.js.map +1 -1
- package/dist/storage/memory.d.ts.map +1 -1
- package/dist/storage/memory.js +78 -4
- package/dist/storage/memory.js.map +1 -1
- package/dist/storage/mongo.d.ts.map +1 -1
- package/dist/storage/mongo.js +61 -16
- package/dist/storage/mongo.js.map +1 -1
- package/dist/storage/redis.d.ts +6 -7
- package/dist/storage/redis.d.ts.map +1 -1
- package/dist/storage/redis.js +108 -39
- package/dist/storage/redis.js.map +1 -1
- package/dist/types/index.d.ts +88 -4
- package/dist/types/index.d.ts.map +1 -1
- package/docs/INSIGHTS.md +59 -0
- package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -0
- package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -0
- package/docs/INSIGHTS_RESOURCE_ADVISOR.md +31 -0
- package/docs/guides/README.md +29 -0
- package/docs/guides/adapter-memory.md +48 -0
- package/docs/guides/adapter-mongo.md +50 -0
- package/docs/guides/adapter-redis.md +47 -0
- package/docs/guides/backup-export.md +39 -0
- package/docs/guides/cardinality.md +50 -0
- package/docs/guides/cli.md +45 -0
- package/docs/guides/client-events.md +49 -0
- package/docs/guides/counter-maps.md +116 -0
- package/docs/guides/idempotency.md +39 -0
- package/docs/guides/ingestion-and-flush.md +67 -0
- package/docs/guides/insights-advisors-and-optimization.md +39 -0
- package/docs/guides/insights-anomalies-and-rules.md +48 -0
- package/docs/guides/insights-comparison-and-trends.md +47 -0
- package/docs/guides/insights-forecasting-and-budget.md +61 -0
- package/docs/guides/insights-overview.md +76 -0
- package/docs/guides/insights-ranking.md +81 -0
- package/docs/guides/measures.md +67 -0
- package/docs/guides/querying.md +79 -0
- package/docs/guides/timeframes-and-bucketing.md +55 -0
- package/docs/internals/README.md +20 -0
- package/docs/internals/internal-architecture-overview.md +65 -0
- package/docs/internals/internal-backup-stream.md +23 -0
- package/docs/internals/internal-buffer-merge-and-flush.md +51 -0
- package/docs/internals/internal-cardinality.md +30 -0
- package/docs/internals/internal-idempotency.md +36 -0
- package/docs/internals/internal-ingest-pipeline.md +52 -0
- package/docs/internals/internal-insights-layer.md +36 -0
- package/docs/internals/internal-mapping-validation-and-extraction.md +59 -0
- package/docs/internals/internal-measures-and-scales.md +35 -0
- package/docs/internals/internal-query-path.md +46 -0
- package/docs/internals/internal-storage-memory.md +13 -0
- package/docs/internals/internal-storage-mongo.md +24 -0
- package/docs/internals/internal-storage-redis.md +31 -0
- package/docs/internals/internal-timeframe-bucketing.md +33 -0
- package/package.json +45 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/storage/redis.ts"],"names":[],"mappings":"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"}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -6,7 +6,44 @@
|
|
|
6
6
|
*/
|
|
7
7
|
export type DimensionValue = string | number | boolean | null;
|
|
8
8
|
export type Dimensions = Record<string, DimensionValue>;
|
|
9
|
-
export type TimeframeType = "day" | "week" | "month" | "quarter" | "year" | "all";
|
|
9
|
+
export type TimeframeType = "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year" | "all";
|
|
10
|
+
/** Aggregations maintained per measure on each cell. `avg` is derived at query time. */
|
|
11
|
+
export type MeasureAgg = "sum" | "count" | "min" | "max";
|
|
12
|
+
/** Declares how to extract and aggregate a numeric measure from each event. */
|
|
13
|
+
export interface MeasureMapping {
|
|
14
|
+
/** Stable name (becomes a key under cell.measures). */
|
|
15
|
+
name: string;
|
|
16
|
+
path: PathExpr;
|
|
17
|
+
/** Which aggregations to maintain. Defaults to ["sum"]. */
|
|
18
|
+
aggregations?: MeasureAgg[];
|
|
19
|
+
/**
|
|
20
|
+
* When the path resolves to nothing or non-numeric.
|
|
21
|
+
* "skip" — omit this measure for this increment (default).
|
|
22
|
+
* "zero" — treat as 0 for sum/count; omit from min/max for this increment.
|
|
23
|
+
* "drop" — skip the entire increment (like a required dimension).
|
|
24
|
+
*/
|
|
25
|
+
onMissing?: "skip" | "zero" | "drop";
|
|
26
|
+
/** Informational; not used by the engine. */
|
|
27
|
+
unit?: string;
|
|
28
|
+
/**
|
|
29
|
+
* Optional integer scaling for fixed-point storage. Extracted value times scale is truncated;
|
|
30
|
+
* durable storage holds integers and divides on read.
|
|
31
|
+
*/
|
|
32
|
+
scale?: number;
|
|
33
|
+
/** If true, negative values emit measure_invalid and skip this measure (unless onMissing applies first). */
|
|
34
|
+
unsigned?: boolean;
|
|
35
|
+
}
|
|
36
|
+
/** Stored or returned aggregates for one measure. `avg` is usually query-time only. */
|
|
37
|
+
export interface MeasureValue {
|
|
38
|
+
sum?: number;
|
|
39
|
+
count?: number;
|
|
40
|
+
min?: number;
|
|
41
|
+
max?: number;
|
|
42
|
+
/** Present when derived at query time from grouped sum/count. */
|
|
43
|
+
avg?: number;
|
|
44
|
+
/** When fixed-point storage is used, present on reads from durable storage. */
|
|
45
|
+
scale?: number;
|
|
46
|
+
}
|
|
10
47
|
export type JsonValue = string | number | boolean | null | JsonValue[] | {
|
|
11
48
|
[key: string]: JsonValue;
|
|
12
49
|
};
|
|
@@ -88,6 +125,8 @@ export interface CounterMap {
|
|
|
88
125
|
subjects: SubjectMapping[];
|
|
89
126
|
metrics: MetricMapping[];
|
|
90
127
|
dimensions: DimensionMapping[];
|
|
128
|
+
/** Optional numeric measures (cost, tokens, latency, …). */
|
|
129
|
+
measures?: MeasureMapping[];
|
|
91
130
|
delta?: DeltaMapping;
|
|
92
131
|
timeframes: TimeframeType[];
|
|
93
132
|
options?: MappingOptions;
|
|
@@ -114,6 +153,8 @@ export interface CounterCell {
|
|
|
114
153
|
/** Materialized dimension values keyed by dimension name. */
|
|
115
154
|
dimensions: Dimensions;
|
|
116
155
|
count: number;
|
|
156
|
+
/** Named aggregates when the map declares measures. */
|
|
157
|
+
measures?: Record<string, MeasureValue>;
|
|
117
158
|
/** Optional metadata stored alongside the cell. */
|
|
118
159
|
createdAt?: Date;
|
|
119
160
|
updatedAt?: Date;
|
|
@@ -124,9 +165,19 @@ export type CellIdentity = Omit<CounterCell, "count" | "createdAt" | "updatedAt"
|
|
|
124
165
|
* A pending delta — what Countex writes during a flush. Cells are addressed
|
|
125
166
|
* by their full identity; storage applies +delta atomically.
|
|
126
167
|
*/
|
|
168
|
+
/** Per-measure deltas merged into a cell (same merge rules as the ingest buffer). */
|
|
169
|
+
export interface PendingMeasureDelta {
|
|
170
|
+
sum?: number;
|
|
171
|
+
count?: number;
|
|
172
|
+
min?: number;
|
|
173
|
+
max?: number;
|
|
174
|
+
}
|
|
127
175
|
export interface PendingDelta {
|
|
128
176
|
identity: CellIdentity;
|
|
129
177
|
delta: number;
|
|
178
|
+
measures?: Record<string, PendingMeasureDelta>;
|
|
179
|
+
/** Fixed-point scale per measure (map config); persisted on Mongo $setOnInsert only. */
|
|
180
|
+
measureScales?: Record<string, number>;
|
|
130
181
|
}
|
|
131
182
|
export interface TimeframeRange {
|
|
132
183
|
type: TimeframeType;
|
|
@@ -140,8 +191,14 @@ export interface SubjectFilter {
|
|
|
140
191
|
ids?: Array<string | number>;
|
|
141
192
|
}
|
|
142
193
|
export type DimensionFilter = Record<string, DimensionValue[]>;
|
|
143
|
-
export type GroupByField = "subject" | "metric" | "timeframeKey" | `dim:${string}`;
|
|
194
|
+
export type GroupByField = "subject" | "subjectType" | "metric" | "timeframeKey" | `dim:${string}`;
|
|
144
195
|
export type ResultFormat = "cells" | "table" | "matrix" | "timeseries";
|
|
196
|
+
/** Sort key for grouped query results. Default dir "desc" when omitted (matches "-count"). */
|
|
197
|
+
export interface QueryOrderByMeasure {
|
|
198
|
+
measure: string;
|
|
199
|
+
agg: "sum" | "min" | "max" | "count" | "avg";
|
|
200
|
+
dir?: "asc" | "desc";
|
|
201
|
+
}
|
|
145
202
|
export interface QuerySpec {
|
|
146
203
|
scope: string;
|
|
147
204
|
counterId: string;
|
|
@@ -153,8 +210,24 @@ export interface QuerySpec {
|
|
|
153
210
|
groupBy?: GroupByField[];
|
|
154
211
|
/** Output shape. Defaults to "cells". */
|
|
155
212
|
format?: ResultFormat;
|
|
156
|
-
/**
|
|
157
|
-
|
|
213
|
+
/**
|
|
214
|
+
* Measures to include in each row. Default / omit: count only.
|
|
215
|
+
* "*" returns all measures present on merged cells.
|
|
216
|
+
*/
|
|
217
|
+
measures?: string[] | "*";
|
|
218
|
+
/**
|
|
219
|
+
* Rate: divide count or a measure sum by elapsed time in the queried window
|
|
220
|
+
* (non-timeseries) or per bucket (timeseries). Not stored.
|
|
221
|
+
*/
|
|
222
|
+
rate?: {
|
|
223
|
+
of?: "count" | {
|
|
224
|
+
measure: string;
|
|
225
|
+
agg: "sum";
|
|
226
|
+
};
|
|
227
|
+
per: "second" | "minute" | "hour" | "day";
|
|
228
|
+
};
|
|
229
|
+
/** Sort by aggregated count or by a measure aggregation. */
|
|
230
|
+
orderBy?: "count" | "-count" | QueryOrderByMeasure;
|
|
158
231
|
limit?: number;
|
|
159
232
|
/** If true, force read from durable storage (skip cache). */
|
|
160
233
|
bypassCache?: boolean;
|
|
@@ -164,11 +237,15 @@ export interface QuerySpec {
|
|
|
164
237
|
export interface QueryRow {
|
|
165
238
|
keys: Record<string, string | number>;
|
|
166
239
|
count: number;
|
|
240
|
+
measures?: Record<string, MeasureValue>;
|
|
241
|
+
rate?: number;
|
|
167
242
|
}
|
|
168
243
|
/** Generic time-series row. */
|
|
169
244
|
export interface TimeseriesPoint {
|
|
170
245
|
timeframeKey: string;
|
|
171
246
|
count: number;
|
|
247
|
+
measures?: Record<string, MeasureValue>;
|
|
248
|
+
rate?: number;
|
|
172
249
|
/** Present when other groupings are also active. */
|
|
173
250
|
keys?: Record<string, string | number>;
|
|
174
251
|
}
|
|
@@ -313,5 +390,12 @@ export interface CountexEvents {
|
|
|
313
390
|
scopeId: string;
|
|
314
391
|
eventId: string;
|
|
315
392
|
};
|
|
393
|
+
measure_invalid: {
|
|
394
|
+
scopeId: string;
|
|
395
|
+
counterId: string;
|
|
396
|
+
measureName: string;
|
|
397
|
+
reason: "missing" | "non_numeric" | "non_finite" | "negative_for_unsigned" | "precision_truncated";
|
|
398
|
+
raw?: unknown;
|
|
399
|
+
};
|
|
316
400
|
}
|
|
317
401
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAExD,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,MAAM,GACN,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,GACN,KAAK,CAAC;AAEV,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,2DAA2D;IAC3D,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAMtD;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,iHAAiH;IACjH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACxC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC1B,SAAS,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IAE9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAE/B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAE5B,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,UAAU,EAAE,aAAa,EAAE,CAAC;IAE5B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa,EAAE,aAAa,CAAC;IAC7B,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IAErB,2FAA2F;IAC3F,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,CAAC;IAEjB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;IAEvB,KAAK,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAExC,mDAAmD;IACnD,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAElF;;;GAGG;AACH,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AAE/D,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,aAAa,GACb,QAAQ,GACR,cAAc,GACd,OAAO,MAAM,EAAE,CAAC;AAEpB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC;IAC7C,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,cAAc,CAAC;IAE1B,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEjC,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAEzB,yCAAyC;IACzC,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE1B;;;OAGG;IACH,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,OAAO,GAAG;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,KAAK,CAAA;SAAE,CAAC;QAC/C,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;KAC3C,CAAC;IAEF,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF,mCAAmC;IACnC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEpF;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhC,wEAAwE;IACxE,WAAW,CACT,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC,EAC5D,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9B,uBAAuB;IACvB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF;;;OAGG;IACH,SAAS,CACP,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAE5E,+DAA+D;IAC/D,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;OAGG;IACH,aAAa,CAAC,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAMD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,sEAAsE;IACtE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC9B,mBAAmB,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,cAAc,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,cAAc,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;QACnG,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH"}
|
package/docs/INSIGHTS.md
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Countex Insights
|
|
2
|
+
|
|
3
|
+
## Mental model
|
|
4
|
+
|
|
5
|
+
Insights sits **on top of** `countex.query()`. It does not bypass storage adapters. Each operation builds a `QuerySpec`, runs one or more queries, then derives rankings, deltas, anomalies, or recommendations from the returned rows.
|
|
6
|
+
|
|
7
|
+
Primitives are generic: `scope`, `counterId`, `timeframe`, filters, `groupBy`, `measure` selectors (`count`, `name.sum`, `name.rate`, …), and optional counter map metadata for advisors.
|
|
8
|
+
|
|
9
|
+
## Ranking and slicing
|
|
10
|
+
|
|
11
|
+
- **topN / bottomN** — Sort grouped rows by `count` or a measure aggregation; bottom omits zero values by default (sparse-safe).
|
|
12
|
+
- **topPercent / bottomPercent** — Take the top or bottom _fraction of groups_ (by rank), then report value share of totals.
|
|
13
|
+
- **pareto** — Smallest prefix of contributors reaching a target cumulative share of total value.
|
|
14
|
+
- **contribution** — Full sorted breakdown with `share` and `cumulativeShare`.
|
|
15
|
+
|
|
16
|
+
## Period comparison
|
|
17
|
+
|
|
18
|
+
**comparePeriods** runs two queries (`current` and `previous` timeframes) with the same `groupBy` and measure. Rows are merged on a **stable serialized key** so grouping is order-independent. Directions include `new`, `missing`, `up`, `down`, and `flat`. Percent change is `null` when the previous value is zero.
|
|
19
|
+
|
|
20
|
+
## Anomalies
|
|
21
|
+
|
|
22
|
+
See [INSIGHTS_ANOMALY_DETECTION.md](./INSIGHTS_ANOMALY_DETECTION.md). High level: baseline window is derived from `lookback` (e.g. `14d`) immediately before the evaluation window; per-series robust z-score or threshold checks produce explainable findings.
|
|
23
|
+
|
|
24
|
+
## Rules
|
|
25
|
+
|
|
26
|
+
**evaluateRules** evaluates absolute measure thresholds or simple ratios (numerator/denominator queries per group). Failures can attach a `CountexRecommendation`.
|
|
27
|
+
|
|
28
|
+
## Recommendations
|
|
29
|
+
|
|
30
|
+
Advisor APIs return **evidence-first** objects: timeframe, numeric values, optional rows/baselines, suggested actions as opaque `{ kind, payload }` pairs.
|
|
31
|
+
|
|
32
|
+
## Examples
|
|
33
|
+
|
|
34
|
+
```ts
|
|
35
|
+
import { createCountexInsights } from "@x12i/countex/insights";
|
|
36
|
+
|
|
37
|
+
const insights = createCountexInsights({
|
|
38
|
+
countex,
|
|
39
|
+
durable,
|
|
40
|
+
mapsByCounterId: new Map([[map.counterId, map]]),
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
await insights.topN({
|
|
44
|
+
scope,
|
|
45
|
+
counterId,
|
|
46
|
+
timeframe: { type: "day", from: "2026-05-01", to: "2026-05-07" },
|
|
47
|
+
groupBy: ["dim:region"],
|
|
48
|
+
measure: "errors.rate",
|
|
49
|
+
n: 20,
|
|
50
|
+
});
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Observability
|
|
54
|
+
|
|
55
|
+
`CountexInsights` is an `EventEmitter`: `insight_query`, `recommendation`, `anomaly`, `insufficient_data`.
|
|
56
|
+
|
|
57
|
+
## Errors
|
|
58
|
+
|
|
59
|
+
Typed errors extend `CountexInsightError` — see `@x12i/countex/insights` exports.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Insights: anomaly detection
|
|
2
|
+
|
|
3
|
+
## Baselines
|
|
4
|
+
|
|
5
|
+
`detectAnomalies` evaluates the requested **timeframe** against a **baseline window** placed immediately before it. The default lookback string (`14d`, `24h`, `2w`, …) is converted into a number of buckets matching the query timeframe type.
|
|
6
|
+
|
|
7
|
+
## Methods
|
|
8
|
+
|
|
9
|
+
- **robust-zscore** (default) — Uses median and MAD; `0.6745 * (x - median) / MAD`. When MAD is zero, a simple deviation fallback runs.
|
|
10
|
+
- **zscore** — Classical mean/stddev (more sensitive to outliers).
|
|
11
|
+
- **threshold** — Multiplicative deviation from the baseline median (e.g. spike when `observed > 2× median`).
|
|
12
|
+
- **ewma** — Lightweight deviation check vs median (placeholder-style when full EWMA series is not stored).
|
|
13
|
+
|
|
14
|
+
Sensitivity maps to z thresholds: low ≈ 4.0, medium ≈ 3.5, high ≈ 3.0.
|
|
15
|
+
|
|
16
|
+
## Missing activity
|
|
17
|
+
|
|
18
|
+
When the baseline median exceeds a small floor and the observed window is near zero, a **missing** anomaly is emitted.
|
|
19
|
+
|
|
20
|
+
## Spike / drop
|
|
21
|
+
|
|
22
|
+
Large positive z → spike; large negative z → drop (when enabled in `anomalyTypes`).
|
|
23
|
+
|
|
24
|
+
## Compare-by modes
|
|
25
|
+
|
|
26
|
+
- **rolling** — All baseline buckets for the same group key.
|
|
27
|
+
- **same-hour-of-day** / **same-day-of-week** — Filters baseline buckets to those matching the evaluation bucket’s calendar slot.
|
|
28
|
+
|
|
29
|
+
## Limitations
|
|
30
|
+
|
|
31
|
+
- Requires enough baseline buckets (`minBaselineBuckets`, default from factory defaults).
|
|
32
|
+
- Cardinality and “new dimension value” anomalies need histogram/distribution support in core for best results (future).
|
|
33
|
+
- Very wide windows are rejected by `maxBuckets` / `maxGroups` guards.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Insights: LLM cost and tokens
|
|
2
|
+
|
|
3
|
+
All APIs remain **measure-oriented**. Names like `costMicros`, `outputTokens`, or `latencyMs` are conventions chosen by your maps — Countex Insights does not treat “LLM” as a special domain type.
|
|
4
|
+
|
|
5
|
+
## Required measures
|
|
6
|
+
|
|
7
|
+
- **costDrivers / budgetProjection** — Any numeric measure with `.sum` (or `count`).
|
|
8
|
+
- **recommendMaxTokens** — Uses grouped aggregates for the named measure (`outputTokens` by convention). Ideal inputs include `sum`, `count`, `min`, `max`, and derived `avg`.
|
|
9
|
+
|
|
10
|
+
## Cost drivers
|
|
11
|
+
|
|
12
|
+
`costDrivers` ranks contributors by a cost measure and emits generic recommendations when concentration is extreme.
|
|
13
|
+
|
|
14
|
+
## Max tokens
|
|
15
|
+
|
|
16
|
+
Without histograms, percentiles are **approximated** from min/max/avg; confidence is marked **low** or **medium**. When core adds optional histogram storage, recommendations should tighten and confidence can rise.
|
|
17
|
+
|
|
18
|
+
Recommended ceiling (conceptually): `ceil(roundTo, percentile × safetyMultiplier)` — implementation uses aggregate proxies until histogram-backed percentiles exist.
|
|
19
|
+
|
|
20
|
+
## Budget projection
|
|
21
|
+
|
|
22
|
+
Linear extrapolation from the **current window** rate into the **target window** length (bucket-count scaling). Status: `under` | `near` | `over` vs a numeric budget.
|
|
23
|
+
|
|
24
|
+
## Percentiles / distributions
|
|
25
|
+
|
|
26
|
+
Histogram-backed measures are a **core** milestone. Insights degrades gracefully until `measure.pXX` selectors exist on `countex.query()`.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Insights: resource advisor
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
`estimateResourcesFromActuals` projects hot-cache and durable storage needs from **observed cell streams**, using configurable byte constants per cell and per dictionary key.
|
|
6
|
+
|
|
7
|
+
## Requirements
|
|
8
|
+
|
|
9
|
+
Pass the **durable** adapter into `createCountexInsights({ durable })`. The advisor calls `durable.streamCells()` over `sampleWindow`.
|
|
10
|
+
|
|
11
|
+
## Observed metrics
|
|
12
|
+
|
|
13
|
+
- Approximate cells per day (mean and a simple P95 across days seen in the sample).
|
|
14
|
+
- Heuristic dictionary key estimate (defaults to ~10% of streamed cells — tune in code if you allocate differently).
|
|
15
|
+
|
|
16
|
+
## Projections
|
|
17
|
+
|
|
18
|
+
Combines:
|
|
19
|
+
|
|
20
|
+
- **Hot cells** — Based on recent daily churn (P95 × short window).
|
|
21
|
+
- **Durable cells** — Scales daily average by a retention multiplier derived from `targetRetention` (days/weeks/months/quarters/years/all).
|
|
22
|
+
|
|
23
|
+
Outputs Redis/Mongo byte estimates and suggested RAM/disk figures (informational).
|
|
24
|
+
|
|
25
|
+
## Map / cardinality risk
|
|
26
|
+
|
|
27
|
+
See **analyzeMapHealth** on the insights client. Pass `mapsByCounterId` so dimension lists and cardinality policies can be interpreted. High distinct counts per dimension trigger recommendations such as bucketing or removing hazardous paths.
|
|
28
|
+
|
|
29
|
+
## Retention advice
|
|
30
|
+
|
|
31
|
+
When daily cell churn is very high, the resource advisor may emit a generic retention recommendation — tune thresholds for your environment.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Countex feature guides
|
|
2
|
+
|
|
3
|
+
Step-by-step guides for using each major feature of `@x12i/countex`. Each document stands alone.
|
|
4
|
+
|
|
5
|
+
These files are published with the npm package and exposed as stable import subpaths (see root `README.md` and `package.json` `exports`).
|
|
6
|
+
|
|
7
|
+
| Guide | Package subpath |
|
|
8
|
+
|-------|-----------------|
|
|
9
|
+
| [Counter maps](./counter-maps.md) | `@x12i/countex/docs/guides/counter-maps` |
|
|
10
|
+
| [Ingestion and flush](./ingestion-and-flush.md) | `@x12i/countex/docs/guides/ingestion-and-flush` |
|
|
11
|
+
| [Timeframes](./timeframes-and-bucketing.md) | `@x12i/countex/docs/guides/timeframes-and-bucketing` |
|
|
12
|
+
| [Measures](./measures.md) | `@x12i/countex/docs/guides/measures` |
|
|
13
|
+
| [Querying](./querying.md) | `@x12i/countex/docs/guides/querying` |
|
|
14
|
+
| [Memory adapters](./adapter-memory.md) | `@x12i/countex/docs/guides/adapter-memory` |
|
|
15
|
+
| [Mongo durable](./adapter-mongo.md) | `@x12i/countex/docs/guides/adapter-mongo` |
|
|
16
|
+
| [Redis cache](./adapter-redis.md) | `@x12i/countex/docs/guides/adapter-redis` |
|
|
17
|
+
| [Cardinality](./cardinality.md) | `@x12i/countex/docs/guides/cardinality` |
|
|
18
|
+
| [Idempotency](./idempotency.md) | `@x12i/countex/docs/guides/idempotency` |
|
|
19
|
+
| [Backup export](./backup-export.md) | `@x12i/countex/docs/guides/backup-export` |
|
|
20
|
+
| [Client events](./client-events.md) | `@x12i/countex/docs/guides/client-events` |
|
|
21
|
+
| [Insights overview](./insights-overview.md) | `@x12i/countex/docs/guides/insights-overview` |
|
|
22
|
+
| [Insights ranking](./insights-ranking.md) | `@x12i/countex/docs/guides/insights-ranking` |
|
|
23
|
+
| [Insights comparison & trends](./insights-comparison-and-trends.md) | `@x12i/countex/docs/guides/insights-comparison-and-trends` |
|
|
24
|
+
| [Insights anomalies & rules](./insights-anomalies-and-rules.md) | `@x12i/countex/docs/guides/insights-anomalies-and-rules` |
|
|
25
|
+
| [Insights forecasting & budget](./insights-forecasting-and-budget.md) | `@x12i/countex/docs/guides/insights-forecasting-and-budget` |
|
|
26
|
+
| [Insights advisors](./insights-advisors-and-optimization.md) | `@x12i/countex/docs/guides/insights-advisors-and-optimization` |
|
|
27
|
+
| [CLI](./cli.md) | `@x12i/countex/docs/guides/cli` |
|
|
28
|
+
|
|
29
|
+
Additional narrative docs (also under `docs/`): `DEPLOYMENT.md`, `END_TO_END_EXAMPLE.md`, `INSIGHTS*.md`.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Guide: Memory adapters
|
|
2
|
+
|
|
3
|
+
In-process **`MemoryDurable`** and **`MemoryCache`** implement the storage contracts for tests and local development.
|
|
4
|
+
|
|
5
|
+
## Step 1: Import
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import { MemoryDurable, MemoryCache } from "@x12i/countex/adapters/memory";
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Step 2: Construct Countex
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { createCountex } from "@x12i/countex";
|
|
15
|
+
|
|
16
|
+
const countex = createCountex({
|
|
17
|
+
maps: [myMap],
|
|
18
|
+
durable: new MemoryDurable(),
|
|
19
|
+
cache: new MemoryCache(),
|
|
20
|
+
});
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Step 3: Use like production
|
|
24
|
+
|
|
25
|
+
```ts
|
|
26
|
+
await countex.ingest(event);
|
|
27
|
+
await countex.flush();
|
|
28
|
+
const q = await countex.query({ /* ... */ });
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
No network, no peer dependencies.
|
|
32
|
+
|
|
33
|
+
## When to use
|
|
34
|
+
|
|
35
|
+
- Unit tests
|
|
36
|
+
- Demos and notebooks
|
|
37
|
+
- CI without Docker services
|
|
38
|
+
|
|
39
|
+
## Limitations
|
|
40
|
+
|
|
41
|
+
- State dies with the process.
|
|
42
|
+
- Not suitable for multi-process concurrency testing at scale.
|
|
43
|
+
|
|
44
|
+
## See also
|
|
45
|
+
|
|
46
|
+
- [Mongo adapter](./adapter-mongo.md)
|
|
47
|
+
- [Redis adapter](./adapter-redis.md)
|
|
48
|
+
- Internal: [Memory storage](../internals/internal-storage-memory.md)
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Guide: MongoDB durable adapter
|
|
2
|
+
|
|
3
|
+
`MongoDurable` persists cells and the subject/metric dictionary to MongoDB.
|
|
4
|
+
|
|
5
|
+
## Step 1: Install peer dependency
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install mongodb
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Step 2: Create a client (you own lifecycle)
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import { MongoClient } from "mongodb";
|
|
15
|
+
import { MongoDurable } from "@x12i/countex/adapters/mongo";
|
|
16
|
+
import { createCountex } from "@x12i/countex";
|
|
17
|
+
|
|
18
|
+
const mongo = new MongoClient(process.env.MONGO_URI!);
|
|
19
|
+
await mongo.connect();
|
|
20
|
+
|
|
21
|
+
const durable = new MongoDurable({
|
|
22
|
+
client: mongo,
|
|
23
|
+
dbResolver: ({ scope }) => `countex_${scope}`,
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
const countex = createCountex({
|
|
27
|
+
maps: [myMap],
|
|
28
|
+
durable,
|
|
29
|
+
cache: /* optional Redis */,
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
await countex.init();
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Step 3: Collections and indexes
|
|
36
|
+
|
|
37
|
+
On first write the adapter ensures collections such as **`countex_cells`** and **`countex_dict`**, plus indexes for identity and range scans. Per-scope databases isolate tenant data when using `dbResolver`.
|
|
38
|
+
|
|
39
|
+
## Step 4: Flush semantics
|
|
40
|
+
|
|
41
|
+
Flushes call `applyDeltas` with atomic increment operations so parallel writers can safely aggregate.
|
|
42
|
+
|
|
43
|
+
## Step 5: Shutdown
|
|
44
|
+
|
|
45
|
+
Close Countex, then close the Mongo client when your process exits.
|
|
46
|
+
|
|
47
|
+
## See also
|
|
48
|
+
|
|
49
|
+
- [Deployment](../DEPLOYMENT.md)
|
|
50
|
+
- Internal: [Mongo durable](../internals/internal-storage-mongo.md)
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Guide: Redis cache adapter
|
|
2
|
+
|
|
3
|
+
`RedisCache` stores hot counter cells for fast reads. It pairs with a durable store (typically Mongo).
|
|
4
|
+
|
|
5
|
+
## Step 1: Install peer dependency
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install ioredis
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Step 2: Wire client and adapter
|
|
12
|
+
|
|
13
|
+
```ts
|
|
14
|
+
import IORedis from "ioredis";
|
|
15
|
+
import { RedisCache } from "@x12i/countex/adapters/redis";
|
|
16
|
+
|
|
17
|
+
const redis = new IORedis(process.env.REDIS_URL!);
|
|
18
|
+
|
|
19
|
+
const cache = new RedisCache({
|
|
20
|
+
client: redis,
|
|
21
|
+
keyPrefix: "countex",
|
|
22
|
+
ttlSeconds: 92 * 24 * 3600,
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
const countex = createCountex({
|
|
26
|
+
maps: [myMap],
|
|
27
|
+
durable,
|
|
28
|
+
cache,
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
await countex.init();
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Step 3: Idempotency hook
|
|
35
|
+
|
|
36
|
+
When maps declare **idempotency**, the cache adapter can implement **`markEventSeen`** so duplicates are skipped before buffering.
|
|
37
|
+
|
|
38
|
+
## Step 4: Operational expectations
|
|
39
|
+
|
|
40
|
+
- Cache misses fall back to durable reads; results may warm the cache afterward.
|
|
41
|
+
- Cache flush failures during write path are **non-fatal** (durable is source of truth).
|
|
42
|
+
|
|
43
|
+
## See also
|
|
44
|
+
|
|
45
|
+
- [Idempotency](./idempotency.md)
|
|
46
|
+
- [Querying](./querying.md) (cache vs durable for min/max measures)
|
|
47
|
+
- Internal: [Redis cache](../internals/internal-storage-redis.md)
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Guide: Backup export and cache rebuild
|
|
2
|
+
|
|
3
|
+
Helpers **`exportCells`** and **`rebuildCache`** stream data from durable storage and optionally warm a cache.
|
|
4
|
+
|
|
5
|
+
## Step 1: Export cells
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
import { exportCells } from "@x12i/countex";
|
|
9
|
+
|
|
10
|
+
for await (const cell of exportCells(durable, {
|
|
11
|
+
scope: "org_1",
|
|
12
|
+
counterId: "events",
|
|
13
|
+
timeframe: { type: "day", from: "2026-05-01", to: "2026-05-07" },
|
|
14
|
+
})) {
|
|
15
|
+
// serialize, audit, backup...
|
|
16
|
+
}
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Streaming is bounded by the `(scope, counterId, timeframe)` filter you provide.
|
|
20
|
+
|
|
21
|
+
## Step 2: Rebuild cache after outage
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
import { rebuildCache } from "@x12i/countex";
|
|
25
|
+
|
|
26
|
+
const { cellsWarmed } = await rebuildCache(durable, cache, {
|
|
27
|
+
scope: "org_1",
|
|
28
|
+
counterId: "events",
|
|
29
|
+
timeframe: { type: "day", from: "2026-05-01", to: "2026-05-07" },
|
|
30
|
+
}, { batchSize: 1000 });
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Step 3: Cancellation
|
|
34
|
+
|
|
35
|
+
Pass `AbortSignal` where supported (`streamCells` / `warm` options propagate through adapters).
|
|
36
|
+
|
|
37
|
+
## See also
|
|
38
|
+
|
|
39
|
+
- Internal: [Backup streaming](../internals/internal-backup-stream.md)
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Guide: Cardinality protection
|
|
2
|
+
|
|
3
|
+
Cardinality limits stop runaway distinct **subjects**, **metrics**, or **dimension values** from exploding storage when a map accidentally points at high-cardinality fields (URLs, UUIDs everywhere, etc.).
|
|
4
|
+
|
|
5
|
+
## Step 1: Configure engine defaults
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
const countex = createCountex({
|
|
9
|
+
maps: [myMap],
|
|
10
|
+
durable,
|
|
11
|
+
cache,
|
|
12
|
+
cardinality: {
|
|
13
|
+
maxDimensionValuesPerName: 10_000,
|
|
14
|
+
maxSubjectsPerScope: 10_000_000,
|
|
15
|
+
onLimit: "overflow",
|
|
16
|
+
overflowValue: "__OTHER__",
|
|
17
|
+
highCardinalityWarnings: true,
|
|
18
|
+
},
|
|
19
|
+
});
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Step 2: Override per map (optional)
|
|
23
|
+
|
|
24
|
+
Add `cardinality` on a `CounterMap` for stricter rules on sensitive projections.
|
|
25
|
+
|
|
26
|
+
## Step 3: Understand behaviors (`onLimit`)
|
|
27
|
+
|
|
28
|
+
| Mode | Behavior |
|
|
29
|
+
|------|-----------|
|
|
30
|
+
| `overflow` | Rewrite additional distinct keys to `overflowValue` |
|
|
31
|
+
| `drop` | Skip increments that would exceed limits |
|
|
32
|
+
| `error` | Throw (surrounding ingest handles via logging; prefer rare use) |
|
|
33
|
+
|
|
34
|
+
## Step 4: Listen for signals
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
countex.on("cardinality_warning", (w) => { /* nearing limit */ });
|
|
38
|
+
countex.on("overflow", (o) => { /* key rewritten */ });
|
|
39
|
+
countex.on("dropped", (d) => { /* increment skipped */ });
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Practical tips
|
|
43
|
+
|
|
44
|
+
- Prefer bounded dimensions (enums, categories).
|
|
45
|
+
- Use `overflow` in production pipelines so one bad event shape does not halt ingestion.
|
|
46
|
+
|
|
47
|
+
## See also
|
|
48
|
+
|
|
49
|
+
- [Counter maps](./counter-maps.md)
|
|
50
|
+
- Internal: [Cardinality guard](../internals/internal-cardinality.md)
|