Let Oomnitza be your single source of truth!
You'll get visibility of servers in your organization as data from vCenter is automatically transformed into consumable information and actionable insights.
Connect Oomnitza and vCenter in minutes
Get the information and the 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, including virtual machines, hosts, and data centers
- Configurable reports to share information assets with your colleagues and management
About the integration
The basic integration retrieves key information about the vCenter network, data center, VM, and host information.
The vCenter integration uses v6.5 - 7.0 of the APIs. These APIs will continue to be supported until further notice.
At the minimum, you need to be a member of both the SystemConfiguration.Administrators group and the built-in Read-Only group in the vCenter Single Sign-On domain to interact with the vCenter APIs. You will not be authorized to pull API information without the combined privileges provided by these groups.
Useful links
- vCenter REST APIs documentation
- For information on the deprecation of v6.5 - 7.0 APIs see WMWare Blog: vSphere 7 Update 2 - REST API Modernization
-
For a list of Groups in the vCenter Single Sign-On Domain see VMWare Docs: Groups in the vCenter Single Sign-On Domain
- For information on adding users to a group in the vCenter Single Sign-On Domain see VMWare Docs: Add vCenter Single Sign-On Users
- For troubleshooting permissions see VMWare Blog: Read-Only API User or LogicMonitor: VSphere API Troubleshooting
Before you start
To stream asset data from vCenter to Oomnitza, you must complete these tasks:
- Download the source code for the Oomnitza connector
- Generate a configuration file
- Edit the configuration file
Download the source code for the Oomnitza connector
-
In Oomnitza, click Configuration > Integrations and click Block view
- In the Basic section for Asset Integrations, click the VMware tile.
- Download the source code.
Learn more
On the Info page, click READ DOCUMENTATION and scroll down and click Getting started.
Generate a configuration file for the Oomnitza connector
To find out how to generate the configuration file, read the Connector Configs section in the Getting started document.
Edit the configuration file
You must modify the following sections in the configuration file:
- The Oomnitza section
- The vCenter settings
Before you edit the configuration file, you must retrieve the following information:
- Open the configuration file that you generated in edit mode.
- In the Oomnitza section, enter the URL of your Oomnitza instance and enter the API token that you generated in Oomnitza. For information on how to generate an API key in Oomnitza, refer to Creating an API Token.
Oomnitza configuration settings
[oomnitza]
url= https://<name_of_instance>.oomnitza.com line
api token = <my_Oomnitza_token> - In the vCenter section, make the following changes:
- Set enable to True.
- Enter the URL or host of your vCenter account. For example,
https://api_host - Enter the username and password of your vCenter account
vCenter settings
[vcenter]enable = True
url = https://api_host
username =administrator@vsphere.local
password = change-me - Delete the remaining information in the configuration file, as this relates to other vendors.
- Save your changes
Map vCenter fields to Oomnitza fields
To get the information that you need to manage your network devices, complete these actions:
- Click Configuration > Integrations.
- In the Basic section for Asset Integrations, click the VMWare tile.
- Click Mappings.
- Map the vCenter fields to the Oomnitza fields.
- Select a unique identifier such as the Virtual Machine Identifier as the sync key, which will synchronize the data that is streamed from vCenter to Oomnitza.
- Click FINISH.
Custom vCenter mappings
You can map the following fields to Oomnitza:
Boot Delay
Boot Device NIC
Boot Device Type
Boot EFI Legacy Boot
Boot Enter Setup Mode
Boot Network Protocol
Boot Retry
Boot Retry Delay
Boot Type
CPU Cores Per Socket
CPU Count
CPU Hot Add Enabled
CPU Hot Remove Enabled
Data Center
Guest Identity Family
Guest Identity Host Name
Guest Identity IP Address
Guest Identity Name
Guest OS
Hardware Upgrade Policy
Hardware Upgrade Status
Hardware Upgrade Version
Hardware Version
Host
Identity BIOS UUID
Identity Instance UUID
Identity Name
Instant Clone Frozen
Memory Hot Add Enabled
Memory Hot Add Increment Size (MiB)
Memory Hot Add Limit (MiB)
Memory Size (MiB)
Power State
VM Name
VM Tools Auto Update Supported
VM Tools Install Attempt Count
VM Tools Install Type
VM Tools Run State
VM Tools Upgrade Policy
VM Tools Version
VM Tools Version Number
VM Tools Version Status
Virtual Machine Identifier
Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.
Run the vCenter connector
To upload the network device 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 vcenter --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 vcenter
- Click Configuration > Integrations.
- In the Basic section for Asset Integrations, click the VMWare tile.
- Click SYNC SESSIONS and review the information that is uploaded.
Schedule
To find out how to schedule the VMWare 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.
Comments
0 comments
Please sign in to leave a comment.