Usage Analytics

# The Python SDK does not yet support the usage endpoint
# Use the requests library directly
import requests

response = requests.get(
    "http://localhost:8000/api/v1/usage",
    headers={"X-API-Key": "any-value"}  # Not validated in on-prem
)

data = response.json()
print(f"Total requests: {data['summary']['total_requests']}")
print(f"Success rate: {data['summary']['success_rate']:.2%}")

import requests
from datetime import datetime, timedelta, timezone

# Query last 7 days
end_date = datetime.now(timezone.utc)
start_date = end_date - timedelta(days=7)

response = requests.get(
    "http://localhost:8000/api/v1/usage",
    params={
        "start_date": start_date.isoformat(),
        "end_date": end_date.isoformat()
    },
    headers={"X-API-Key": "any-value"}
)

data = response.json()

import requests
from datetime import datetime, timezone

def get_usage_metrics():
    """Fetch current usage metrics for monitoring dashboard."""
    response = requests.get(
        "http://localhost:8000/api/v1/usage",
        headers={"X-API-Key": "any-value"}
    )
    
    if response.status_code != 200:
        raise Exception(f"Failed to fetch metrics: {response.status_code}")
    
    return response.json()

def print_dashboard():
    """Print a simple monitoring dashboard."""
    data = get_usage_metrics()
    
    print("=" * 60)
    print("DATALAB ON-PREM USAGE DASHBOARD")
    print("=" * 60)
    
    # Summary
    summary = data["summary"]
    print(f"\n📊 SUMMARY (Last 24 Hours)")
    print(f"  Total Requests:     {summary['total_requests']:,}")
    print(f"  Successful:         {summary['successful_requests']:,}")
    print(f"  Failed:             {summary['failed_requests']:,}")
    print(f"  Success Rate:       {summary['success_rate']:.2%}")
    print(f"  Pages Processed:    {summary['successful_pages_processed']:,}")
    
    # By type
    print(f"\n📈 BY REQUEST TYPE")
    for req_type, metrics in data["by_request_type"].items():
        print(f"  {req_type.upper()}:")
        print(f"    Requests: {metrics['total_requests']:,} ({metrics['successful_requests']:,} successful)")
        print(f"    Pages: {metrics['successful_pages_processed']:,}")
    
    # Performance
    perf = data["performance"]
    if perf["average_processing_time_secs"]:
        print(f"\n⚡ PERFORMANCE")
        print(f"  Avg Processing:     {perf['average_processing_time_secs']:.2f}s")
        print(f"  Median Processing:  {perf['median_processing_time_secs']:.2f}s")
        print(f"  P95 Processing:     {perf['p95_processing_time_secs']:.2f}s")
        print(f"  P99 Processing:     {perf['p99_processing_time_secs']:.2f}s")
        print(f"  Avg Queue Wait:     {perf['average_queue_wait_secs']:.2f}s")
    
    # Current status
    status = data["current_status"]
    print(f"\n🔄 CURRENT STATUS")
    print(f"  In Progress:        {status['requests_in_progress']}")
    print(f"  Queued:             {status['requests_queued']}")
    
    print("=" * 60)

if __name__ == "__main__":
    print_dashboard()