Creating a Custom Metric Family › Import a Custom Metric Family

Import a Custom Metric Family

To put your custom metric family into effect, import it into Data Aggregator.

CA Performance Center does not yet offer a user interface to support the import of a metric family that is based on the IMDBCertificationFacet.xsd schema directly. Therefore, leverage a web service that Data Aggregator exposes to accomplish this task.

Use any REST client. We recommend using the RESTClient with CA Performance Management. If you do not have it installed, you can get the RESTClient GUI JAR file from http://code.google.com/p/rest-client/.

When using the RESTClient, consider the following information:

• To launch it, double-click the JAR file.
• When you POST XML, make sure that the Charset is set to UTF-8.

  To view and verify this setting, click the Edit Content-Type & Charset button.

• You can also auto-indent the Response Body, as follows:
  1. Click Options on the Tools menu.
  2. Select the Etc. tab.
  3. Select Auto-indent Response Body and click OK.

Follow these steps:

1. Enter http://da-hostname:8581/typecatalog/metricfamilies as the URL.
2. Select POST as the Method.
3. Select 'application/xml' as the 'Body Content-type' in the Body settings.

   Important! Failing to set the Content-type results in a 404 error.

4. Copy and paste your custom metric family XML into the Body tab.
5. Run the method.

   Your custom metric family is imported. If no errors occur, the Status field in the HTTP Response section displays:

   HTTP/1.1 200 OK
   

   Note: Any other return code indicates that an error occurred while updating your custom metric family. Fix the error and retry updating the metric family by doing another POST.

   Important! To avoid possible data loss, always back up your deploy directory each time you create or update a vendor certification, metric family, or component.