Configuring custom inventory

Custom inventory can be used to collect customer-configured data about assets and enter the data into the Miradore database. The custom inventory is performed by Miradore clients according to a script file, provided by the customer. The script file defines the data that should be collected from the managed assets and generates an output file which is automatically imported to Miradore after the custom inventory has been run successfully. The results of the custom inventory are shown on Asset custom inventory view and on the asset configuration item form at Inventory report > Custom inventory.

When an asset is removed from Miradore, the custom inventory data concerning the asset is automatically cleared.

Step-by-step guide to implementing custom inventory

Step

Task

How to...

Enable custom inventory

  1. Navigate to Administration > System settings > Main > Miradore features.

  2. Enable the "Custom inventory" feature.

Define data to be collected

  1. Go to System settings > Main > Custom inventory

  2. Define here the name, display name, and data type of the attributes that you wish to collect from the managed devices. An attribute is a single characteristic or property of an asset (e.g. Serial number).

  3. Define new classes and categorize the attributes into the classes. A class is a logical collection of attributes that are some how related to each other (e.g. Disk drive). For example, the "disk drive" class may consist of "serial number" and "disk size" attributes.    

Names of the attributes and classes are used to determine which attributes or classes are allowed when processing incoming custom inventory files.

Create a script for data collection

The easiest way to create a new custom inventory script is to copy the provided sample script from the support site of Miradore and customize it according to your needs.

Download the sample script from here:

https://support.miradore.com/WebSites/Authenticated/sp_Downloads.aspx?id=154

 

Notice

If the script generates an output file, the output file name must contain the device name of the computer that runs the scheduled task.

Upload and schedule the script to be executed

  1. Go to System settings > Clients > General.

  2. Create a new custom scheduled task from the "Custom scheduled tasks" table.

  3. Enter a name for the custom scheduled task item, configure the running interval of the task, and upload the script, that was made in step 3 as a task file to the scheduled tasks item in Miradore. Alternatively, you can write the script file directly to the editor that is shown on the task file popup window.

    The task file is the file which is performed by Miradore client when the custom inventory is ran.

    See Custom scheduled task item attributes for scheduled task item form field descriptions.

  4. Control the running of built-in scheduled tasks and custom scheduled tasks in assets with the help of scheduled task profile items. With the scheduled task profile items, it is possible to configure the running settings of the scheduled tasks on an asset level, or according to the device role, device usage, location, organisation, or subcategory of operating system that has been installed to the device.

    See scheduled task profile item attributes for more information.

Check data import results

  1. Go to System settings > System tasks and click "Show log" hyperlink on the task named "Import asset inventory information".

  2. Filter log rows by entering "custominv" to the Output column´s quick filter.

Examine custom inventory data

  1. Asset custom inventory view at Operations > Asset management > Inventory reports > Custom inventory on Miradore management console shows all data that has been gathered with the custom inventories.

  2. The data, gathered by the custom inventories is also displayed on the particular asset configuration item in Miradore. To see the data produced by the custom inventories, go to  Asset configuration item > Inventory report > Custom inventory.

See also

Custom inventory output file

How to clear inventory information

Related to

Inventory data and update intervals