@twin.org/telemetry-service 0.0.3-next.1 → 0.0.3-next.10

package/docs/reference/classes/MetricsCollectorService.md

@@ -0,0 +1,98 @@
+# Class: MetricsCollectorService
+
+Collects metrics from registered producers at a fixed interval.
+
+## Implements
+
+- `IMetricsCollectorComponent`
+
+## Constructors
+
+### Constructor
+
+> **new MetricsCollectorService**(`options?`): `MetricsCollectorService`
+
+Create a new instance of MetricsCollectorService.
+
+#### Parameters
+
+##### options?
+
+[`IMetricsCollectorServiceConstructorOptions`](../interfaces/IMetricsCollectorServiceConstructorOptions.md)
+
+The options for the service.
+
+#### Returns
+
+`MetricsCollectorService`
+
+## Properties
+
+### CLASS\_NAME {#class_name}
+
+> `readonly` `static` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+## Methods
+
+### className() {#classname}
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
+#### Implementation of
+
+`IMetricsCollectorComponent.className`
+
+***
+
+### start() {#start}
+
+> **start**(): `Promise`\<`void`\>
+
+Start the service: register all producers and begin the polling cycle.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IMetricsCollectorComponent.start`
+
+***
+
+### stop() {#stop}
+
+> **stop**(): `Promise`\<`void`\>
+
+Stop the service and cancel the pending timer.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Implementation of
+
+`IMetricsCollectorComponent.stop`
+
+***
+
+### tick() {#tick}
+
+> **tick**(): `Promise`\<`void`\>
+
+One collection cycle across all registered producers.
+Public so tests can drive it deterministically.
+
+#### Returns
+
+`Promise`\<`void`\>

package/docs/reference/classes/TelemetryService.md

@@ -28,7 +28,7 @@ The options for the connector.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -36,7 +36,7 @@ Runtime name for the class.
 
 ## Methods
 
-### className()
+### className() {#classname}
 
 > **className**(): `string`
 
@@ -54,7 +54,7 @@ The class name of the component.
 
 ***
 
-### createMetric()
+### createMetric() {#createmetric}
 
 > **createMetric**(`metric`): `Promise`\<`void`\>
 
@@ -80,7 +80,7 @@ Nothing.
 
 ***
 
-### getMetric()
+### getMetric() {#getmetric}
 
 > **getMetric**(`id`): `Promise`\<\{ `metric`: `ITelemetryMetric`; `value`: `ITelemetryMetricValue`; \}\>
 
@@ -106,7 +106,7 @@ The metric details and it's most recent value.
 
 ***
 
-### updateMetric()
+### updateMetric() {#updatemetric}
 
 > **updateMetric**(`metric`): `Promise`\<`void`\>
 
@@ -132,7 +132,7 @@ Nothing.
 
 ***
 
-### addMetricValue()
+### addMetricValue() {#addmetricvalue}
 
 > **addMetricValue**(`id`, `value`, `customData?`): `Promise`\<`string`\>
 
@@ -148,9 +148,9 @@ The id of the metric.
 
 ##### value
 
-The value for the add operation.
+`number` \| `MetricCounterOperation`
 
-`number` | `"inc"` | `"dec"`
+The value for the add operation.
 
 ##### customData?
 
@@ -168,7 +168,7 @@ The created metric value id.
 
 ***
 
-### removeMetric()
+### removeMetric() {#removemetric}
 
 > **removeMetric**(`id`): `Promise`\<`void`\>
 
@@ -194,7 +194,7 @@ Nothing.
 
 ***
 
-### query()
+### query() {#query}
 
 > **query**(`type?`, `cursor?`, `limit?`): `Promise`\<\{ `entities`: `ITelemetryMetric`[]; `cursor?`: `string`; \}\>
 
@@ -237,7 +237,7 @@ NotImplementedError if the implementation does not support retrieval.
 
 ***
 
-### queryValues()
+### queryValues() {#queryvalues}
 
 > **queryValues**(`id`, `timeStart?`, `timeEnd?`, `cursor?`, `limit?`): `Promise`\<\{ `metric`: `ITelemetryMetric`; `entities`: `ITelemetryMetricValue`[]; `cursor?`: `string`; \}\>
 

package/docs/reference/index.md

@@ -2,10 +2,13 @@
 
 ## Classes
 
+- [MetricsCollectorService](classes/MetricsCollectorService.md)
 - [TelemetryService](classes/TelemetryService.md)
 
 ## Interfaces
 
+- [IMetricsCollectorServiceConfig](interfaces/IMetricsCollectorServiceConfig.md)
+- [IMetricsCollectorServiceConstructorOptions](interfaces/IMetricsCollectorServiceConstructorOptions.md)
 - [ITelemetryServiceConstructorOptions](interfaces/ITelemetryServiceConstructorOptions.md)
 
 ## Variables

package/docs/reference/interfaces/IMetricsCollectorServiceConfig.md

@@ -0,0 +1,17 @@
+# Interface: IMetricsCollectorServiceConfig
+
+The options for the metrics collector service config.
+
+## Properties
+
+### intervalMs? {#intervalms}
+
+> `optional` **intervalMs?**: `number`
+
+Polling interval in milliseconds.
+
+#### Default
+
+```ts
+60000
+```

package/docs/reference/interfaces/IMetricsCollectorServiceConstructorOptions.md

@@ -0,0 +1,25 @@
+# Interface: IMetricsCollectorServiceConstructorOptions
+
+The options for the metrics collector service constructor.
+
+## Properties
+
+### loggingComponentType? {#loggingcomponenttype}
+
+> `optional` **loggingComponentType?**: `string`
+
+The type of the logging component to use.
+
+#### Default
+
+```ts
+logging
+```
+
+***
+
+### config? {#config}
+
+> `optional` **config?**: [`IMetricsCollectorServiceConfig`](IMetricsCollectorServiceConfig.md)
+
+The configuration options for the metrics collector service.

package/docs/reference/interfaces/ITelemetryServiceConstructorOptions.md

@@ -4,9 +4,9 @@ The options for the telemetry service constructor.
 
 ## Properties
 
-### telemetryConnectorType?
+### telemetryConnectorType? {#telemetryconnectortype}
 
-> `optional` **telemetryConnectorType**: `string`
+> `optional` **telemetryConnectorType?**: `string`
 
 The type of the telemetry connector to use.
 

package/locales/en.json

@@ -1 +1,7 @@
-{}
+{
+	"error": {
+		"metricsCollectorService": {
+			"producerCollectionFailed": "Failed to collect metrics from producer \"{producer}\""
+		}
+	}
+}

package/package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@twin.org/telemetry-service",
-	"version": "0.0.3-next.1",
-	"description": "Telemetry contract implementation and REST endpoint definitions",
+	"version": "0.0.3-next.10",
+	"description": "Telemetry service implementation with REST entry points.",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/twinfoundation/telemetry.git",
+		"url": "git+https://github.com/iotaledger/telemetry.git",
 		"directory": "packages/telemetry-service"
 	},
 	"author": "martyn.janes@iota.org",
@@ -17,8 +17,9 @@
 		"@twin.org/api-models": "next",
 		"@twin.org/core": "next",
 		"@twin.org/entity": "next",
+		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next",
-		"@twin.org/telemetry-models": "0.0.3-next.1",
+		"@twin.org/telemetry-models": "0.0.3-next.10",
 		"@twin.org/web": "next"
 	},
 	"main": "./dist/es/index.js",
@@ -49,7 +50,7 @@
 		"business-logic"
 	],
 	"bugs": {
-		"url": "git+https://github.com/twinfoundation/telemetry/issues"
+		"url": "git+https://github.com/iotaledger/telemetry/issues"
 	},
 	"homepage": "https://twindev.org"
 }