API Reference

Wiki ▸ API Reference

Collector

The Collector is a server that runs (by default) on port 1080.

• /1.0/event/put - post events.
• /collectd - receive events from collectd.

Evaluator

The Evaluator is a server that runs (by default) on port 1081.

• /1.0/event/get - query events.
• /1.0/metric/get - query metrics.
• /1.0/types/get - query known event types.

Events

Time-stamped events are how you get data into Cube. Later, you'll use them to compute metrics.

• event.type - a name for grouping related events (such as "request").
• event.time - the event time in ISO 8601 format, UTC.
• event.id - an optional unique identifier for replacing events.
• event.data - an optional JSON blob for storing additional data with events.

Metrics

• value.time - the metric value time in ISO 8601 format, UTC.
• value.value - the computed metric value; may be undefined with missing data.
• value.id - optional; a unique identifier for multiplexing metric requests.

Queries

• metric expression - an expression for computing metric values from grouped events.
• event expression - a subset of a metric expression for querying events.

Storage

Cube stores events in MongoDB. You can access that data directly, if you like.

• events - a collection for storing events.
• metrics - a (typically capped) collection for caching computed metrics.

Emitter

Cube provides a JavaScript WebSockets client for posting events to a collector.

• cube.emitter - construct a new emitter.
• emitter.open - connect to the Collector at the specified host and port.
• emitter.send - send a single event.
• emitter.close - close the connection, once all events have been sent.

Meta

• cube_request - a built-in event that records requests sent to Cube's endpoints.
• cube_compute - a built-in event that records information about Cube's work computing metric.