Creating a basic integration for MunkiReport assets

Let Oomnitza be your single source of truth!

The MunkiReport asset load pulls a list of machines from MunkiReport into Oomnitza. 

You'll get complete visibility of your machine information as data from MunkiReport is automatically transformed into consumable information and actionable insights. 

Connect Oomnitza and MunkiReport in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key asset information
• Configurable reports to share information about assets and software with your colleagues and management such as corporate-wide reports that detail the distribution and status of the assets in your environment

Note on the MunkiReport basic integration

This integration is a local basic integration, which means that it needs to be managed on your local machine. You'll need to prepare your local environment beforehand, download the Oomnitza connector, update a configuration file, and push it to your Oomnitza instance. Finally, you'll need to manage the scheduling of your basic integration on your local machine (using tools such as Task Scheduler for example). 

Before you start

To stream data into Oomnitza, complete these tasks:

1. Review the system requirements. 
2. Download and install Python. Best practice is to create a virtual environment. A virtual environment is created on top of the existing Python installation and can be isolated from the packages in the base environment, so only those explicitly installed in the virtual environment are available.

Installing the connector

GitHub: Getting started

Download the source code for the Oomnitza connector

1. Log into Oomnitza.
2. Click Configuration > Integrations and click Block view
3. In the Basic section for Asset Integrations, click the MunkiReport tile.
4. Download the source code and place it in a directory, such as C:\oomnitza_connector 

You can also download the source code on the Oomnitza Connector page on GitHub.

Installing the requirements

In the directory you created (C:\oomnitza_connector), install the required Python dependencies stored in the requirements.txt file using pip install -r requirements.txt

Tip
Run pip install --upgrade pip before installing and use the new version of pip

Generate the configuration file

In the same directory, runpython connector.py generate-ini to generate theconfig.inifile. For further information read the Connector Configs section in the Getting started document.

Tip
Run python connector.py --help to see all available command line options.

Edit the configuration file

You must modify the following sections in the configuration file:

• The Oomnitza section
• The MunkiReport section

Before you edit the configuration file, you must retrieve the following information:   

Your Oomnitza token which can be created in Configuration > Security > API tokens

Your MunkiReport username and password

1. Open the configuration file that you generated in edit mode.
2. In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza. 
   

   Oomnitza configuration settings 
   [oomnitza]
url= https://<name_of_instance>.oomnitza.com 
api token = <my_Oomnitza_token> 

3. In the MunkiReport section, make the following changes:
   • Set enable to True.
   • Enter your MunkiReport URL
   • Enter your MunkiReport username
   • Enter your MunkiReport password
   • Supply additional columns in db_columnsto display more data

   MunkiReport settings 
   [munki_report]
enable = True
url = https://munki_report
username = administrator
password = change-me
db_columns = ["machine.serial_number", "machine.hostname, "machine.machine_desc","reportdata.timestamp","reportdata.console_user",
"machine.os_version","reportdata.remote_ip","munkireport.manifestname""]

4. You can delete all the other configurations you do not need from the list, i.e. Kace, Jasper etc.
5. Save your changes.

Map MunkiReport fields to Oomnitza fields

Map MunkiReport fields to Oomnitza fields to get the asset information that you need. For the field mapping, it is recommended to follow these steps:

1. Click Configuration > Integrations and click Block view
2. In the Basic section for Asset Integrations, click the MunkiReport tile.
3. Click Mappings.
4. Map the MunkiReport fields to the Oomnitza fields.  
5. Select the Serial Number as the sync key, which will synchronize the data that is streamed from MunkiReport to Oomnitza.
6. Click FINISH.

When your connector is uploaded to Oomnitza, it will use the mappings that you have configured.

Custom mappings

Console User
Hostname
Machine Description
Manifest Name
OS Version
Remote IP
Serial Number
Timestamp

Run the MunkiReport network devices connector

To upload the MunkiReport information to Oomnitza, run the connector.

Run the connector in test mode to ensure that the mapped information is uploaded to Oomnitza:

python connector.py upload munkireport --testmode

When you are confident that you are uploading the information that you mapped, run the connector again in normal mode:

python connector.py upload munkireport 

Getting your results

1. Click Configuration > Integrations and click Block view
2. In the Basic section for Asset Integrations, click the MunkiReport tile.
3. Click SYNC SESSIONS.
4. Go to the Assets page and review the information that is uploaded.

Schedule
To find out how to schedule the MunkiReport integration, contact Support or see Installing the connector

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your assets
• Configure custom reports about your assets 

See Getting started.