# Monitoring

/monitoring is the operational dashboard for Unity app control and company-scoped usage metrics.

Monitor API (Flowise -> PackageReceiver)

Base path: /api/v1/monitor

• GET /status
• POST /start
• POST /kill
• GET /usage

GET /api/v1/monitor/status

Returns aggregated server and app status across configured monitor servers.

{
  "company": "b2-nika",
  "urls": ["http://host.docker.internal:9500"],
  "servers": [
    {
      "serverUrl": "http://host.docker.internal:9500",
      "online": true,
      "status": { "containers": [], "processes": [] },
      "config": { "apps": [] }
    }
  ],
  "apps": [
    {
      "serverUrl": "http://host.docker.internal:9500",
      "appName": "B2 Nika - RS",
      "appType": "RS",
      "pid": 12696,
      "isRunning": true
    }
  ]
}

POST /api/v1/monitor/start and /kill

{
  "appName": "B2 Nika - RS",
  "serverUrl": "http://host.docker.internal:9500"
}

Response mirrors PackageReceiver (success, message, optional error).

Usage API (GET /api/v1/monitor/usage)

Reads Langfuse usage scoped by LANGFUSE_COMPANY_TAG.

Query params:

• days (default 30, max 365)
• fromDate (ISO)
• toDate (ISO)

Includes:

• totals (cost/tokens/traces/observations)
• daily series
• usage by source (realtime, flowise)
• usage by category/model

Required environment variables

Monitor server routing

LYNTARIS_MONITOR_URLS=http://10.0.0.11:9500|KEY1,http://10.0.0.12:9500|KEY2
LYNTARIS_MONITOR_COMPANY=my-company-slug
COMPANY_NAME=my-company-slug
LYNTARIS_MONITOR_API_KEY=optional-default-key

Notes:

• LYNTARIS_MONITOR_URLS supports url|key per server.
• Company filtering uses LYNTARIS_MONITOR_COMPANY first, then COMPANY_NAME.

Usage (Langfuse)

LANGFUSE_PUBLIC_KEY=...
LANGFUSE_SECRET_KEY=...
LANGFUSE_ENDPOINT=https://cloud.langfuse.com
LANGFUSE_COMPANY_TAG=my-company-slug