KM-301h · Module 3
The Integration Audit
3 min read
Integrations drift. The tool version changes, the API the integration depends on is deprecated, the team that owned the integration restructures and the new team does not know it exists. The integration audit is the quarterly exercise that validates every active integration is functioning correctly, serving current knowledge, and owned by a responsible party. Without it, integration drift accumulates silently until a significant failure reveals it.
- Functional Validation For each integration, execute a functional test: trigger a push integration update and confirm delivery to the destination tool. Execute a pull integration query and confirm the result is current knowledge from the knowledge base. Test the failure handling: simulate a delivery failure and confirm the retry and alerting behavior. Functional validation confirms the integration is working, not just that it exists.
- Freshness Validation Confirm that the knowledge delivered through each integration is current. Take a sample of knowledge articles that have been updated recently and verify that the updates are reflected in the integrated tool. Freshness validation catches the failure mode where the integration appears functional (no errors) but is delivering knowledge from a stale cache or a syncing delay that exceeds the acceptable staleness window.
- Ownership Validation Confirm every integration has a current owner who can be reached for incident response. Contact each owner and confirm they are aware of the integration, know how to access it, and know the escalation path if it fails. Integrations whose owner has changed role without knowledge transfer are orphaned integrations — assign a new owner immediately or deprecate.
- Audit Output: Integration Health Report The audit produces an Integration Health Report: total integrations, functional pass rate, freshness pass rate, owner coverage rate, failure rate over last 90 days, and a prioritized list of integrations requiring remediation. This report is the operational visibility instrument for the knowledge integration function.