Compliance Alerting Playbook
Current launch uses dashboard review and operator-managed escalation. Notification channels remain post-certification roadmap items.
Why Alerting Discipline Matters for CCO/CPO
72-Hour GDPR Deadline
Data breaches require notification to authorities within 72 hours. Operator-owned alerting discipline keeps that deadline visible.
Control Test Failures
Control failures need fast escalation and documented follow-up before auditors find them.
Unusual Activity
Detect abnormal file processing patterns that may indicate insider threats or compromised accounts.
4 Alert Types to Operationalize
High-Risk File Processing
high_risk_filesTriggers when files with GPS location data, personal identifiers, or critical-risk metadata are processed
Unusual Processing Activity
unusual_activityTriggers when processing volume exceeds 5x normal hourly average (minimum 50 files)
Compliance Policy Violation
compliance_breachTriggers when data handling policies are violated or retention limits exceeded
Usage Quota Exceeded
quota_exceededTriggers when plan usage limits are exceeded
Planning Slack Notifications After Certification
Create Slack Webhook
- Go to api.slack.com/apps
- Click "Create New App" → "From scratch"
- Name it "Compliance Alerts" and select your workspace
- Under "Features" → "Incoming Webhooks" → Enable
- Click "Add New Webhook to Workspace"
- Select the channel (e.g., #compliance-alerts)
- Copy the Webhook URL
Map the Future Integration
- Define the Slack channel ownership and escalation policy
- Document the webhook destination and retention expectations
- Map which event classes will be eligible for push notification
- Keep the current launch workflow in the dashboard until notification rollout is certified
- Test the runbook with manual drills
- Approve the integration during a later release window
Create an Operator Escalation Rule
- Go to Compliance → Alerts
- Create the rule with severity and owner
- Document the manual escalation path for each severity
- Record backup contacts in the runbook
- Set review cadence and cooldown expectations
- Save the rule and rehearse it in tabletop review
Pro Tip: Channel Strategy
Create separate escalation paths for different severities and validate who responds at each stage before enabling push notifications later.
Planning Email Notifications After Certification
When Defining an Alert Runbook:
- List the recipients who own each alert severity
- Document the escalation order and fallback approver
- Capture the exact alert fields that must appear in the future email template
- Keep the current launch workflow inside the dashboard and evidence log
Best Practice: Escalation Chain
For CRITICAL alerts, define multiple recipients in order of escalation:analyst@company.com, cpo@company.com, ceo@company.com
Severity-Based Routing Guide
| Severity | Response Time | Recommended Channels | Cooldown |
|---|---|---|---|
| CRITICAL | < 15 minutes | Dashboard + operator call tree | 5 minutes |
| HIGH | < 1 hour | Dashboard + assigned owner | 15 minutes |
| MEDIUM | < 4 hours | Dashboard review | 60 minutes |
| LOW | Next business day | Dashboard only | 240 minutes |
Troubleshooting Common Issues
Slack notifications not arriving
- Confirm the alert rule has an assigned owner
- Check the escalation runbook is current
- Verify the issue appears in the dashboard
- Document the manual follow-up in the evidence log
Too many alerts (alert fatigue)
- Increase cooldown period (recommended: 60+ minutes for non-critical)
- Adjust trigger conditions to be more specific
- Use severity-based routing to reduce noise
- Consider dashboard-only for LOW severity
Alerts not triggering when expected
- Verify alert rule is active (isActive: true)
- Check if cooldown period has passed since last trigger
- Review trigger conditions match the event
- Confirm the assigned owner reviewed the dashboard state
Email notifications in spam
- Confirm the notification channel is still roadmap-only in the current launch
- Use the dashboard and evidence ledger as the source of truth
- Update the runbook before enabling email later
- Verify contact information is current for manual escalation