Skip to main content
GET
/
api
/
v1
/
data
/
logs:range
cURL
curl --request GET \
  --url https://{tenant}.chronosphere.io/api/v1/data/logs:range \
  --header 'API-Token: <api-key>'
{
  "grid_data": {
    "columns": [
      {
        "name": "<string>"
      }
    ],
    "rows": [
      {
        "values": [
          {
            "bool_value": true,
            "float_value": 123,
            "string_value": "<string>"
          }
        ]
      }
    ]
  },
  "metadata": {
    "limit_enforced": true,
    "page": {
      "next_token": "<string>"
    }
  },
  "time_series_data": {
    "group_by_dimension_names": [
      "<string>"
    ],
    "series": [
      {
        "aggregation_name": "<string>",
        "buckets": [
          {
            "end_time": "2023-11-07T05:31:56Z",
            "float_value": 123,
            "start_time": "2023-11-07T05:31:56Z"
          }
        ],
        "group_by_dimension_values": [
          "<string>"
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
API-Token
string
header
required

Chronosphere API token

Query Parameters

​
query
string

Specifies the query to run to filter logs.

​
time_range.after
string<date-time>

Returns only log messages with a timestamp after this time. If omitted, defaults to the last 30 minutes.

​
time_range.before
string<date-time>

Returns only log messages with a timestamp before this time. If omitted, defaults to the last 30 minutes.

​
page.token
string

Opaque page token identifying which page to request. An empty token identifies the first page.

​
include_long_term_storage
boolean

When true, the query will include data from long-term storage.

Response

A successful response.

​
grid_data
object

Returns log query results as in tabular format.

​
metadata
object

The metadata of the query.

​
time_series_data
object

Returns log query results as a time series chart. You can only return group_by_dimension_names or series, depending on the type of query a time series query is defined by using a make-series aggregation.