Queries KairosDB for a metric's data over a relative time range (e.g. the last 24 hours).

Typical use cases:

• "Give me the CPU usage data for server web-01 over the last 7 days"

• "Show me the memory usage from last week"

Args:

• metric_name: Exact KairosDB metric name

• tags: Tag filters (e.g. {"host": ["web-01"]})

• range_value: Duration to look back (default: 24)

• range_unit: Unit (hours/days/weeks/..., default: hours)

• aggregator: Optional aggregation function (avg/min/max/sum/count)

• sampling_value / sampling_unit: Window size if aggregation is enabled

• limit: Max number of points (default: 1000, max: 10,000)

• response_format: "markdown" (default) or "json"

Returns: Timestamped data points with statistics (min/max/avg).

Queries KairosDB over a time range defined by precise ISO 8601 dates.

Use cases:

• "Server metrics between 2024-01-01 and 2024-01-31"

• "Analysis of a precise incident over a timestamped window"

Args:

• metric_name: Exact metric name

• tags: Tag filters

• start: Start (ISO 8601, e.g. 2024-01-15T00:00:00Z)

• end: End (ISO 8601, default: now)

• aggregator / sampling_value / sampling_unit: Optional aggregation

• limit: Max points (default 1000)

• response_format: "markdown" or "json"

Returns: Timestamped points with statistics.

Retrieves the most recent value of a metric (equivalent to a real-time reading).

Use cases:

• "What is the current CPU usage on server web-01?"

• "Latest reading from the request latency metric"

Args:

• metric_name: Exact metric name

• tags: Tag filters to target a specific host

• response_format: "markdown" or "json"

Returns: Latest known value with its timestamp.

Computes several aggregations (min, max, avg, etc.) in a single request over a relative time range.

Use cases:

• "Give me the min/max/avg CPU usage on server web-01 over the last 7 days, hourly"

• "Daily request latency statistics over the last 30 days"

Args:

• metric_name: Exact metric name

• tags: Tag filters

• range_value / range_unit: Time range (default: 24 hours)

• aggregators: List of functions (default: [avg, min, max])

• sampling_value / sampling_unit: Computation window (default: 1 hour)

• response_format: "markdown" or "json"

Returns: One series per aggregator with statistics.

Returns all metrics (host/service series names) stored in KairosDB.

Use cases:

• "Which metrics are available for the servers?"

• "List all metrics starting with 'server.'"

Args:

• prefix: Optional prefix filter (e.g. "server." to filter client-side)

• response_format: "markdown" or "json"

Returns: List of metric names.

Returns all known values for a given tag name.

Use cases:

• "What hosts are available?" → tag_name = "host"

• "What environments exist?" → tag_name = "environment"

Args:

• tag_name: Tag name (e.g. "host", "environment", "region")

• response_format: "markdown" or "json"

Returns: List of values for this tag.

Checks that the KairosDB server is reachable and operational.

Use cases:

• "Is KairosDB available?"

• Diagnosing a connection error

Returns: "ok" or "error" status with details.