Associate assets with dashboards in the Splunk App for AR
Associate assets with data so Splunk AR mobile users can consume, interact with, and take action with data where it physically exists. Create a deployment to register assets and associate them with common data. A deployment consists of a group of assets, a workspace, and a dashboard selection. Each deployment gets data from a common dashboard and shares one workspace.
When creating a deployment, choose a dashboard, indicate whether you want to represent the dashboard in augmented reality or not, select a recognition method, and upload a CSV containing asset information.
To learn more about different recognition methods you can use, see the following documentation:
- About Splunk AR text, logo, and image detection
- About beacons with Splunk AR
- About geofences with Splunk AR
You can register individual assets in the Splunk AR mobile app after creating an asset deployment in the Splunk App for AR.
See Splunk AR deployments in the Get started with the Splunk App for AR topic to learn more about how deployments are structured.
Prerequisites
Complete the following requirements before registering assets:
- Install the Splunk App for AR. See Install the Splunk App for AR.
- Ensure you have the appropriate permissions. See Configure Splunk AR roles and permissions for more information.
- Ensure you have Splunk dashboards on your Splunk platform instance. See Visualization support for Connected Experiences apps in the Splunk Secure Gateway Release Notes manual for more information about compatible visualizations.
- Ensure you have compatible assets. See About Splunk AR asset tags.
Create an asset deployment
To create a deployment in the Splunk App for AR, configure the deployment properties and optionally upload a CSV file that contains information for multiple assets. Or you can skip the CSV file step and individually add assets to your deployment later on.
Configure the deployment properties
Here are the first steps to creating a deployment in the Splunk App for AR:
- Click Create Deployment.
- Enter a deployment name.
- Select a dashboard for the deployment.
- Select a deployment type.
- Select a recognition method. If you choose floor plan, select an existing floor plan. If you choose image, logo, or object tag, follow the prompt to upload a location identifier.
- (Optional) Select a location identifier. This step is required if you choose the text, image, logo, or object recognition method.
- If you're using a geofence, provide the geofence latitude, longitude, and radius values.
- If you're using beacons, you'll configure this in a later step.
- If prompted, select a relationship model.
- If prompted, provide beacon, geofence, or tag details.
Next, upload a CSV file that contains your asset information or your asset information in the following step. Or, you can skip this step and add individual assets later on when you select your deployment on the Deployments page.
(Optional) Upload a CSV file with asset information
The Splunk App for AR uses this file to identify your assets and associate the correct data.
Upload a CSV file that contains your asset information. Include the following column headers:
- Asset Title: A human-readable name for how each asset is represented in the Splunk App for AR.
- Asset ID: A unique key that differentiates assets. If this column is left empty, The Splunk App for AR automatically generates unique IDs for each asset.
The following are example CSV contents for asset deployments that use text, beacon, and geofence recognition.
Text
In addition to the Asset Title and Asset ID, include a Text Tag header and its values if you're using text tags as a recognition method:
Asset ID | Asset Title | Tag Text |
---|---|---|
101 | Engineering Room A | Room 101 |
102 | Chemistry Lab | Room 102 |
103 | Physics Lab | Room 103 |
104 | Biology Lab | Room 104 |
201 | Engineering Room B | Room 201 |
202 | Biochemistry Lab | Room 202 |
203 | Microbiology Lab | Room 203 |
301 | Engineering Room C | Room 301 |
Beacons
In addition to the Asset Title and Asset ID, include the following column headers and values if you're using beacons as a location identifier:
- UUID
- Beacon Title
- Major Value
- Minor Value
If you're using a single beacon region for your assets, you can leave the UUID column blank and use the Splunk App for AR to populate the UUID value later on. If you're using multiple beacon regions, include the unique UUID values in the CSV file.
Here's an example CSV file that contains multiple beacon region values:
Asset Title | UUID | Beacon Title | Major | Minor |
---|---|---|---|---|
Rotary Belt | 27976f12-1cd0-4b91-9647-3f1145567f9c | Assembly Area | 1 | 3 |
Head Cleaner | 27976f12-1cd0-4b91-9647-3f1145567f9c | Assembly Area | 1 | 3 |
Depalletizer | 27976f12-1cd0-4b91-9647-3f1145567f9c | Assembly Area | 1 | 3 |
Lifter | 786836df-8fb9-4f38-880d-c91d11479685 | Paint Shop | 2 | 1 |
Spray Machine | 786836df-8fb9-4f38-880d-c91d11479685 | Paint Shop | 2 | 2 |
Geofences
In addition to the Asset Title and Asset ID, include the following column headers if you're using geofences as a location identifier:
- Latitude
- Longitude
- Radius
- Geofence Name
If your assets are located within the same geofence, use the same Latitude, Longitude, Radius, and Geofence Name values for all rows.
Here's an example CSV file that contains multiple geofence values:
Asset Title | Latitude | Longitude | Radius | Geofence Title |
---|---|---|---|---|
SR-Server 1 | 37.3190022 | -121.9494862 | 1 | 3 |
SR-Server 2 | 37.3190022 | -121.9494862 | 1 | 3 |
SR-Server 3 | 37.3190022 | -121.9494862 | 100 | Santana Row |
SR-Switch 1 | 37.3190022 | -121.9494862 | 100 | Santana Row |
SR-Switch 2 | 37.3190022 | -121.9494862 | 100 | Santana Row |
SF-Server 1 | 37.7826032 | -122.3915155 | 100 | San Francisco |
SF-Switch 1 | 37.7826032 | -122.3915155 | 75 | San Francisco |
SEA-Server | 47.6169096 | -122.3298807 | 50 | Seattle |
CO-Server | 40.0287754 | -105.2489869 | 120 | Boulder |
TX-Switch | 33.0714171 | -96.825675 | 160 | Plano |
After uploading your CSV file, click Continue and complete the instructions in the side bar so that the Splunk App for AR can identify your assets and fill any blank fields:
- (Optional) Select the column header that contains the asset IDs. If you don't provide asset IDs, the Splunk App for AR generates them for you.
- (Optional) If you're using text recognition select the column header that contains the text strings.
- (Optional) If using a beacon, select the column header that contains the beacon UUID. Or to generate and use a single UUID, enter the value in the sidebar.
- Click Submit
The deployment appears in the Deployments tab. Splunk AR mobile users can now use your configured recognition method to view data associated with the asset.
Manage deployments
Your deployments available in the Deployments tab in the Splunk App for AR. This tab contains deployment information such as asset names, geofences, and beacons. Click a deployment to get details about the assets in it. Then click any assets to get deployment information about the specific asset.
Edit asset information
You can edit an asset name or ID in the Splunk App for AR.
- Navigate to the Deployments tab in the Splunk App for AR.
- Click a deployment to get details about the assets in it.
- Click the asset you want to change.
- Click the pen icon.
- Edit the name or ID.
Configure Splunk AR roles and permissions | Insert an asset ID, asset name, or workspace name as a form input in Splunk AR |
This documentation applies to the following versions of Splunk® App for Edge Hub and Augmented Reality: 4.4.0, 4.5.0, 4.6.0, 4.7.1, 4.8.0
Feedback submitted, thanks!