> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levelblue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding BlueApps to an Asset

|                       |           |              |             |             |
| --------------------- | --------- | ------------ | ----------- | ----------- |
| **Role Availability** | Read-Only | Investigator | **Analyst** | **Manager** |

USM Anywhere receives syslog log data from external data sources: devices, applications, or operation systems. If that data is not automatically matched with an BlueApp through hints (see [Data Sources: Auto Discovered or Not](/documentation/usm-anywhere/alienapps-guide/blueapps-data-sources#Auto)), you must manually associate the BlueApp with an asset in USM Anywhere. There are two methods for creating these associations:

* By assigning one or more assets to the BlueApp. See [Assign Assets to BlueApps](/documentation/usm-anywhere/alienapps-guide/blueapps-assign-assets) for details.
* By adding one or more BlueApps to the asset (this document).

You can use a combination of these methods to ensure that USM Anywhere can identify the correct BlueApps for the log data it receives from an asset.

<Info>
  Assigning an BlueApp to an asset disables the usage of hints for the logs coming from this asset; therefore, USM Anywhere only uses the assigned BlueApps to parse and normalize those logs.

  If you use a log-forwarding software (such as Splunk or Loggly) to send logs to USM Anywhere, LevelBlue recommends that you use at least two such forwarders: one forwarder for all the auto-discoverable BlueApps, and the other for the non-auto-discoverable BlueApps. In the latter case, you must create an asset in USM Anywhere to denote the forwarder and assign it to the non-auto-discoverable BlueApps. This ensures that USM Anywhere uses the correct BlueApp to parse your logs.
</Info>

Adding an BlueApp to an asset requires that you know what log data that the USM Anywhere Sensor receives from the asset and which BlueApp(s) are the best match for parsing and normalizing that data to produce meaningful events for your needs.

You can add an BlueApp on the Asset Details page. The Asset Details page provides access to all of the available information and tools for managing an individual asset. See [Asset Management](/documentation/usm-anywhere/user-guide/asset-management/asset-management) for more information about managing discovered assets in USM Anywhere.

**To add an BlueApp from the Asset Details page**

1. Go to **Environment > Assets**.

2. (Optional.) Use the **Search & Filters** option to filter the list and help you locate the asset you want.

   See [Searching Assets](/documentation/usm-anywhere/user-guide/asset-management/asset-administration/searching-for-assets) for more information.

3. Click the icon next to the asset name and then select **Full Details**.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/-bY1Wo2ZbXoIM88S/images/usm-anywhere/user-guide/assetsselect_thumb_0_60.webp?fit=max&auto=format&n=-bY1Wo2ZbXoIM88S&q=85&s=d13c392262c8a67e29d56cb62a6e293a" alt="" width="43" height="60" data-path="images/usm-anywhere/user-guide/assetsselect_thumb_0_60.webp" />
   </Frame>

   This displays the Asset Details.

4. At the bottom of the expanded page, select the BlueApps tab and click **Add BlueApp**.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/xZonsgZH8SxEQ1Gk/images/usm-anywhere/user-guide/add-alienapp_thumb_0_60.webp?fit=max&auto=format&n=xZonsgZH8SxEQ1Gk&q=85&s=367ddbe88a6c491b263d1f7bf8fbf006" alt="" width="340" height="60" data-path="images/usm-anywhere/user-guide/add-alienapp_thumb_0_60.webp" />
   </Frame>

5. In the dialog box, select the BlueApp you want to assign to the asset. Enter full or part of the name in the **Set a New BlueApp** field and select one from the displayed list.

   <Frame>
     <img src="https://mintcdn.com/levelblue-5324744e/xZonsgZH8SxEQ1Gk/images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp?fit=max&auto=format&n=xZonsgZH8SxEQ1Gk&q=85&s=448e0e5a4b8f001d43ebd663701aebe7" alt="" width="83" height="60" data-path="images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp" />
   </Frame>

   The system displays this message at the top of the page:

   BlueApp added successfully.

6. (Optional.) Repeat the previous step to add another BlueApp.

7. Click the <img src="https://mintcdn.com/levelblue-5324744e/jo1779yzvGjLisJx/images/usm-anywhere/close-thin.svg?fit=max&auto=format&n=jo1779yzvGjLisJx&q=85&s=9559f77128e397d6b3626597fba1834f" className="inline" width="24" height="24" data-path="images/usm-anywhere/close-thin.svg" /> icon to close the dialog box.

   On the BlueApps tab, you can see the list of BlueApps added.

<Accordion title="LevelBlue Generic Data Source Events">
  For logs where a matching BlueApp is not identified, USM Anywhere parses it using a [generic data source](/documentation/usm-anywhere/alienapps-guide/blueapps-data-sources#Fuzzy). You can review the generated events in the LevelBlue Generic Data Source events view. If the reporting device for the event is defined in the USM Anywhere asset inventory, you can manually assign an BlueApp directly from this view.

  See [LevelBlue Generic Data Source](/documentation/usm-anywhere/user-guide/events/av-generic-plugin) for more information about the information and tools available in this view.

  **To assign an BlueApp from a LevelBlue Generic Data Source event**

  1. Go to **Activity > Events**.

  2. Click **View > Saved views > LevelBlue Generic Data Source**.

  3. Click **Apply**.

  4. Review the listed events and locate an event where the reporting device is displayed in blue and you want to manually assign a known BlueApp to the asset.

  5. In the **Reporting Device** column, click the <img src="https://mintcdn.com/levelblue-5324744e/jo1779yzvGjLisJx/images/usm-anywhere/chevron-down.svg?fit=max&auto=format&n=jo1779yzvGjLisJx&q=85&s=49cdbebf7934499f2df552d32ed9aa74" className="inline" width="20" height="20" data-path="images/usm-anywhere/chevron-down.svg" /> icon next to the asset name and select **Assign BlueApp**.

       <Frame>
         <img src="https://mintcdn.com/levelblue-5324744e/LRsr4s1iGr_CM6ff/images/usm-anywhere/user-guide/reportingdevicecolumn_thumb_0_60.webp?fit=max&auto=format&n=LRsr4s1iGr_CM6ff&q=85&s=dee6ae561ee352c715cbb1225afe69ac" alt="" width="38" height="60" data-path="images/usm-anywhere/user-guide/reportingdevicecolumn_thumb_0_60.webp" />
       </Frame>

     The Add BlueApp to an asset dialog box opens.

       <Frame>
         <img src="https://mintcdn.com/levelblue-5324744e/xZonsgZH8SxEQ1Gk/images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp?fit=max&auto=format&n=xZonsgZH8SxEQ1Gk&q=85&s=448e0e5a4b8f001d43ebd663701aebe7" alt="" width="83" height="60" data-path="images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp" />
       </Frame>

  6. In the dialog box, select the BlueApp to use for log data from the asset.

     Enter part of the BlueApp name in the **Set a New BlueApp** field and select the BlueApp from the displayed list.

       <Frame>
         <img src="https://mintcdn.com/levelblue-5324744e/xZonsgZH8SxEQ1Gk/images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp?fit=max&auto=format&n=xZonsgZH8SxEQ1Gk&q=85&s=448e0e5a4b8f001d43ebd663701aebe7" alt="" width="83" height="60" data-path="images/usm-anywhere/user-guide/addalienappasset_thumb_0_60.webp" />
       </Frame>

  7. (Optional.) Repeat the previous step to add another BlueApp for the asset.

  8. Click the <img src="https://mintcdn.com/levelblue-5324744e/jo1779yzvGjLisJx/images/usm-anywhere/close-thin.svg?fit=max&auto=format&n=jo1779yzvGjLisJx&q=85&s=9559f77128e397d6b3626597fba1834f" className="inline" width="24" height="24" data-path="images/usm-anywhere/close-thin.svg" /> icon to close the dialog box.
</Accordion>
