NAME

WWW::Splunk::API - Splunk REST client

DESCRIPTION

WWW::Splunk::API is a low-level interface to Splunk log search engine. It deals with HTTP communication as well as working around certain interface glitches.

See http://www.splunk.com/base/Documentation/latest/Developer/RESTSearch for API definition.

This module is designed to be Splunk API version agnostic.

Please consider this an alpha quality code, whose API can change at any time, until we reach version 2.0. There are known glitches in the code quality now. Remember the code is the best documentation for now.

new (params)

A constructor.

  my $splunk = new WWW::Splunk::API ({
          host    => $host,
          port    => $port,
          login   => $login,
          password => $password,
          unsafe_ssl => 0,
  });

delete (parameters)

Wrapper around HTTP::Request::Common::DELETE ().

post (parameters)

Wrapper around HTTP::Request::Common::POST ().

get (parameters)

Wrapper around HTTP::Request::Common::GET ().

head (parameters)

Wrapper around HTTP::Request::Common::HEAD (). Not used anywhere in splunk API

put (parameters)

Wrapper around HTTP::Request::Common::PUT (). Not used anywhere in splunk API

request (method, location, [data], [callback])

Request a Splunk api and deal with the results.

Method can be either a HTTP::Request instance (see HTTP::Request::Common for useful ones), or a plain string, such as "GET" or "DELETE."

Optional data is has reference gets serialized into a request body for POST request. Use undef in case you don't have any data to send, but need to specify a callback function in subsequent argument.

Call-back function can be specified for a single special case, where a XML stream of <results> elements is expected.

SEE ALSO

WWW::Splunk, sc

AUTHORS

Lubomir Rintel, <lkundrak@v3.sk>

The code is hosted on GitHub http://github.com/lkundrak/perl-WWW-Splunk. Bug fixes and feature enhancements are always welcome.