📈 Langfuse Integration

UI: https://langfuse.loca.zone (User: loca, Service: omp-loca, v16.x)

🧠 Core

• Traces: 1 per prompt. View via Sessions -> Select Session -> chat-turn.
• Orphans: Ignore separate subagent IDs.
• Config Path: ~/.omp/agent/settings.json

🗺️ Stack Flow

Terminal -> pi-telemetry.js (Active, trace: chat-turn) -> settings.json -> Langfuse

• pi-langfuse: Inactive (trace: pi-agent)
• omp_otel: Inactive (trace: invoke_agent/chat)
• omp-stats: Optional (Dashboard: https://stats.loca.zone)

⚙️ Config

~/.omp/agent/settings.json (Reloads instantly without restart):

{
  "pi-telemetry": {
    "serviceName": "omp-loca",
    "includePayloads": true,
    "langfuse": {
      "enabled": true,
      "publicKey": "pk-lf-...",
      "secretKey": "sk-lf-...",
      "baseUrl": "https://langfuse.loca.zone"
    }
  }
}

🔧 Install

• v16 Issue: Plugin install broken.
• Workaround: Run ~/.omp/agent/install-pi-telemetry.sh

🧪 Health

• Verify Traces:

  export LF_PUB=$(jq -r '.["pi-telemetry"].langfuse.publicKey' ~/.omp/agent/settings.json)
  export LF_SEC=$(jq -r '.["pi-telemetry"].langfuse.secretKey' ~/.omp/agent/settings.json)
  export LF_URL="https://langfuse.loca.zone"
  curl -s -u "$LF_PUB:$LF_SEC" "$LF_URL/api/public/traces?limit=5" | jq '.data[] | "\(.timestamp[:19]) | \(.name) | \(.sessionId[:12])"'

• Check Errors:

  grep -i 'Failed to load extension\|telemetry' ~/.omp/logs/omp.$(date +F).log

🚀 Upgrades

• Native OTel (~/.omp/agent/.env):

  OTEL_EXPORTER_OTLP_ENDPOINT=https://langfuse.loca.zone/api/public/otel
  OTEL_SERVICE_NAME=omp-loca

• Local Stats:

  omp plugin install @oh-my-pi/omp-stats && omp stats

🚫 Traps

• Flat Spam: Use Sessions tab.
• Orphan IDs: Ignore subagent noise.
• Missing Input: Ensure "includePayloads": true.
• EACCES Error: Run OMP from ~.
• Plugin Failure: Run install-pi-telemetry.sh.

---