@dxos/tracing 0.1.56-next.a63ce79 → 0.1.56

package/dist/types/src/metrics/index.d.ts

@@ -0,0 +1,5 @@
+export * from './base';
+export * from './unary-counter';
+export * from './time-series-counter';
+export * from './time-usage-counter';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/metrics/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/types/src/metrics/time-series-counter.d.ts

@@ -0,0 +1,15 @@
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+import { BaseCounter } from './base';
+export declare class TimeSeriesCounter extends BaseCounter {
+    private _currentValue;
+    private _totalValue;
+    private _buckets;
+    units?: string;
+    constructor({ units }?: {
+        units?: string;
+    });
+    inc(by?: number): void;
+    _tick(time: number): void;
+    getData(): Metric;
+}
+//# sourceMappingURL=time-series-counter.d.ts.map

package/dist/types/src/metrics/time-series-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-series-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-series-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9C,GAAG,CAAC,EAAE,SAAI;IAKD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB,OAAO,IAAI,MAAM;CAiB3B"}

package/dist/types/src/metrics/time-usage-counter.d.ts

@@ -0,0 +1,15 @@
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+import { BaseCounter } from './base';
+export declare class TimeUsageCounter extends BaseCounter {
+    private _currentValue;
+    private _totalValue;
+    private _buckets;
+    private _lastTickTime;
+    record(time: number): void;
+    beginRecording(): {
+        end: () => void;
+    };
+    _tick(time: number): void;
+    getData(): Metric;
+}
+//# sourceMappingURL=time-usage-counter.d.ts.map

package/dist/types/src/metrics/time-usage-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-usage-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/time-usage-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAIrC,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAgB;IAEhC,OAAO,CAAC,aAAa,CAAqB;IAE1C,MAAM,CAAC,IAAI,EAAE,MAAM;IAKnB,cAAc,IAAI;QAAE,GAAG,EAAE,MAAM,IAAI,CAAA;KAAE;IAU5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYzB,OAAO,IAAI,MAAM;CAiB3B"}

package/dist/types/src/metrics/unary-counter.d.ts

@@ -0,0 +1,12 @@
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+import { BaseCounter } from './base';
+export declare class UnaryCounter extends BaseCounter {
+    value: number;
+    units?: string;
+    constructor({ units }?: {
+        units?: string;
+    });
+    inc(by?: number): void;
+    getData(): Metric;
+}
+//# sourceMappingURL=unary-counter.d.ts.map

package/dist/types/src/metrics/unary-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unary-counter.d.ts","sourceRoot":"","sources":["../../../../src/metrics/unary-counter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,YAAa,SAAQ,WAAW;IAC3C,KAAK,SAAK;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,EAAE,KAAK,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAK9C,GAAG,CAAC,EAAE,SAAI;IAIV,OAAO,IAAI,MAAM;CASlB"}

package/dist/types/src/symbols.d.ts

@@ -1,6 +1,7 @@
 export declare const symbolTracingContext: unique symbol;
 export type TracingContext = {
     infoProperties: Record<string, {}>;
+    metricsProperties: Record<string, {}>;
 };
 export declare const getTracingContext: (target: any) => TracingContext;
 export declare const TRACE_SPAN_ATTRIBUTE = "dxos.trace-span";

package/dist/types/src/symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/symbols.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,GAAG,KAAG,cAI/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/symbols.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,GAAG,KAAG,cAK/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC"}

package/dist/types/src/trace-processor.d.ts

@@ -1,6 +1,7 @@
 import { Context } from '@dxos/context';
+import { LogEntry } from '@dxos/protocols/proto/dxos/client/services';
 import { Error as SerializedError } from '@dxos/protocols/proto/dxos/error';
