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 / Tool | iOS Logs | Android Logs |
|---|---|---|
| Xcode | ✅ Console output | N/A |
| Android Studio | N/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
- Open your project in Xcode
- Run the app on a simulator or device
- Open the Console panel (⇧⌘C)
- Filter by
UXCamto see relevant logs
Viewing Android Logs
- Open your project in Android Studio
- Run the app on an emulator or device
- Open Logcat panel
- Filter by
UXCamtag
What to Look For
| Log Message | Meaning |
|---|---|
Verification successful | SDK initialized correctly with a valid API key |
Session started | Recording has begun |
Session uploaded | Session data sent to UXCam servers |
Screen tagged: [name] | A screen tag was registered |
Occlusion applied | Privacy 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
| Issue | Solution |
|---|---|
| No logs visible | Ensure you're using Xcode (iOS) or Android Studio (Android), not a JS-only IDE |
Verification failed | Check that your API key is correct and the app key matches your UXCam dashboard |
Session not started | Verify optIntoVideoRecordings() is called before startWithConfiguration() |
| Logs stop appearing | The app may have been backgrounded — recording pauses until the app returns to foreground |
Updated about 8 hours ago
