proof-server:proof-server-operations

Inspect readiness and job queue metrics for Midnight proof servers.

37|9|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/devrelaicom/midnight-expert --skill proof-server-proof-server-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proof-server:proof-server-operations
Source: https://github.com/devrelaicom/midnight-expert/tree/main/plugins/proof-server/skills/proof-server-operations
Command: npx skills add https://github.com/devrelaicom/midnight-expert --skill proof-server-proof-server-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduces downtime and operational uncertainty by providing actionable monitoring, health checks, troubleshooting steps, and capacity planning guidance for Midnight proof servers.

Core Features & Use Cases

  • Health and Readiness Monitoring: Interpret /health and /ready endpoints to determine liveness, readiness, and queue saturation.
  • Troubleshooting & Log Patterns: Identify common error signals such as 503/429/400 responses, timeout and memory issues, and log entries for job failures and cancellations.
  • Capacity Planning & Scaling: Estimate throughput by k-value and worker count, tune --num-workers and --job-capacity, and apply Docker and Kubernetes probe recommendations.
  • Use Case: Diagnose a production proof server returning 503 during peak traffic, determine whether to increase workers, adjust job capacity, or scale horizontally.

Quick Start

Ask the skill to check the proof server's /ready response, summarize jobsProcessing and jobsPending, and recommend immediate remediation and scaling actions.

Frequently Asked Questions about proof-server:proof-server-operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my proof server return 503 during peak traffic and how do I diagnose it?

A 503 response indicates proof server queue saturation or readiness failure. Inspect the /ready endpoint to check jobsProcessing and jobsPending metrics, then review log patterns for job failures to determine if you need to increase workers or scale horizontally.

How do I check proof server readiness and health endpoints in Kubernetes?

Proof server readiness is checked by querying the /ready and /health endpoints. You can configure Kubernetes readiness probes to poll these endpoints, interpreting job queue metrics and worker utilization to determine liveness and capacity saturation.

What is the best way to scale proof servers when job queues are saturated?

Scaling proof servers requires tuning --num-workers and --job-capacity based on k-value and worker count metrics. Estimate throughput capacity from queue utilization data, then apply horizontal scaling or adjust worker parameters to resolve saturation.

Can I use Docker health checks for Midnight proof server deployments?

Yes, Docker health checks support Midnight proof server deployments. You can configure Docker probes to monitor the /health and /ready endpoints, tracking jobsProcessing and jobsPending metrics to detect queue saturation and trigger automated restarts.

How do I troubleshoot proof server timeout and memory issues from logs?

Troubleshoot proof server timeouts and memory issues by analyzing log patterns for error signals like 503, 429, and 400 responses. Identify job failure and cancellation entries to isolate capacity bottlenecks and determine remediation steps.

When should I increase --num-workers versus scaling proof servers horizontally?

Increase --num-workers when proof server job capacity allows more concurrent processing, but scale horizontally when worker utilization is saturated and throughput gains plateau. Compare jobsPending against k-value limits to decide the optimal scaling approach.