Troubleshoot Splunk AR
Make sure you have a good scanning environment and check for unsupported visualizations if you're running into issues with Splunk AR.
Unable to scan barcode
If you're having trouble scanning a barcode, make sure you have sufficient lighting and that the barcode is on a non-reflective surface. If you're still having trouble, try slowly moving the camera over a surface near the barcode. Pan the camera across the surface and over the barcode again.
You can also restart the scan if the AR workspaces seem out of place.
Here's how to restart a scan if you've already scanned an asset:
- Deselect the workspace.
- Tap the refresh button.
- Tap Discard.
This clears all AR workspaces on your screen and refreshes the AR scanning function.
Here's how to restart a scan if you haven't scanned an asset:
- Tap the three dots icon.
- Tap Start New Scan.
This refreshes the AR scanning function.
Unable to see a dashboard or panel
Configure the appropriate dashboard permissions to make dashboards visible in the Connected Experiences apps. See Configure Splunk Cloud Gateway and dashboard permissions in the Install and Configure Splunk Cloud Gateway manual for more information about configuring dashboard permissions for the Connected Experiences apps. Apps without these permissions do not appear in the Connected Experiences apps.
If you can't find a dashboard you're looking for, and you're sure that it contains only supported visualizations, make sure the app that the dashboard comes from is selected in Splunk Cloud Gateway. See Select which Splunk apps to show dashboards from in the mobile apps in Use Splunk Cloud Gateway.
If the dashboard you're looking for isn't on the dashboard list or a panel isn't loading, the dashboard may contain an unsupported visualization or configuration. For supported visualizations and dashboard configurations, see Visualization support for the Connected Experiences apps in the Splunk Cloud Gateway Release Notes manual.
Unable to see a dashboard list
If you can't see your list of dashboards, you might be receiving a service connection error. See Troubleshoot Splunk Cloud Gateway Connection Issues in the Use Splunk Cloud Gateway manual.
Dashboards or AR workspaces aren't loading when I scan an asset tag
Check your internet connection. You also might be running into a service connection error. See Troubleshoot Splunk Cloud Gateway in the Use Splunk Cloud Gateway manual.
AR workspace oriented incorrectly
Augmented reality visualizations rely on a visual reference to render in a specific position and size. You can optimize scanning AR workspaces by using Splunk Cloud Gateway asset tags.
If you're using NFC tags, attach a detection image to the NFC tags. You can adjust and save visualizations for subsequent scans because the detection image provides Splunk AR a visual reference to anchor the AR workspace. See Save Splunk AR workspace orientation with NFC tags to learn how to use a detection image.
If you're using Splunk Cloud Gateway QR codes, use 4-by-4 centimeter QR codes. Splunk AR accepts 4-by-4 centimeters as a standard baseline size for a visual reference. If a QR code is larger, Splunk AR perceives the QR code as closer to the camera than it actually is and renders a relatively larger workspace. If a QR code is smaller than 4-by-4 centimeters, Splunk AR perceives the QR code as further from the camera and renders a relatively smaller workspace. A 4-by-4 centimeter QR code ensures that AR workspaces render in proper position and scale.
Device was unregistered after changing user credentials
If you or a Splunk admin changes your Splunk user credentials, then your device will be unregistered.
To register your device again, use Splunk Cloud Gateway. An admin must give you the cloudgateway role and enable token authentication so you can access the Connected Experiences apps again.
You can view or share logs from the Splunk AR app with the Splunk Support team to further troubleshoot any issues you might be running into.
- Navigate to Settings.
- Long press the Settings header. This takes you to the Diagnostics screen.
- Select Logs.
- Select the ellipsis.
- To share the logs with the Splunk Support team, select Share.
Manage playbooks in Splunk AR
This documentation applies to the following versions of Splunk® AR for iOS: 2.3.0, 2.4.1, 2.5.0