Beever Atlas v0.1 has launched! Star us on GitHub
Beever AtlasBeever Atlas

Stats API

Overview

Access system statistics, metrics, and health information.

GET /api/stats

Get overall system statistics.

Response

{
  "total_facts": 856,
  "total_entities": 45,
  "total_channels": 15,
  "total_decisions": 23,
  "wiki_pages": 12,
  "total_messages": 15234,
  "total_authors": 18
}

Fields

Prop

Type

GET /api/stats/health

Get system health status.

Response

{
  "status": "healthy",
  "components": {
    "weaviate": {
      "status": "up",
      "latency_ms": 5.2
    },
    "mongodb": {
      "status": "up",
      "latency_ms": 2.1
    },
    "neo4j": {
      "status": "up",
      "latency_ms": 8.5
    },
    "llm_provider": {
      "status": "up",
      "latency_ms": 150.0
    }
  },
  "checked_at": "2026-04-13T10:30:00Z"
}

Status Values

  • healthy - All components operational
  • degraded - Some components degraded
  • unhealthy - One or more components down

GET /api/stats/channel/{channel_id}

Get statistics for a specific channel.

Parameters

Prop

Type

Response

{
  "channel_id": "C12345",
  "message_count": 15234,
  "fact_count": 856,
  "entity_count": 45,
  "decision_count": 23,
  "author_count": 15,
  "wiki_page_count": 12,
  "date_range": {
    "earliest": "2026-01-01T00:00:00Z",
    "latest": "2026-04-13T10:30:00Z"
  },
  "activity": {
    "messages_last_7d": 234,
    "messages_last_30d": 1234,
    "facts_added_last_7d": 45,
    "facts_added_last_30d": 156
  }
}

GET /api/stats/activity

Get recent system activity.

Query Parameters

Prop

Type

Response

{
  "activities": [
    {
      "type": "sync_completed",
      "channel_id": "C12345",
      "message_count": 150,
      "timestamp": "2026-04-13T10:30:00Z"
    },
    {
      "type": "wiki_generated",
      "channel_id": "C12345",
      "page_count": 12,
      "timestamp": "2026-04-13T10:28:00Z"
    },
    {
      "type": "connection_established",
      "connection_id": "conn_123",
      "timestamp": "2026-04-13T09:00:00Z"
    }
  ]
}

Activity Types

  • sync_completed - Message sync completed
  • wiki_generated - Wiki pages generated
  • connection_established - New connection created
  • connection_failed - Connection error
  • fact_extracted - Facts extracted
  • entity_created - Graph entity created

GET /api/stats/metrics

Get detailed metrics for monitoring.

Response

{
  "performance": {
    "avg_query_latency_ms": 45,
    "avg_sync_duration_seconds": 120,
    "avg_wiki_generation_seconds": 85
  },
  "storage": {
    "weaviate_objects": 856,
    "mongodb_documents": 45,
    "neo4j_nodes": 123,
    "neo4j_relationships": 234
  },
  "usage": {
    "total_llm_calls": 1234,
    "total_llm_tokens": 567890,
    "estimated_cost_usd": 12.34
  },
  "quality": {
    "avg_fact_quality_score": 0.72,
    "high_importance_facts": 234,
    "decision_count": 45
  }
}

GET /api/stats/top-authors

Get top contributors across all channels.

Query Parameters

Prop

Type

Response

[
  {
    "author_id": "U12345",
    "author_name": "Jane Smith",
    "message_count": 2341,
    "fact_count": 156,
    "decision_count": 12,
    "channels": ["C12345", "C67890"]
  }
]

GET /api/stats/top-topics

Get most discussed topics.

Query Parameters

Prop

Type

Response

[
  {
    "topic": "authentication",
    "fact_count": 45,
    "channels": ["C12345", "C67890"],
    "trend": "rising"
  }
]

GET /api/stats/export

Export statistics as CSV or JSON.

Query Parameters

Prop

Type

Response

Returns CSV or JSON file with statistics.

Metrics Definitions

Query Latency

Time to process a search or query request.

RangeQuality
< 50msExcellent
50-100msGood
100-200msFair
> 200msPoor

Fact Quality Score

Average quality score of extracted facts (0.0-1.0).

RangeQuality
> 0.8Excellent
0.6-0.8Good
0.4-0.6Fair
< 0.4Poor

Sync Duration

Time to sync messages from a channel.

RangeQuality
< 60sExcellent
60-120sGood
120-300sFair
> 300sPoor
How is this guide?

On this page

Ready for production?

Ship to production with SSO, audit logs, spend controls, and guardrails your security team will approve.

Talk to the team

or email hello@beever.ai