System Monitoring

Health checks, system status, and APM metrics.

GET /health

Basic health check endpoint.

Response

{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2025-12-25T10:00:00Z"
}

Status Values

Status	Meaning
healthy	All systems operational
degraded	Some features impacted
unhealthy	Service unavailable

Example

curl https://api.athenatrust.ai/v1/health

---

GET /engines/status

System status — check operational health of ATHENA's intelligence platform.

Response

{
  "overall_status": "operational",
  "uptime": "99.97%",
  "avg_response_time_ms": 45,
  "engines_operational": 5,
  "engines_total": 5,
  "patent_pending_components": 2
}

Status Values

Status	Meaning
operational	All systems functioning normally
degraded	Performance impacted
partial_outage	Some components unavailable
maintenance	Planned maintenance

Example

curl https://api.athenatrust.ai/v1/engines/status \
  -H "Authorization: Bearer YOUR_API_KEY"

---

GET /metrics

APM metrics for your account.

Response

{
  "requests_per_second": 234,
  "avg_response_time_ms": 45,
  "p95_response_time_ms": 120,
  "p99_response_time_ms": 250,
  "error_rate": 0.001,
  "rate_limit_hits": 12,
  "period": "5m"
}

Metric Definitions

Metric	Description
requests_per_second	Average RPS in period
avg_response_time_ms	Mean response time
p95_response_time_ms	95th percentile latency
p99_response_time_ms	99th percentile latency
error_rate	Percentage of 5xx errors
rate_limit_hits	Number of 429 responses

Example

curl https://api.athenatrust.ai/v1/metrics \
  -H "Authorization: Bearer YOUR_API_KEY"

---

SDK Examples

JavaScript

import { Athena } from '@athena-ai/sdk';

const athena = new Athena({ apiKey: 'YOUR_API_KEY' });

// Health check
const health = await athena.system.health();
console.log(`Status: ${health.status}`);

// System status
const status = await athena.engines.status();
console.log(`Overall: ${status.overallStatus}`);
console.log(`Uptime: ${status.uptime}`);

// Metrics
const metrics = await athena.system.metrics();
console.log(`RPS: ${metrics.requestsPerSecond}`);
console.log(`P95 Latency: ${metrics.p95ResponseTimeMs}ms`);

Python

from athena import Athena

athena = Athena(api_key='YOUR_API_KEY')

# Health check
health = athena.system.health()
print(f"Status: {health.status}")

# System status
status = athena.engines.status()
print(f"Overall: {status.overall_status}")
print(f"Uptime: {status.uptime}")

# Metrics
metrics = athena.system.metrics()
print(f"RPS: {metrics.requests_per_second}")
print(f"P95 Latency: {metrics.p95_response_time_ms}ms")

---

Status Page

For real-time status updates:

URL: https://status.athenatrust.ai

Subscribe to receive notifications for:

• Outages

• Degraded performance

• Scheduled maintenance

---

Next: Admin API