Skip to content

Latest commit

 

History

History
76 lines (53 loc) · 3.19 KB

server.md

File metadata and controls

76 lines (53 loc) · 3.19 KB
Raw

Server

Tranquility Server lets you use Tranquility to send data to Druid without developing a JVM app. You only need an HTTP client. Tranquility Server is easy to set up: a single server process can handle multiple dataSources, and you can scale out by simply starting more server processes and putting them behind a load balancer or DNS round-robin.

HTTP API

You can send data through HTTP POST. You can send as little or as much data at once as you like. The form of the request should be:

  • URL /v1/post or /v1/post/DATASOURCE.
  • Content-Type application/json or application/x-jackson-smile.
  • JSON or Smile data matching the Content-Type you provided. If JSON, you can provide either an array of JSON objects or a sequence of newline-delimited JSON objects. If Smile, you should provide an array of objects.
  • If using the URL /v1/post, your objects must have a field named "dataSource" or "feed" containing the destination dataSource for that object.

The response will be:

{
  "result": {
    "received": 10,
    "sent": 10
  }
}

Where received is the number of messages you sent to the server, and sent is the number of messages that were successfully sent along to Druid. This may be fewer than the number of messages received if some of them were dropped due to e.g. being outside the windowPeriod.

This API is synchronous and will block until your messages are either sent to Druid, or have failed to send.

If there is an error sending the data, you will get an HTTP error code (4xx or 5xx).

Asynchronous option

Tranquility Server also offers an asynchronous option. Just add "?async=true" to the URL. Note that "sent" in the response will always be 0 when using the asynchronous option.

If the server's outgoing message queue fills up, your asynchronous requests will either block or fail. To control this behavior, set the tranquility.blockOnFull property to either true or false. If you set this to "false" and your server's outgoing queue is full, you will get an HTTP 503.

With both the synchronous and asynchronous modes, you can adjust the size of your Server's message queues through the properties tranquility.maxBatchSize and tranquility.maxPendingBatches.

Setup

Getting Tranquility Server

Tranquility Server is included in the downloadable distribution.

Configuration

Tranquility Server uses a standard Tranquility configuration file with some extra properties. There's an example file at conf/server.json.example of the tarball distribution. You can start off your installation by copying that file to conf/server.json and customizing it for your own setup.

These Server-specific properties, if used, must be specified at the global level:

Property Description Default
http.port Port to listen on. 8200
http.threads Number of threads for serving HTTP requests. 40
http.idleTimeout Abort connections that have had no activity for longer than this timeout. Set to zero to disable. ISO8601 duration. PT5M

Running

If you've saved your configuration into conf/server.json, run the server with:

bin/tranquility server -configFile conf/server.json