Stackstate-UCMDB Integration

The StackState agent can report topology exported from UCMDB as topology information to StackState. The integration is done by polling the XML file exported from UCMDB.

XML Input Format

The xml input is a standard UCMDB TQL output as in the example below:

<?xml version="1.0" encoding="UTF-8"?>
  <root>
    <data>
      <objects>
        <object operation="add" name="business_application" ucmdb_id="dab1..." id="UCMDB%0Abusiness_application%0A1%0Ainternal_id%3DSTRING%3Ddab1...%0A">
          <attribute name="display_label" datatype="STRING">procurement webapp</attribute>
          <attribute name="name" datatype="STRING">procurement webapp</attribute>
          <attribute name="global_id" datatype="STRING">dab1...</attribute>
          <attribute name="root_class" datatype="STRING">business_application</attribute>
        </object>
        <object operation="add" name="node" ucmdb_id="6c01..." id="UCMDB%0Abusiness_application%0A1%0Ainternal_id%3DSTRING%3D6c01...%0A">
          <attribute name="display_label" datatype="STRING">lnx150d</attribute>
          <attribute name="name" datatype="STRING">lnx150d</attribute>
          <attribute name="global_id" datatype="STRING">6c01...</attribute>
          <attribute name="root_class" datatype="STRING">node</attribute>
        </object>
      </objects>
      <links>
        <link name="usage" operation="add" ucmdb_id="a924...">
          <attribute name="DiscoveryID1">dab1...</attribute>
          <attribute name="DiscoveryID2">6c01...</attribute>
          <attribute name="end1Id">UCMDB%0ANode%0A1%0Ainternal_id%3DSTRING%3Ddab1...%0A</attribute>
          <attribute name="end2Id">UCMDB%0ANode%0A1%0Ainternal_id%3DSTRING%3D6c01...%0A</attribute>
          <attribute name="display_label" datatype="STRING">Usage</attribute>
        </link>
      </links>
    </data>
  </root>

Configuration

  1. Edit your conf.d/ucmdb_file.yaml file.
  2. Restart the agent

<%= insert_example_links(conf: “ucmdb_file”, check: “ucmdb_file”)%>