Troubleshooting

This guide covers common issues encountered when using Anava and their solutions.

Detection Issues

No Detections Occurring

Symptoms: Camera is online but no sessions are created.

Check:

1. Detection exists

   • Go to Detections page → Verify detection is listed
   • Check schedule matches current time

2. Trigger is firing

   • Test trigger manually (motion, AOAS event)
   • Check camera event log for trigger events

3. Camera is assigned

   • Verify camera is in the group
   • Check device shows "Online"

4. ACAP is running

   • Check camera web interface → Apps
   • Anava ACAP should show "Running"

Solution Path:

Too Many False Positives

Symptoms: Detection fires but nothing is present.

Common Causes:

Cause	Solution
Motion from shadows	Use AOAS Object trigger instead
Reflections	Adjust detection area to exclude
Weather (rain, snow)	Increase confidence threshold
Swaying objects	Refine pre-filter prompt

Tuning Steps:

1. Review false positive sessions
2. Identify common pattern
3. Update skill pre-filter to exclude
4. Increase confidence threshold if needed
5. Test and iterate

Missed Detections

Symptoms: Real events not being detected.

Check:

1. Confidence threshold too high

   • Lower threshold incrementally
   • Review sessions with lower confidence

2. Object not in skill

   • Add object type to skill
   • Update prompts to include

3. Trigger not capturing

   • Check AOAS area configuration
   • Verify motion sensitivity

4. Schedule mismatch

   • Verify profile is active during event time

Wrong Objects Detected

Symptoms: AI identifies wrong object type.

Solutions:

1. Improve prompts

   • Be more specific about what to look for
   • Add negative examples ("not a shadow")

2. Add pre-filter

   • Filter obvious non-matches early
   • Reduce full analysis of irrelevant images

3. Check image quality

   • Increase resolution if details unclear
   • Review lighting conditions

Camera Issues

Camera Shows Offline

Symptoms: Device status shows offline.

Check:

1. Network connectivity

   • Ping camera IP
   • Check switch/network equipment

2. Camera power

   • Verify PoE power
   • Check camera LEDs

3. MQTT connection

   • Check camera MQTT settings
   • Verify broker is reachable

4. Firewall rules

   • Outbound 8883 (MQTT)
   • Outbound 443 (HTTPS)

Camera Connects Intermittently

Symptoms: Camera goes online/offline repeatedly.

Common Causes:

Cause	Solution
Network instability	Check switch, cabling
PoE power issues	Verify adequate power budget
MQTT keepalive	Adjust keepalive interval
Firewall timeout	Increase session timeout

Image Quality Issues

Symptoms: Captured images are dark, blurry, or poor quality.

Check:

1. Resolution setting

   • Increase from BALANCED to HIGH
   • Consider HD_720 for detail work

2. Camera settings

   • Check exposure settings
   • Verify focus is correct
   • Adjust for lighting conditions

3. View area

   • Correct view area selected?
   • Camera pointing at right scene?

Connection Issues

ACAP Not Connecting

Symptoms: ACAP installed but shows disconnected.

Check:

1. Certificate status

   • Check Edge Vault certificate
   • Verify not expired

2. MQTT settings

   • Broker URL correct
   • Port 8883 open

3. Time sync

   • Camera time accurate
   • NTP configured

Debug Steps:

Camera Web Interface:
1. System → Logs → Application log
2. Look for MQTT connection errors
3. Note error codes for support

Session Upload Failing

Symptoms: Sessions created but images not showing.

Check:

1. Cloud storage access

   • Verify GCS bucket accessible
   • Check authentication

2. Network bandwidth

   • Large images may timeout
   • Lower resolution temporarily

3. ACAP logs

   • Check for upload errors
   • Note specific failures

Profile Issues

Schedule Not Working

Symptoms: Profile doesn't activate/deactivate on schedule.

Check:

1. Timezone settings

   • Camera timezone correct?
   • Schedule in correct timezone?

2. Schedule format

   • Verify schedule syntax
   • Test with "24/7" to confirm basic function

3. Conflicting profiles

   • Multiple profiles with different schedules?
   • Check priority ordering

TTS Not Playing

Symptoms: Detection occurs but no audio.

Check:

1. TTS enabled

   • Object or question has talkdownEnabled = true
   • Talkdown rule conditions met

2. Speaker connected

   • Camera has audio output
   • External speaker connected and working

3. Buffer period

   • TalkdownBufferMs prevents rapid repeat
   • Wait for buffer to expire

4. Audio test

   • Test speaker through camera interface
   • Verify audio levels

Notifications Not Sending

Symptoms: Push notifications not received.

Check:

1. Notification enabled

   • Object has pushNotification = true
   • App notifications allowed

2. Mobile app

   • Logged in to correct account
   • Notifications enabled in app settings
   • Device notifications enabled in OS

3. Detection occurred

   • Verify session was created
   • Confidence threshold met

Performance Issues

Slow Analysis

Symptoms: Long delay between trigger and results.

Common Causes:

Cause	Typical Delay	Solution
High resolution	2-5 sec	Lower resolution
Large images	2-4 sec	Use BALANCED
Active Monitoring	5-60 sec	Expected for temporal
Network latency	Variable	Check connectivity

High CPU on Camera

Symptoms: Camera performance degraded.

Check:

1. ACAP resource usage

   • Check camera CPU in web interface
   • Multiple ACAPs running?

2. Too many profiles

   • Reduce active profiles
   • Combine similar analyses

3. High trigger rate

   • Adjust trigger sensitivity
   • Use AOAS instead of motion

Queue Backlog

Symptoms: Events taking long to appear.

Solutions:

1. Reduce trigger rate

   • Increase trigger thresholds
   • Add pre-filtering

2. Simplify skills

   • Fewer objects per skill
   • Shorter prompts

3. Check system status

   • Service degradation?
   • Contact support if persistent

Integration Issues

ONVIF Events Not Received

Symptoms: VMS not receiving events from Anava.

Check:

1. Object is stateful

   • Object has stateful = true
   • Only stateful objects emit ONVIF

2. VMS subscription

   • VMS subscribed to camera events
   • Check VMS event log

3. Camera ONVIF enabled

   • ONVIF services active
   • VMS has correct credentials

Webhook Delivery Failing

Symptoms: Webhooks configured but not arriving.

Check:

1. Endpoint accessible

   • Test URL manually
   • Check firewall rules

2. Response codes

   • Endpoint returning 2xx?
   • Check for authentication issues

3. Payload format

   • Expecting correct JSON structure?
   • Check content-type header

Getting Help

Collecting Diagnostics

When contacting support, gather:

1. Camera info

   • Model and serial number
   • Firmware version
   • ACAP version

2. Error details

   • Exact error message
   • Timestamps
   • Steps to reproduce

3. Configuration

   • Profile/skill settings
   • Trigger configuration

4. Logs

   • Camera application logs
   • Network traces if applicable

Support Channels

Issue Type	Channel
Bug reports	GitHub Issues
Configuration help	Documentation
Account issues	support@anava.ai
Emergency	Priority support line

Log Locations

Log	Location
ACAP logs	Camera → System → Logs → Application
Events	Anava Console → Sessions
System	Anava Console → Admin → Logs

Related Topics

• Detections Overview - Understanding the Detection model
• Optimization - Reducing false positives
• Event Flow - Understanding the pipeline