VMware Cloud Foundation Operations Integration SDK

Welcome to the VMware Cloud Foundation (VCF) Operations Integration SDK.

What is the Integration SDK?

The Integration SDK creates Management Packs to add custom objects, data, and relationships from an endpoint into VCF Operations.

Using this SDK to create a Management Pack requires some Python or Java knowledge, and an understanding of how to get data from the endpoint using an API. For example, to create a Management Pack for Cassandra DB, an understanding of how to write an SQL query, execute it, and read the results is required.

For a high-level overview of VCF Operations, Management Packs, and this SDK, see the introduction.

What can the Integration SDK be used for?

The Integration SDK can be used to add any endpoint that supports remote monitoring to VCF Operations. Adding the endpoint involves creating objects that represent the endpoint, which may include properties, metrics, and events, as well as relationships between objects.

Remote monitoring uses an API (such as REST, SNMP, SQL, etc) to retrieve the data (as opposed to agent-based monitoring, where the monitoring code runs in the same location as the endpoint).

For an example walkthrough of creating a new Management Pack monitoring an endpoint, see Creating a New Management Pack

The Integration SDK can also be used to extend objects created by another Management Pack with additional metrics, properties, events, or relationships. This can be useful to ensure access to custom data without having to re-implement already existing data.

For an example walkthrough of the steps required to extend another management pack, see Extending an Existing Management Pack

Where should I start?

• If you want to get started creating your first Management Pack, or don't know where to start, read the Get Started tutorial, or jump to a specific section:
  • Requirements
  • Installation
  • Creating a Management Pack
  • Testing a Management Pack
  • Building and Installing a Management Pack
• If you have completed the Get Started tutorial, the Guides in our website have walk-throughs on how create a new management pack, extend an existing management pack and more.
• All documentation is available at https://vmware.github.io/vmware-vcf-operations-integration-sdk/sdk/latest/.

Contributing

The vmware-aria-operations-integration-sdk project team welcomes contributions from the community. Before you start working with this project please read and sign our Contributor License Agreement. If you wish to contribute code, and you have not signed our Contributor Licence Agreement (CLA), our bot will prompt you to do so when you open a Pull Request. For any questions about the CLA process, please refer to our FAQ.

For additional information about contributing, go to the contributing section

License

This project is licensed under the APACHE-2 License.