Skip to main content

​
Overview

Alfred Black gives you visibility into your Alfred’s health, specialist status, and service operations — from your dashboard and via the API.

​
Dashboard Command Center

Your Alfred Black dashboard Command Center shows at a glance:
  • Health badge — Overall status (healthy, degraded, or down)
  • Vault stats — Record counts and recent activity
  • Specialist status — Whether the Curator, Janitor, Distiller, and Surveyor are running

​
Health check

​
From the API

curl -s /api/v1/admin/health \
  -H "Authorization: Bearer alf_your_key_here" | jq .
Example response: 
{
  "status": "ok",
  "containers": 5,
  "unhealthy": 0,
  "disk_percent": 45,
  "memory_percent": 62
}

​
What health statuses mean

StatusMeaning
healthyAll services running normally
degradedSome services have issues but core functionality works
downCritical services are unavailable

​
System information

Get detailed system metrics: 
curl -s /api/v1/admin/system/info \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
Service status

List all services running on your Alfred: 
curl -s /api/v1/admin/containers \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
Viewing logs

​
From the dashboard

Navigate to the Logs page to view real-time logs from your services.

​
Via the API

Stream logs in real-time using Server-Sent Events: 
# Stream all logs
curl -N /api/v1/logs \
  -H "Authorization: Bearer alf_your_key_here"

# Stream logs from a specific service
curl -N "/api/v1/logs?service=alfred" \
  -H "Authorization: Bearer alf_your_key_here"
Get logs from a specific service: 
curl -s /api/v1/admin/containers/alfred/logs \
  -H "Authorization: Bearer alf_your_key_here"

​
Restarting services

If a service is misbehaving, you can restart it from the dashboard or via the API: 
curl -X POST /api/v1/admin/containers/alfred/restart \
  -H "Authorization: Bearer alf_your_key_here"

​
Specialist monitoring

Check what your specialists are up to: 
# Overall worker status
curl -s /api/v1/workers/status \
  -H "Authorization: Bearer alf_your_key_here"

# Janitor scan history
curl -s /api/v1/workers/janitor/history \
  -H "Authorization: Bearer alf_your_key_here"

# Distiller extraction history
curl -s /api/v1/workers/distiller/history \
  -H "Authorization: Bearer alf_your_key_here"

Your Specialists

Direct your specialists

Instance API

Full management endpoints