Configuration Reference

# .langsight.yaml

# MCP servers to monitor — GLOBAL (admin view only)
# These servers are monitored by the embedded health check loop and visible
# to admins when no project is selected in the dashboard.
# Per-project servers are registered via the dashboard UI or PUT /api/servers/metadata/{name}
# and are NOT defined here. See mcp/mcp-servers-dashboard for per-project server management.
servers:
  - name: postgres-mcp             # required — unique identifier
    transport: stdio                # stdio | sse | streamable_http
    command: python                 # stdio only: executable
    args: [server.py]               # stdio only: arguments
    env:                            # stdio only: environment variables
      DB_HOST: localhost
    url: http://localhost:8080/sse  # sse/streamable_http only
    tags: [production, data]        # optional labels
    timeout_seconds: 5              # default: 5
    # Optional: backend liveness probe (v0.8.4)
    # Calls health_tool after tools/list on every check.
    # Failure → DEGRADED (backend down) instead of DOWN (MCP unreachable).
    health_tool: search_entities    # tool name to call as a probe
    health_tool_args:               # arguments passed to the tool
      query: "test"
      count: 1
    # Optional: v0.3 circuit breaker per-server override
    circuit_breaker:
      failure_threshold: 5    # open after N consecutive failures
      cooldown_seconds: 60    # disable for N seconds
      half_open_max_calls: 2  # test with N calls before closing

# Alerting configuration
alerts:
  slack_webhook: https://hooks.slack.com/...   # optional
  error_rate_threshold: 0.05                    # 5%
  latency_spike_multiplier: 3.0                 # 3x baseline
  consecutive_failures: 2                       # before DOWN alert

# Storage backend
# Valid modes: postgres | clickhouse | dual (default: dual)
# SQLite has been removed in v0.2.0 — use docker compose up -d
storage:
  mode: dual   # Postgres (metadata) + ClickHouse (analytics)

  # PostgreSQL — required for mode: postgres or dual
  # postgres_url: postgresql://user:pass@localhost:5432/langsight

  # ClickHouse — required for mode: clickhouse or dual
  clickhouse_url: http://localhost:8123
  clickhouse_database: langsight
  clickhouse_username: langsight
  clickhouse_password: ""

# LLM provider for langsight investigate
investigate:
  provider: anthropic              # anthropic | openai | gemini | ollama
  model: claude-sonnet-4-6        # optional — defaults per provider
  base_url: null                  # optional — for Ollama remotes

# Tool call pricing rules for langsight costs (non-LLM tool calls)
# LLM span costs are calculated from token counts — see Settings → Model Pricing
costs:
  rules:
    - server: openai-mcp
      tool: chat_completion
      cost_per_call: 0.005
    - server: "*"
      tool: "*"
      cost_per_call: 0.001

# PII protection — omit input_args and output_result from all spans
# When enabled, payload panels in the Trace tab are empty
redact_payloads: false

# Embedded monitor (v0.9.0+)
# langsight serve starts a background health check loop by default.
# Set monitor_enabled: false to run the API without a monitor (advanced).
monitor_enabled: true              # default: true
monitor_interval_seconds: 60       # default: 60 — seconds between check cycles

# Check current setting
curl http://localhost:8000/api/settings \
  -H "X-API-Key: ls_your_key"

# Enable global redaction
curl -X PUT http://localhost:8000/api/settings \
  -H "X-API-Key: ls_your_key" \
  -H "Content-Type: application/json" \
  -d '{"redact_payloads": true}'

{
  "redact_payloads": true
}

# Generate
python -c "import secrets; print(secrets.token_hex(32))"

# Set in your environment / docker-compose.yml
LANGSIGHT_METRICS_TOKEN=<generated-value>

# prometheus.yml
scrape_configs:
  - job_name: langsight
    scrape_interval: 15s
    bearer_token: your-secret-scrape-token
    static_configs:
      - targets: ["localhost:8000"]   # or "api:8000" inside Docker Compose
    metrics_path: /metrics