| name | mistral-incident-runbook |
| description | Execute Mistral AI incident response procedures with triage, mitigation, and postmortem.
Use when responding to Mistral AI-related outages, investigating errors,
or running post-incident reviews.
Trigger with phrases like "mistral incident", "mistral outage",
"mistral down", "mistral on-call", "mistral emergency".
|
| allowed-tools | Read, Grep, Bash(kubectl:*), Bash(curl:*) |
| version | 1.12.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","mistral","incident-response"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Mistral AI Incident Runbook
Overview
Rapid incident response procedures for Mistral AI integration failures. Covers severity classification, quick triage script, decision tree, per-error mitigations, communication templates, and postmortem process.
Severity Levels
| Level | Definition | Response Time | Example |
|---|
| P1 | Complete outage | < 15 min | All Mistral requests failing |
| P2 | Degraded service | < 1 hour | High latency, partial 429s |
| P3 | Minor impact | < 4 hours | Occasional errors, non-critical feature |
| P4 | No user impact | Next business day | Monitoring gaps, docs |
Quick Triage Script
#!/bin/bash
set -euo pipefail
echo "=== Mistral AI Quick Triage ==="
echo "Timestamp: $(date -u +%Y-%m-%dT%H:%M:%SZ)"
echo -e "\n1. Mistral API status:"
HTTP=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer ${MISTRAL_API_KEY}" \
https://api.mistral.ai/v1/models 2>/dev/null)
echo " HTTP: $HTTP"
case $HTTP in
200) echo " OK — API is reachable" ;;
401) echo " AUTH FAILURE — API key invalid or revoked" ;;
429) echo " RATE LIMITED — check workspace limits" ;;
5*) echo " SERVER ERROR — Mistral service issue" ;;
000) echo " NETWORK ERROR — cannot reach api.mistral.ai" ;;
-e
curl -sf https://yourapp.com/health 2>/dev/null | jq ||
-e
curl -sf 2>/dev/null \
| jq -r ||
