Opentelemetry Integration

.env

@@ -13,6 +13,7 @@ COAP_SIMPLE_PORT_OUT=5683
 COAP_NEGOTIATION_PORT_OUT=5684
 SMART_HOME_SMART_CLOCK_PORT_OUT=5685
 TRAEFIK_DASHBOARD_PORT_OUT=8080
+JAEGER_ENDPOINT=http://host.docker.internal:8085/api/traces
 
 STACK_HOSTNAME="plugfest.thingweb.io"
 BROKER_URI="plugfest.thingweb.io"

README.md

@@ -69,6 +69,20 @@ If you are going to add a completely new Thing:
 2. Add your Thing Model under the previously created directory and name it such as `<your_thing_name>.tm.json`.
 3. Follow the steps above to add your protocol and programming language/framework.
 
+**TypeScript Tracing Integration:**
+Wrap your WoT Thing with auto-tracing to get detailed OpenTelemetry spans for validation, processing, and database operations:
+
+```typescript
+import { createAutoTracedThing, TracedBusinessLogic } from "../../util/dist/auto-tracing";
+const tracedThing = createAutoTracedThing(thing);
+
+// Enhanced tracing with injected logic
+tracedThing.setPropertyReadHandler("prop", "operation", async (logic: TracedBusinessLogic, options) => {
+    await logic.withValidation("type", data, async () => {});
+    return await logic.withDatabase("select", "table", async () => {});
+});
+```
+
 ## Current Devices
 
 The table below contains the public base URIs of the Things used for protocol testing.
@@ -178,3 +192,9 @@ docker buildx build \
 For running the things separately, using their `Dockerfile`'s, `docker build -t <image-tag> -f ./Dockerfile ../../` command must be used to give the context to be able to copy `tm.json` into the container.
 
 For Node.js-based devices, we use npm workspaces and running `npm install` at the root directory installs all the packages needed for every device. After packages are installed, running `node main.js` would run the thing. For port configuration, running either `node main.js -p 1000` or `node main.js --port 1000` would start the thing on port 1000.
+
+## Tracing
+
+Distributed tracing is enabled using OpenTelemetry and Jaeger. To view all traces and logs, open [http://localhost:8084](http://localhost:8084) in your browser (Jaeger UI). Traces are sent to the Jaeger collector on port 8085.
+
+Enhanced auto-tracing automatically injects `TracedBusinessLogic` for detailed span creation without redundancy. Function signatures determine tracing mode.

docker-compose-things-local.yml

@@ -101,14 +101,15 @@ services:
             - things_network
     http-advanced-coffee-machine:
         build:
-            context: ./things/advanced-coffee-machine
-            dockerfile: ./http/ts/Dockerfile
+            context: .
+            dockerfile: ./things/advanced-coffee-machine/http/ts/Dockerfile
         labels:
             - traefik.http.routers.http-advanced-coffee-machine.rule=PathPrefix(`/http-advanced-coffee-machine`)
             - traefik.http.services.http-advanced-coffee-machine.loadbalancer.server.port=${WEB_PORT_OUT}
         environment:
             - HOSTNAME=${STACK_HOSTNAME}
             - PORT=${WEB_PORT_OUT}
+            - JAEGER_ENDPOINT=${JAEGER_ENDPOINT}
         networks:
             - things_network
     http-data-schema-thing:
@@ -128,7 +129,7 @@ services:
     counter-thing:
         build:
             context: ./things/counter-thing
-            dockerfile: Dockerfile
+            dockerfile: ./http/ts/Dockerfile
         labels:
             - traefik.http.routers.counter-thing.rule=PathPrefix(`/counter-thing`)
             - traefik.http.services.counter-thing.loadbalancer.server.port=${WEB_PORT_OUT}

docker-compose-things.yml

@@ -149,6 +149,7 @@ services:
         environment:
             - HOSTNAME=${STACK_HOSTNAME}
             - PORT=${WEB_PORT_OUT}
+            - JAEGER_ENDPOINT=${JAEGER_ENDPOINT}
         deploy:
             resources:
                 limits: