Troubleshooting
Common Issues
Events not arriving
Check:
- API key is valid (Settings → API Keys)
- Authorization header includes "Bearer" prefix
- Network connectivity to api.blackfortress.tech
- Event payload is valid JSON
Solution: Verify API key and headers in request. Test with cURL.
High latency
Check:
- Network bandwidth availability
- API rate limits (check Retry-After header)
- Payload size (aim for <10KB per event)
Solution: Batch events, compress payloads, upgrade plan for higher limits.
Alerts not triggering
Check:
- Alert rules configured (Settings → Alerts)
- Notification channel is active
- Event severity meets alert threshold
Solution: Review alert configuration and test with manual incident.
False positives
Solution:
- Whitelist known-good activities
- Adjust sensitivity in Detection Settings
- Mark incidents as false positive for ML feedback
Performance Tuning
Optimize event ingestion:
- Batch 100-1000 events per request
- Use gzip compression for large payloads
- Implement exponential backoff for retries
- Monitor API quota usage
Getting Help
Can't find the answer? Contact support:
- Starter: support@blackfortress.tech (48h response)
- Pro: Slack channel (8h response)
- Enterprise: 24/7 phone support
When reporting issues, include: API version, event sample, timestamps, and error messages.