Developer's Guide

Send an event via Perl using RPC::XML::Client

require RPC::XML;
require RPC::XML::Client;

$serv = RPC::XML::Client->new('http://YOURZENOSS:8081/');
%evt = ('device' => 'mydevice2', 'component' => 'eth1',
        'summary' => 'eth1 is down', 'severity' => 4);
$args = RPC::XML::struct->new(%evt);
$serv->simple_request('sendEvent', $args);

This is an example of an Interactive Ruby (IRB) session (the returns have been omitted for the sake of clarity). Note, however, that the Ruby standard library is under active development in general, and specifically, the XML-RPC lib in Ruby is not stable. As of Feb 2007, there is a great deal of on-going discussion regarding XML-RPC in Ruby by Ruby developers and contributors. The following is known to work in previous versions of Ruby:

require "xmlrpc/client"
url='user:pass@http://YOURZENOSS:8080/zport/dmd/DeviceLoader')
server = XMLRPC::Client.new2( url )

evt = {'device' => 'mydevice3', 'component' => 'eth2',
      'summary' => 'eth2 is down', 'severity' => 4}
server.call('sendEvent', evt)

<?php

include("xmlrpc.inc");

function ifInOutBps($host, $port, $user, $pass, $device, $interface) {

    $ifInOctets = 'ifInOctets_ifInOctets';
    $ifOutOctets = 'ifOutOctets_ifOutOctets';

    # base url $url = '/zport/dmd/Devices';

    # message $msg = new xmlrpcmsg(

        $device.'.os.interfaces.'.$interface.'.getRRDValues', array());

    $xifInOctets = new xmlrpcVal($ifInOctets);
    $xifOutOctets = new xmlrpcVal($ifOutOctets);
    $xifOctets = new xmlrpcVal(array($xifInOctets, $xifOutOctets), 'array');
    $msg->addParam($xifOctets);

    # client $clt = new xmlrpc_client($url, $host, $port);
    # $clt->setCredentials($user, $pass);

    # get response $rsp = $clt->send($msg);

    # any error? if ($rsp->faultCode()) {

        die('ifInOutBps - Send error: '.$rsp->faultString().'

'); }

    # convert to data structure $dst = xmlrpc_decode($rsp->serialize());

    return(array('in'=>$dst[$ifInOctets]*8, 'out'=>$dst[$ifOutOctets]*8));

}

?>

This example uses the Apache XML-RPC library and Java 6 to send an event to the Zenoss server.

Required jars on the classpath (all available from the Apache download):

import java.net.URL;
import java.util.HashMap;

import org.apache.xmlrpc.client.XmlRpcClient;
import org.apache.xmlrpc.client.XmlRpcClientConfigImpl;

public class JavaRPCExample {

  public static void main(String[] args) throws Exception {
      XmlRpcClientConfigImpl config = new XmlRpcClientConfigImpl();
      url= "http://MYHOST:8080/zport/dmd/ZenEventManager"
      config.setServerURL(new URL(url));
      config.setBasicUserName("admin");
      config.setBasicPassword("zenoss");

      XmlRpcClient client = new XmlRpcClient();
      client.setConfig(config);

      HashMap<String,Object> params = new HashMap<String,Object>();

      params.put("device", "mydevice");
      params.put("component", "eth0");
      params.put("summary", "eth0 is down");
      params.put("severity", 4);
      params.put("eventClass", "/Net");

      client.execute("sendEvent", new Object[]{params});
  }
}