knowledge-base

Run find_runbooks.py with the --service flag, such as python find_runbooks.py --service payment. It searches pages labeled runbook, playbook, or sop and scores relevance based on title matches. You can also filter by alert name or Confluence space.

Use find_postmortems.py with a service name and optional --days window, for example --service checkout --days 180. It queries pages labeled postmortem or incident-review modified within that period and returns titles, IDs, and URLs.

CQL is Confluence Query Language for filtered searches by label, space, date, and text. Pass a query to search_cql.py, such as --cql 'type = page AND label = "runbook"', to run advanced searches beyond simple text matching.

In production, credentials are injected automatically by the IncidentFox credential proxy via CONFLUENCE_BASE_URL, so no token is needed. For local development, set CONFLUENCE_URL, CONFLUENCE_EMAIL, and CONFLUENCE_API_TOKEN environment variables.

Results may be empty if pages lack expected labels like runbook or postmortem, or if the search is scoped to the wrong space. Try a broader query with search_pages.py, remove the --space filter, or widen the --days window for post-mortems.