Integration Logging

Integration Logging

Enable verbose SDK logs to debug and verify your UXCam integration. Integration logging outputs detailed information about SDK initialization, session recording, and data upload.

Enable Logging

Set enableIntegrationLogging: true in your configuration:

import RNUxcam from 'react-native-ux-cam';

const configuration = {
  userAppKey: 'YOUR_API_KEY',
  enableAutomaticScreenNameTagging: false,
  enableIntegrationLogging: true, // Enable verbose logs
};

RNUxcam.optIntoVideoRecordings();
RNUxcam.startWithConfiguration(configuration);

Where Logs Appear

IDE / TooliOS LogsAndroid Logs
Xcode✅ Console outputN/A
Android StudioN/A✅ Logcat output
VSCode / Cursor❌ Not visible❌ Not visible
Metro bundler❌ Not visible❌ Not visible
⚠️

Important: Integration logs are native-level logs and only appear in native IDEs. They will not appear in your JavaScript console, Metro bundler, or editors like VSCode or Cursor.

Viewing iOS Logs

  1. Open your project in Xcode
  2. Run the app on a simulator or device
  3. Open the Console panel (⇧⌘C)
  4. Filter by UXCam to see relevant logs

Viewing Android Logs

  1. Open your project in Android Studio
  2. Run the app on an emulator or device
  3. Open Logcat panel
  4. Filter by UXCam tag

What to Look For

Log MessageMeaning
Verification successfulSDK initialized correctly with a valid API key
Session startedRecording has begun
Session uploadedSession data sent to UXCam servers
Screen tagged: [name]A screen tag was registered
Occlusion appliedPrivacy rules are active

Debug vs Release Behavior

Integration logging should only be enabled during development:

const configuration = {
  userAppKey: 'YOUR_API_KEY',
  enableAutomaticScreenNameTagging: false,
  enableIntegrationLogging: __DEV__, // Auto-disable in production
};
💡

Tip: Integration logging adds minimal overhead, but it's good practice to disable it in production builds to keep logs clean.

Troubleshooting

IssueSolution
No logs visibleEnsure you're using Xcode (iOS) or Android Studio (Android), not a JS-only IDE
Verification failedCheck that your API key is correct and the app key matches your UXCam dashboard
Session not startedVerify optIntoVideoRecordings() is called before startWithConfiguration()
Logs stop appearingThe app may have been backgrounded — recording pauses until the app returns to foreground