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:

1. Deselect the workspace.
2. Tap the refresh button.
3. 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:

1. Tap the three dots icon.
2. 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.

See Enable token authentication to learn how to enable token authentication. See Register your mobile device to a Splunk instance for registration steps.

View or share logs to troubleshoot Splunk AR

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.

1. Navigate to Settings.
2. Long press the Settings header. This takes you to the Diagnostics screen.
3. Select Logs.
4. Select the ellipsis.
5. To share the logs with the Splunk Support team, select Share.

Unable to enable Workflow Automation

If https://spl.mobi/ar/feature/enable_phantom doesn't take you to the Splunk AR Settings page, try the following steps:

1. On your device, go to Settings > Safari > Request Desktop Website > All websites > Switch Off.
2. Enter https://spl.mobi/ar/feature/enable_phantom into Safari. The URL takes you to the app store.
3. Go back to Safari.
4. Scroll up until the Splunk AR banner shows.
5. Tap Open. This takes you to the Splunk AR Settings screen.

See Enable Workflow Automation to finish enabling Workflow Automation.