Skip to main content

Error Codes Reference

This reference documents error codes you may encounter in Anava, their meanings, and resolution steps.

Error Code Format​

Anava error codes follow the pattern:

[CATEGORY]-[NUMBER]: [Description]
CategoryRangeArea
CON1000-1999Connection errors
AUTH2000-2999Authentication errors
CFG3000-3999Configuration errors
CAM4000-4999Camera errors
AI5000-5999Analysis errors
INT6000-6999Integration errors
SYS7000-7999System errors

Connection Errors (CON)​

CON-1001: MQTT Connection Failed​

Description: Cannot establish connection to MQTT broker.

Causes:

  • Network connectivity issues
  • Firewall blocking port 8883
  • DNS resolution failure
  • Broker unavailable

Resolution:

  1. Check network connectivity
  2. Verify port 8883 is open outbound
  3. Check DNS settings
  4. Retry connection

CON-1002: MQTT Connection Lost​

Description: Connection to MQTT broker was interrupted.

Causes:

  • Network instability
  • Firewall timeout
  • Broker restart
  • Certificate expiration

Resolution:

  1. Check network stability
  2. Increase firewall session timeout
  3. Connection will auto-reconnect
  4. Check certificate validity

CON-1003: Cloud API Unreachable​

Description: Cannot reach Anava cloud API.

Causes:

  • Internet connectivity lost
  • API service outage
  • DNS failure

Resolution:

  1. Check internet connection
  2. Verify API status at status.anava.ai
  3. Check DNS configuration

CON-1004: Connection Timeout​

Description: Connection attempt timed out.

Causes:

  • Slow network
  • High latency
  • Server overloaded

Resolution:

  1. Check network speed
  2. Retry connection
  3. Contact support if persistent

Authentication Errors (AUTH)​

AUTH-2001: Invalid Credentials​

Description: Provided credentials are invalid.

Causes:

  • Wrong username/password
  • Account disabled
  • Credentials expired

Resolution:

  1. Verify credentials
  2. Reset password if needed
  3. Contact admin if disabled

AUTH-2002: Certificate Invalid​

Description: Device certificate validation failed.

Causes:

  • Certificate expired
  • Certificate revoked
  • Clock sync issue
  • Wrong certificate chain

Resolution:

  1. Check certificate expiration
  2. Verify system time (NTP)
  3. Re-provision device if needed

AUTH-2003: Token Expired​

Description: Authentication token has expired.

Causes:

  • Session timeout
  • Long inactivity
  • Token revoked

Resolution:

  1. Re-authenticate
  2. Clear cache and retry
  3. Check session timeout settings

AUTH-2004: Insufficient Permissions​

Description: User lacks permission for requested action.

Causes:

  • Role doesn't include permission
  • Group access not granted
  • Feature not available

Resolution:

  1. Check user role
  2. Request elevated permissions
  3. Verify group access

AUTH-2005: MFA Required​

Description: Multi-factor authentication is required.

Causes:

  • MFA enforced for account
  • New device login
  • Security policy

Resolution:

  1. Complete MFA challenge
  2. Use registered authenticator
  3. Contact admin if locked out

Configuration Errors (CFG)​

CFG-3001: Invalid Skill Configuration​

Description: Skill configuration is invalid.

Causes:

  • Missing required field
  • Invalid value
  • Schema mismatch

Resolution:

  1. Review skill configuration
  2. Check required fields
  3. Validate against schema

Common Missing Fields:

  • name - Required
  • fullAnalysisUserPrompt - Required
  • objects - At least one required

CFG-3002: Invalid Profile Configuration​

Description: Profile configuration is invalid.

Causes:

  • Invalid trigger type
  • Missing skill reference
  • Invalid view area

Resolution:

  1. Verify trigger configuration
  2. Check skill exists
  3. Validate view area (1-8)

CFG-3003: Skill Not Found​

Description: Referenced skill does not exist.

Causes:

  • Skill deleted
  • Wrong skill ID
  • Skill in different group

Resolution:

  1. Verify skill ID
  2. Check skill exists in group
  3. Update profile reference

CFG-3004: Circular Reference​

Description: Configuration contains circular reference.

Causes:

  • Template referencing itself
  • Dependency loop

Resolution:

  1. Review configuration dependencies
  2. Remove circular references

CFG-3005: Configuration Sync Failed​

Description: Failed to sync configuration to device.

Causes:

  • Device offline
  • Configuration too large
  • Version conflict

Resolution:

  1. Check device connectivity
  2. Retry sync
  3. Force full configuration push

Camera Errors (CAM)​

CAM-4001: Camera Offline​

Description: Camera is not responding.

Causes:

  • Power failure
  • Network disconnection
  • Camera crash
  • Firmware issue

Resolution:

  1. Check camera power
  2. Verify network connection
  3. Restart camera
  4. Check firmware version

CAM-4002: ACAP Not Running​

Description: Anava ACAP is not running on camera.

Causes:

  • ACAP stopped
  • ACAP crashed
  • Insufficient resources
  • License issue

Resolution:

  1. Check camera Apps page
  2. Start ACAP if stopped
  3. Check application logs
  4. Reinstall ACAP if needed

