Monitoring & Debugging

Health Check

Endpoint: /.well-known/agent-card.json

Use: Monitor agent availability

# Quick health check
curl https://api.stactize.com/.well-known/agent-card.json

Expected: 200 OK with agent card JSON

Request Logging

Log These Fields:

• Request timestamp
• User ID (x-user-id)
• Company researched
• Response status code
• Response time (ms)
• Error messages (if any)
• Task ID (for tracking)

Example Log Format:

2025-01-15T10:30:45Z | user-12345 | Salesforce | 200 | 45s | task-abc-123
2025-01-15T10:31:20Z | user-67890 | Slack | 429 | 0.5s | rate_limit_exceeded

Usage Analytics

Track these metrics for your integration:

1. Request Volume: Total requests per day/hour
2. Success Rate: Successful requests / total requests
3. Error Rate: Failed requests / total requests
4. Average Latency: Mean response time
5. P95 Latency: 95th percentile response time
6. Quota Usage: Current usage vs. limit

Debugging Checklist

When troubleshooting integration issues:

• ☐ Verify API key is correct and active
• ☐ Check x-api-key header is included
• ☐ Confirm request JSON is valid (use JSON validator)
• ☐ Verify endpoint URL is correct
• ☐ Check timeout settings (300s minimum)
• ☐ Review quota usage (not exceeded)
• ☐ Test with curl first (isolate client issues)
• ☐ Check network connectivity and DNS
• ☐ Verify SSL/TLS certificate validation
• ☐ Review application logs for errors

Support Channels