Cloud Edition
See On-Premise Edition →
Natalia Analytics error codes
Agent (NAT-AGT-XXX) and cloud API (NAT-API-XXX) error codes. Each row links to its resolution page.
Agent codes (NAT-AGT-XXX)
| Code | Symptom | Probable cause | Resolution | Related page |
|---|---|---|---|---|
| NAT-AGT-001 | SCP timeout connecting to the PBX | Network split or firewall blocking port 22 | Automatic exponential backoff retry | Troubleshooting |
| NAT-AGT-002 | OXE Taxation license missing | spadmin -l does not list the account package |
Contact your Alcatel-Lucent integrator | OXE configuration |
| NAT-AGT-003 | SCP permission denied | /etc/shells or filesystem ACL too restrictive |
Fix ACL on /usr4/account/ | OXE configuration |
| NAT-AGT-004 | SSH connection refused | SSH not enabled on OXE | netadmin -m then enable SSH service |
OXE configuration |
| NAT-AGT-005 | /usr4/account path not found |
Non-standard OXE install or alternative path | find /usr -name TAXA* and update the agent configuration |
OXE configuration |
| NAT-AGT-006 | OXO JWT expired | Automatic renewal missed before TTL 1h | Check polling interval is < TTL 1h | OXO configuration |
| NAT-AGT-007 | Disk buffer above 80% | API down or polling interval too frequent | Drain queue or wait for API recovery | Troubleshooting |
| NAT-AGT-008 | Disk buffer above 95% — polling PAUSED | Cloud API has been unreachable for ~3 days | Restore API connectivity, polling resumes automatically | Troubleshooting |
| NAT-AGT-009 | Admin password lost | vTPM not available on the host | Redeploy a fresh OVA (encrypted config is unrecoverable by design) | Troubleshooting |
| NAT-AGT-010 | CDR parser failed (unexpected format) | .DAT file not decompressed before parsing |
Verify gunzip on the agent and re-queue the file | Troubleshooting |
API codes (NAT-API-XXX)
| Code | Symptom | Probable cause | Resolution | Related page |
|---|---|---|---|---|
| NAT-API-001 | 401 Unauthorized | Invalid or revoked API key | Rotate the API key | Security |
| NAT-API-002 | 403 Forbidden | API key not scoped to ingest_cdr | Verify scopes on the key | Security |
| NAT-API-003 | 409 Conflict | File already ingested (deduplication) | Idempotent — safely ignore | — |
| NAT-API-004 | 413 Payload too large | File above 50 MB | Split into smaller batches | — |
| NAT-API-005 | 429 Too Many Requests | Rate limit hit on the tenant | Exponential backoff retry | — |
| NAT-API-006 | 503 Service Unavailable | Cloud DB or storage temporarily down | status.getnatalia.com | — |