CAM-4003: Image Capture Failed​

Description: Failed to capture image from camera.

Causes:

  • Camera busy
  • Resource exhaustion
  • VAPIX error
  • Authentication failure

Resolution:

  1. Retry capture
  2. Reduce concurrent operations
  3. Check camera credentials
  4. Restart camera if persistent

CAM-4004: View Area Invalid​

Description: Specified view area does not exist.

Causes:

  • View area not configured
  • Single-sensor camera
  • Wrong view area number

Resolution:

  1. Check camera capabilities
  2. Configure view area on camera
  3. Use valid view area (typically 1-4)

CAM-4005: Unsupported Trigger Type​

Description: Camera doesn't support specified trigger.

Causes:

  • AOAS not installed
  • Feature not available
  • Firmware too old

Resolution:

  1. Check camera capabilities
  2. Install required analytics
  3. Update firmware if needed
  4. Use compatible trigger type

Analysis Errors (AI)​

AI-5001: Analysis Timeout​

Description: AI analysis exceeded time limit.

Causes:

  • Complex image
  • Model overloaded
  • Network latency

Resolution:

  1. Retry automatically
  2. Check image quality
  3. Simplify skill prompts if persistent

AI-5002: Pre-filter Rejected​

Description: Image was filtered out by pre-filter.

Causes:

  • Image doesn't match criteria
  • Pre-filter too strict
  • Expected behavior

Resolution:

  1. This is often expected
  2. Review pre-filter criteria if too aggressive
  3. Check sample images

AI-5003: Model Error​

Description: AI model returned an error.

Causes:

  • Model unavailable
  • Invalid prompt
  • Content policy

Resolution:

  1. Check prompt content
  2. Retry request
  3. Contact support if persistent

AI-5004: Invalid Response​

Description: AI response couldn't be parsed.

Causes:

  • Unexpected response format
  • Model confusion
  • Prompt issues

Resolution:

  1. Review prompt clarity
  2. Check response criteria
  3. Add examples to prompt

AI-5005: Rate Limited​

Description: Analysis rate limit exceeded.

Causes:

  • Too many requests
  • Burst activity
  • Account limit

Resolution:

  1. Reduce trigger frequency
  2. Wait and retry
  3. Contact support for limit increase

Integration Errors (INT)​

INT-6001: Webhook Delivery Failed​

Description: Failed to deliver webhook payload.

Causes:

  • Endpoint unreachable
  • Authentication failed
  • Timeout

Resolution:

  1. Check endpoint URL
  2. Verify authentication
  3. Check endpoint is responding
  4. Review webhook logs

INT-6002: Email Send Failed​

Description: Failed to send email notification.

Causes:

  • Invalid email address
  • SMTP error
  • Rate limited

Resolution:

  1. Verify email address
  2. Check email configuration
  3. Review spam filters

INT-6003: ONVIF Event Failed​

Description: Failed to emit ONVIF event.

Causes:

  • ONVIF service error
  • Event queue full
  • Camera issue

Resolution:

  1. Check camera ONVIF settings
  2. Restart ACAP
  3. Verify VMS subscription

INT-6004: Push Notification Failed​

Description: Failed to send push notification.

Causes:

  • Device not registered
  • Token expired
  • Service unavailable

Resolution:

  1. Verify device registration
  2. Re-register in app
  3. Check notification permissions

System Errors (SYS)​

SYS-7001: Internal Error​

Description: Unexpected internal error occurred.

Causes:

  • Software bug
  • Unexpected state
  • Resource exhaustion

Resolution:

  1. Retry operation
  2. Report to support with details
  3. Check logs for details

SYS-7002: Storage Error​

Description: Failed to store data.

Causes:

  • Storage full
  • Permission error
  • Service unavailable

Resolution:

  1. Check storage capacity
  2. Verify permissions
  3. Contact support

SYS-7003: Resource Exhausted​

Description: System resource limit reached.

Causes:

  • Memory full
  • CPU overloaded
  • Too many connections

Resolution:

  1. Reduce workload
  2. Increase resources
  3. Optimize configuration

SYS-7004: Version Mismatch​

Description: Component versions are incompatible.

Causes:

  • ACAP outdated
  • API version mismatch
  • Partial update

Resolution:

  1. Update ACAP to latest
  2. Check compatibility matrix
  3. Complete all updates

SYS-7005: License Error​

Description: License validation failed.

Causes:

  • License expired
  • Camera not licensed
  • License server unreachable

Resolution:

  1. Check license status
  2. Renew if expired
  3. Verify camera registration

Error Handling​

Error Handling Flow​

Error handling flow from categorization through escalation

Retry Behavior​

Error CategoryAuto-RetryRetry CountDelay
CONYes3Exponential
AUTHNo0N/A
CFGNo0N/A
CAMYes25 seconds
AIYes2Linear
INTYes3Exponential
SYSDepends130 seconds

Retry Strategy Details​

Retry backoff strategies for retryable errors

Escalation Path​

  1. Check this reference - Most issues have documented solutions
  2. Review logs - Camera and cloud logs provide details
  3. Search knowledge base - docs.anava.ai
  4. Contact support - support@anava.ai with error code and logs