-import { Resource, Span } from '@dxos/protocols/proto/dxos/tracing';
+import { Metric, Resource, Span } from '@dxos/protocols/proto/dxos/tracing';
 import type { AddLinkOptions } from './api';
 import { TraceSender } from './trace-sender';
 export type TraceResourceConstructorParams = {
@@ -19,8 +20,10 @@ export type ResourceEntry = {
     instance: WeakRef<any>;
 };
 export type TraceSubscription = {
+    flush: () => void;
     dirtyResources: Set<number>;
     dirtySpans: Set<number>;
+    newLogs: LogEntry[];
 };
 export declare class TraceProcessor {
     resources: Map<number, ResourceEntry>;
@@ -28,17 +31,23 @@ export declare class TraceProcessor {
     resourceIdList: number[];
     spans: Map<number, Span>;
     spanIdList: number[];
+    logs: LogEntry[];
     subscriptions: Set<TraceSubscription>;
+    constructor();
     traceResourceConstructor(params: TraceResourceConstructorParams): void;
     getResourceInfo(instance: any): Record<string, any>;
+    getResourceMetrics(instance: any): Metric[];
     traceSpan(params: TraceSpanParams): TracingSpan;
     addLink(parent: any, child: any, opts: AddLinkOptions): void;
     getResourceId(instance: any): number | null;
     createTraceSender(): TraceSender;
+    refresh(): void;
     private _markResourceDirty;
     private _markSpanDirty;
     private _clearResources;
     private _clearSpans;
+    private _pushLog;
+    private _logProcessor;
 }
 export declare class TracingSpan {
     private _traceProcessor;

package/dist/types/src/trace-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-processor.d.ts","sourceRoot":"","sources":["../../../src/trace-processor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB,CAAC;AAKF,qBAAa,cAAc;IACzB,SAAS,6BAAoC;IAC7C,qBAAqB,8BAAqC;IAC1D,cAAc,EAAE,MAAM,EAAE,CAAM;IAE9B,KAAK,oBAA2B;IAChC,UAAU,EAAE,MAAM,EAAE,CAAM;IAE1B,aAAa,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAa;IAElD,wBAAwB,CAAC,MAAM,EAAE,8BAA8B;IAqB/D,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAenD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW;IAM/C,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc;IAErD,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAK3C,iBAAiB;IAiBjB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,WAAW;CAMpB;AAED,qBAAa,WAAW;IAaV,OAAO,CAAC,eAAe;IAZnC,MAAM,CAAC,MAAM,SAAK;IAElB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEzB,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe;IAmB5E,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,CAExB;IAED,WAAW;IAKX,SAAS,CAAC,GAAG,EAAE,OAAO;IAMtB,SAAS,IAAI,IAAI;CAWlB;AAeD,eAAO,MAAM,eAAe,EAAE,cAA+E,CAAC"}
+{"version":3,"file":"trace-processor.d.ts","sourceRoot":"","sources":["../../../src/trace-processor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,4CAA4C,CAAC;AACtE,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB,CAAC;AAQF,qBAAa,cAAc;IACzB,SAAS,6BAAoC;IAC7C,qBAAqB,8BAAqC;IAC1D,cAAc,EAAE,MAAM,EAAE,CAAM;IAE9B,KAAK,oBAA2B;IAChC,UAAU,EAAE,MAAM,EAAE,CAAM;IAE1B,IAAI,EAAE,QAAQ,EAAE,CAAM;IAEtB,aAAa,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAa;;IASlD,wBAAwB,CAAC,MAAM,EAAE,8BAA8B;IA6B/D,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAenD,kBAAkB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,EAAE;IAW3C,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW;IAM/C,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc;IAErD,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAK3C,iBAAiB;IAIjB,OAAO;IA+CP,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,aAAa,CAiCnB;CACH;AAED,qBAAa,WAAW;IAaV,OAAO,CAAC,eAAe;IAZnC,MAAM,CAAC,MAAM,SAAK;IAElB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEzB,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe;IAmB5E,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,CAExB;IAED,WAAW;IAKX,SAAS,CAAC,GAAG,EAAE,OAAO;IAMtB,SAAS,IAAI,IAAI;CAWlB;AAeD,eAAO,MAAM,eAAe,EAAE,cAA+E,CAAC"}

package/dist/types/src/trace-sender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-sender.d.ts","sourceRoot":"","sources":["../../../src/trace-sender.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAItE,qBAAa,WAAY,YAAW,cAAc;IACpC,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,cAAc;IAEnD,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC;CA+DrD"}
+{"version":3,"file":"trace-sender.d.ts","sourceRoot":"","sources":["../../../src/trace-sender.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAEtE,qBAAa,WAAY,YAAW,cAAc;IACpC,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,cAAc;IAEnD,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC;CA0ErD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/tracing",
-  "version": "0.1.56-next.a63ce79",
+  "version": "0.1.56",
   "description": "Async utilities.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -16,14 +16,15 @@
     "src"
   ],
   "dependencies": {
-    "@dxos/codec-protobuf": "0.1.56-next.a63ce79",
-    "@dxos/context": "0.1.56-next.a63ce79",
-    "@dxos/debug": "0.1.56-next.a63ce79",
-    "@dxos/invariant": "0.1.56-next.a63ce79",
-    "@dxos/log": "0.1.56-next.a63ce79",
-    "@dxos/node-std": "0.1.56-next.a63ce79",
-    "@dxos/protocols": "0.1.56-next.a63ce79",
-    "@dxos/util": "0.1.56-next.a63ce79"
+    "@dxos/async": "0.1.56",
+    "@dxos/codec-protobuf": "0.1.56",
+    "@dxos/context": "0.1.56",
+    "@dxos/debug": "0.1.56",
+    "@dxos/invariant": "0.1.56",
+    "@dxos/log": "0.1.56",
+    "@dxos/node-std": "0.1.56",
+    "@dxos/protocols": "0.1.56",
+    "@dxos/util": "0.1.56"
   },
   "devDependencies": {},
   "publishConfig": {

package/src/api.ts

@@ -7,6 +7,9 @@ import { Context } from '@dxos/context';
 import { getTracingContext } from './symbols';
 import { TRACE_PROCESSOR } from './trace-processor';
 
+/**
+ * Annotates a class as a tracked resource.
+ */
 const resource =
   () =>
   <T extends { new (...args: any[]): {} }>(constructor: T) => {
@@ -20,6 +23,9 @@ const resource =
     return klass;
   };
 
+/**
+ * Marks a property or a method to be included in the resource info section.
+ */
 const info = () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => {
   getTracingContext(target).infoProperties[propertyKey] = {};
 };
@@ -43,6 +49,13 @@ const span = () => (target: any, propertyKey: string, descriptor: TypedPropertyD
   };
 };
 
+/**
+ * Attaches metrics counter to the resource.
+ */
+const metricsCounter = () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => {
+  getTracingContext(target).metricsProperties[propertyKey] = {};
+};
+
 export type AddLinkOptions = {};
 
 const addLink = (parent: any, child: any, opts: AddLinkOptions = {}) => {
@@ -53,6 +66,7 @@ export const trace = {
   resource,
   info,
   span,
+  metricsCounter,
 
   addLink,
 };

package/src/index.ts

@@ -6,3 +6,4 @@ export * from './api';
 export * from './symbols';
 export * from './trace-processor';
 export * from './trace-sender';
+export * from './metrics';

package/src/metrics/base.ts

@@ -0,0 +1,26 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+
+export abstract class BaseCounter {
+  /**
+   * @internal
+   */
+  _instance: any;
+
+  name?: string;
+
+  /**
+   * @internal
+   */
+  _assign(instance: any, name: string) {
+    this._instance = instance;
+    this.name = name;
+  }
+
+  abstract getData(): Metric;
+
+  _tick(time: number): void {}
+}

package/src/metrics/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './base';
+export * from './unary-counter';
+export * from './time-series-counter';
+export * from './time-usage-counter';

package/src/metrics/time-series-counter.ts

@@ -0,0 +1,52 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+
+import { BaseCounter } from './base';
+
+const MAX_BUCKETS = 60;
+
+export class TimeSeriesCounter extends BaseCounter {
+  private _currentValue = 0;
+  private _totalValue = 0;
+  private _buckets: number[] = [];
+  units?: string;
+
+  constructor({ units }: { units?: string } = {}) {
+    super();
+    this.units = units;
+  }
+
+  inc(by = 1) {
+    this._currentValue += by;
+    this._totalValue += by;
+  }
+
+  override _tick(time: number): void {
+    this._buckets.push(this._currentValue);
+    if (this._buckets.length > MAX_BUCKETS) {
+      this._buckets.shift();
+    }
+    this._currentValue = 0;
+  }
+
+  override getData(): Metric {
+    return {
+      name: this.name!,
+      timeSeries: {
+        tracks: [
+          {
+            name: this.name!,
+            units: this.units,
+            points: this._buckets.map((value, index) => ({
+              value,
+            })),
+            total: this._totalValue,
+          },
+        ],
+      },
+    };
+  }
+}

package/src/metrics/time-usage-counter.ts

@@ -0,0 +1,62 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+
+import { BaseCounter } from './base';
+
+const MAX_BUCKETS = 60;
+
+export class TimeUsageCounter extends BaseCounter {
+  private _currentValue = 0;
+  private _totalValue = 0;
+  private _buckets: number[] = [];
+
+  private _lastTickTime = performance.now();
+
+  record(time: number) {
+    this._currentValue += time;
+    this._totalValue += time;
+  }
+
+  beginRecording(): { end: () => void } {
+    const start = performance.now();
+    return {
+      end: () => {
+        const end = performance.now();
+        this.record(end - start);
+      },
+    };
+  }
+
+  override _tick(time: number): void {
+    const delta = time - this._lastTickTime;
+    this._lastTickTime = time;
+
+    const percentage = (this._currentValue / delta) * 100;
+    this._buckets.push(percentage);
+    if (this._buckets.length > MAX_BUCKETS) {
+      this._buckets.shift();
+    }
+    this._currentValue = 0;
+  }
+
+  override getData(): Metric {
+    return {
+      name: this.name!,
+      timeSeries: {
+        tracks: [
+          {
+            name: this.name!,
+            units: '%',
+            points: this._buckets.map((value, index) => ({
+              value,
+            })),
+            total: this._totalValue,
+          },
+        ],
+      },
+    };
+  }
+}

package/src/metrics/unary-counter.ts

@@ -0,0 +1,31 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Metric } from '@dxos/protocols/proto/dxos/tracing';
+
+import { BaseCounter } from './base';
+
+export class UnaryCounter extends BaseCounter {
+  value = 0;
+  units?: string;
+
+  constructor({ units }: { units?: string } = {}) {
+    super();
+    this.units = units;
+  }
+
+  inc(by = 1) {
+    this.value += by;
+  }
+
+  getData(): Metric {
+    return {
+      name: this.name!,
+      counter: {
+        value: this.value,
+        units: this.units,
+      },
+    };
+  }
+}

package/src/symbols.ts

@@ -2,15 +2,17 @@
 // Copyright 2023 DXOS.org
 //
 
-export const symbolTracingContext = Symbol('dxos.tracing-context');
+export const symbolTracingContext = Symbol('dxos.tracing.context');
 
 export type TracingContext = {
   infoProperties: Record<string, {}>;
+  metricsProperties: Record<string, {}>;
 };
 
 export const getTracingContext = (target: any): TracingContext => {
-  return (target[symbolTracingContext] ??= {
+  return ((target[symbolTracingContext] as TracingContext | undefined) ??= {
     infoProperties: {},
+    metricsProperties: {},
   });
 };
 

package/src/trace-processor.ts

@@ -2,12 +2,16 @@
 // Copyright 2023 DXOS.org
 //
 
+import { unrefTimeout } from '@dxos/async';
 import { Context } from '@dxos/context';
+import { LogLevel, LogProcessor, getContextFromEntry, log } from '@dxos/log';
+import { LogEntry } from '@dxos/protocols/proto/dxos/client/services';
 import { Error as SerializedError } from '@dxos/protocols/proto/dxos/error';
-import { Resource, Span } from '@dxos/protocols/proto/dxos/tracing';
+import { Metric, Resource, Span } from '@dxos/protocols/proto/dxos/tracing';
 import { getPrototypeSpecificInstanceId } from '@dxos/util';
 
 import type { AddLinkOptions } from './api';
+import { BaseCounter } from './metrics';
 import { TRACE_SPAN_ATTRIBUTE, getTracingContext } from './symbols';
 import { TraceSender } from './trace-sender';
 
@@ -28,12 +32,18 @@ export type ResourceEntry = {
 };
 
 export type TraceSubscription = {
+  flush: () => void;
+
   dirtyResources: Set<number>;
   dirtySpans: Set<number>;
+  newLogs: LogEntry[];
 };
 
 const MAX_RESOURCE_RECORDS = 500;
 const MAX_SPAN_RECORDS = 1_000;
+const MAX_LOG_RECORDS = 1_000;
+
+const REFRESH_INTERVAL = 1_000;
 
 export class TraceProcessor {
   resources = new Map<number, ResourceEntry>();
@@ -43,10 +53,26 @@ export class TraceProcessor {
   spans = new Map<number, Span>();
   spanIdList: number[] = [];
 
+  logs: LogEntry[] = [];
+
   subscriptions: Set<TraceSubscription> = new Set();
 
+  constructor() {
+    log.addProcessor(this._logProcessor.bind(this));
+
+    const refreshInterval = setInterval(this.refresh.bind(this), REFRESH_INTERVAL);
+    unrefTimeout(refreshInterval);
+  }
+
   traceResourceConstructor(params: TraceResourceConstructorParams) {
     const id = this.resources.size;
+
+    // init metrics counters.
+    const tracingContext = getTracingContext(Object.getPrototypeOf(params.instance));
+    for (const key of Object.keys(tracingContext.metricsProperties)) {
+      (params.instance[key] as BaseCounter)._assign(params.instance, key);
+    }
+
     const entry: ResourceEntry = {
       data: {
         id,
@@ -54,6 +80,7 @@ export class TraceProcessor {
         instanceId: getPrototypeSpecificInstanceId(params.instance),
         info: this.getResourceInfo(params.instance),
         links: [],
+        metrics: this.getResourceMetrics(params.instance),
       },
       instance: new WeakRef(params.instance),
     };
@@ -72,7 +99,7 @@ export class TraceProcessor {
 
     for (const [key, _opts] of Object.entries(tracingContext.infoProperties)) {
       try {
-        res[key] = typeof instance[key] === 'function' ? instance[key]() : instance[key];
+        res[key] = sanitizeValue(typeof instance[key] === 'function' ? instance[key]() : instance[key]);
       } catch (err: any) {
         res[key] = err.message;
       }
@@ -81,6 +108,17 @@ export class TraceProcessor {
     return res;
   }
 
+  getResourceMetrics(instance: any): Metric[] {
+    const res: Metric[] = [];
+    const tracingContext = getTracingContext(Object.getPrototypeOf(instance));
+
+    for (const [key, _opts] of Object.entries(tracingContext.metricsProperties)) {
+      res.push(instance[key].getData());
+    }
+
+    return res;
+  }
+
   traceSpan(params: TraceSpanParams): TracingSpan {
     const span = new TracingSpan(this, params);
     this._flushSpan(span);
@@ -98,6 +136,40 @@ export class TraceProcessor {
     return new TraceSender(this);
   }
 
+  refresh() {
+    for (const resource of this.resources.values()) {
+      const instance = resource.instance.deref();
+      if (!instance) {
+        continue;
+      }
+
+      const tracingContext = getTracingContext(Object.getPrototypeOf(instance));
+      const time = performance.now();
+      for (const key of Object.keys(tracingContext.metricsProperties)) {
+        (instance[key] as BaseCounter)._tick?.(time);
+      }
+
+      let _changed = false;
+
+      const oldInfo = resource.data.info;
+      resource.data.info = this.getResourceInfo(instance);
+      _changed ||= !areEqualShallow(oldInfo, resource.data.info);
+
+      const oldMetrics = resource.data.metrics;
+      resource.data.metrics = this.getResourceMetrics(instance);
+      _changed ||= !areEqualShallow(oldMetrics, resource.data.metrics);
+
+      // TODO(dmaretskyi): Test if works and enable.
+      // if (changed) {
+      this._markResourceDirty(resource.data.id);
+      // }
+    }
+
+    for (const subscription of this.subscriptions) {
+      subscription.flush();
+    }
+  }
+
   /**
    * @internal
    */
@@ -137,6 +209,52 @@ export class TraceProcessor {
       this.spans.delete(id);
     }
   }
+
+  private _pushLog(log: LogEntry) {
+    this.logs.push(log);
+    if (this.logs.length > MAX_LOG_RECORDS) {
+      this.logs.shift();
+    }
+
+    for (const subscription of this.subscriptions) {
+      subscription.newLogs.push(log);
+    }
+  }
+
+  private _logProcessor: LogProcessor = (config, entry) => {
+    switch (entry.level) {
+      case LogLevel.ERROR:
+      case LogLevel.WARN:
+      case LogLevel.TRACE: {
+        const scope = entry.meta?.S;
+        const resource = this.resourceInstanceIndex.get(scope);
+        if (!resource) {
+          return;
+        }
+
+        const context = getContextFromEntry(entry) ?? {};
+
+        for (const key of Object.keys(context)) {
+          context[key] = sanitizeValue(context[key]);
+        }
+
+        const entryToPush: LogEntry = {
+          level: entry.level,
+          message: entry.message,
+          context,
+          timestamp: new Date(),
+          meta: {
+            file: entry.meta?.F ?? '',
+            line: entry.meta?.L ?? 0,
+            resourceId: resource.data.id,
+          },
+        };
+        this._pushLog(entryToPush);
+        break;
+      }
+      default:
+    }
+  };
 }
 
 export class TracingSpan {
@@ -213,3 +331,41 @@ const serializeError = (err: unknown): SerializedError => {
 };
 
 export const TRACE_PROCESSOR: TraceProcessor = ((globalThis as any).TRACE_PROCESSOR ??= new TraceProcessor());
+
+const sanitizeValue = (value: any) => {
+  switch (typeof value) {
+    case 'string':
+    case 'number':
+    case 'boolean':
+    case 'undefined':
+      return value;
+      break;
+    case 'object':
+    case 'function':
+      if (value === null) {
+        return value;
+        break;
+      }
+
+      // TODO(dmaretskyi): Expose trait.
+      if (typeof value.truncate === 'function') {
+        return value.truncate();
+      }
+
+      return value.toString();
+  }
+};
+
+const areEqualShallow = (a: any, b: any) => {
+  for (const key in a) {
+    if (!(key in b) || a[key] !== b[key]) {
+      return false;
+    }
+  }
+  for (const key in b) {
+    if (!(key in a) || a[key] !== b[key]) {
+      return false;
+    }
+  }
+  return true;
+};