Skip to main content
algolia-incident-runbook Execute Algolia incident response: triage search failures, distinguish
Algolia-side vs your-side issues, apply fallbacks, and run postmortems.
Trigger: "algolia incident", "algolia outage", "algolia down",
"algolia on-call", "algolia emergency", "algolia broken", "search is down".
Aller à l'installation Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill algolia-incident-runbookLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Plus depuis ce dépôt Implement user sign-up and sign-in flows with Clerk.
Use when building authentication UI, customizing sign-in experience,
or implementing OAuth social login.
Trigger with phrases like "clerk sign-in", "clerk sign-up",
"clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk.
Use when managing user sessions, configuring route protection,
or implementing token refresh and custom JWT templates.
Trigger with phrases like "clerk session", "clerk middleware",
"clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management.
Use when implementing SSO integration, configuring role-based permissions,
or setting up organization-level controls.
Trigger with phrases like "clerk SSO", "clerk RBAC",
"clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
Métiers associés SOC
Basé sur la classification professionnelle SOC
name algolia-incident-runbook description Execute Algolia incident response: triage search failures, distinguish
Algolia-side vs your-side issues, apply fallbacks, and run postmortems.
Trigger: "algolia incident", "algolia outage", "algolia down",
"algolia on-call", "algolia emergency", "algolia broken", "search is down".
allowed-tools Read, Grep, Bash(curl:*), Bash(npm:*) version 1.6.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","search","algolia"] compatibility Designed for Claude Code
Algolia Incident Runbook
Overview
Rapid incident response procedures for Algolia search failures. Algolia's infrastructure is distributed across multiple data centers with automatic failover, so true Algolia outages are rare. Most incidents are caused by API key issues, settings drift, or indexing pipeline failures on your side.
Severity Classification
Level Definition Response Examples P1 Search completely down < 15 min 403/500 on all queries, Algolia unreachable P2 Degraded search < 1 hour High latency, partial results, stale data P3 Minor issue < 4 hours Analytics not updating, synonyms wrong P4 No user impact Next day Monitoring gap, test failures
Quick Triage (Run These First)
#!/bin/bash
echo "=== ALGOLIA TRIAGE ==="
echo -n "Algolia Status: "
curl -s https://status.algolia.com/api/v2/status.json | jq -r '.status.description'
echo -n "API Connectivity: "
curl -s -o /dev/null -w "HTTP %{http_code} (%{time_total}s)" \
"https://${ALGOLIA_APP_ID} -dsn.algolia.net/1/indexes" \
-H "X-Algolia-Application-Id: ${ALGOLIA_APP_ID} " \
-H "X-Algolia-API-Key: ${ALGOLIA_ADMIN_KEY} "
echo ""
echo -n "Search test: "
curl -s "https://${ALGOLIA_APP_ID} -dsn.algolia.net/1/indexes/products/query" \
-H "X-Algolia-Application-Id: \
-H ${ALGOLIA_APP_ID}
"X-Algolia-API-Key: ${ALGOLIA_SEARCH_KEY} "
'{"query":"test","hitsPerPage":1}'
'{nbHits, processingTimeMS}'
echo
"Index stats:"
"https://${ALGOLIA_APP_ID} -dsn.algolia.net/1/indexes"
"X-Algolia-Application-Id: ${ALGOLIA_APP_ID} "
"X-Algolia-API-Key: ${ALGOLIA_ADMIN_KEY} "
'.items[] | {name, entries, lastBuildTimeS}'
Decision Tree Search returning errors?
├── YES: What HTTP status?
│ ├── 403: API key issue
│ │ ├── Key expired/deleted → Rotate key (see below)
│ │ └── Wrong key type → Use admin key for writes, search key for reads
│ ├── 404: Index doesn't exist
│ │ ├── Typo in index name → Check INDICES config
│ │ └── Index accidentally deleted → Trigger full reindex
│ ├── 429: Rate limited
│ │ ├── Per-key limit → Increase maxQueriesPerIPPerHour
│ │ └── Server limit → Reduce indexing batch frequency
│ └── 5xx: Algolia-side error
│ ├── status.algolia.com shows incident → Wait + enable fallback
│ └── No incident shown → Contact Algolia support with request IDs
└── NO: Search returning wrong/stale results?
├── 0 results unexpectedly → Check searchableAttributes, synonyms
├── Stale data → Check indexing pipeline, look at last sync timestamp
└── Wrong ranking → Review customRanking, check for conflicting rules
Immediate Remediation by Error Type
403 — Rotate API Key import { algoliasearch } from 'algoliasearch' ;
const adminClient = algoliasearch (process.env .ALGOLIA_APP_ID !, process.env .ALGOLIA_ADMIN_KEY !);
const { key : emergencyKey } = await adminClient.addApiKey ({
apiKey : {
acl : ['search' ],
description : `Emergency search key — ${new Date ().toISOString()} ` ,
indexes : ['products' , 'articles' ],
maxQueriesPerIPPerHour : 50000 ,
},
});
console .log (`Emergency key created: ...${emergencyKey.slice(-8 )} ` );
console .log ('Update ALGOLIA_SEARCH_KEY and redeploy' );
0 Results — Emergency Reindex
const { items } = await client.listIndices ();
const target = items.find (i =>name === 'products' );
console .log (`products: ${target?.entries ?? 'NOT FOUND' } records` );
if (!target || target.entries === 0 ) {
console .log ('Index is empty — triggering emergency reindex' );
await fullReindex ();
}
High Latency — Enable Fallback
const TIMEOUT_MS = 2000 ;
const FAILURE_THRESHOLD = 5 ;
let failures = 0 ;
async function searchWithCircuitBreaker (query : string if (failures >= FAILURE_THRESHOLD ) {
console .warn ('Circuit open: using database fallback' );
return databaseSearch (query);
}
try {
const controller = new AbortController ();
const timeout = setTimeout (() => controller.abort (), TIMEOUT_MS );
const result = await client.searchSingleIndex ({
indexName : 'products' ,
searchParams : { query, hitsPerPage : 20 },
});
clearTimeout (timeout);
failures = 0 ;
return result;
} catch (error) {
failures++;
console .error (`Algolia failure ${failures} /${FAILURE_THRESHOLD} :` , error);
return databaseSearch (query);
}
}
Communication Templates
Internal (Slack/PagerDuty) P[1-4] INCIDENT: Algolia Search
Status: INVESTIGATING | IDENTIFIED | MONITORING | RESOLVED
Impact: [Users cannot search / Search is slow / Results are stale]
Root cause: [API key expired / Index empty / Algolia incident]
Mitigation: [Fallback enabled / Key rotated / Waiting for Algolia]
Next update: [Time]
Owner: @[name]
Postmortem Template ## Incident: Search [Outage/Degradation]
**Date:** YYYY-MM-DD HH:MM–HH:MM UTC
**Duration:** X hours Y minutes
**Severity:** P[1-4]
**Detection:** [Alert name / User report / Status page]
### Timeline
- HH:MM — First alert fired
- HH:MM — Triage started, identified [root cause]
- HH:MM — Mitigation applied: [action]
- HH:MM — Resolved, monitoring
### Root Cause
[Technical explanation: what broke and why]
### Impact
- Search availability: X% during incident
- Users affected: ~N
### Action Items
- [ ] [Fix] — Owner — Due date
- [ ] [Prevent] — Owner — Due date
- [ ] [Detect faster] — Owner — Due date
Error Handling Issue Cause Solution Can't reach status.algolia.com Your network issue Use mobile, VPN, or check @algloiastatus on Twitter Triage script fails Missing env vars Set ALGOLIA_APP_ID, ALGOLIA_ADMIN_KEY, ALGOLIA_SEARCH_KEY Fallback search slow No DB index Add database full-text index as backup Key rotation breaks frontend CDN cache Purge CDN cache or wait for TTL
Resources
Next Steps For data handling and privacy, see algolia-data-handling.
