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>'
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.chronosphere.io/api/v1/data/logs:range"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("API-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://{tenant}.chronosphere.io/api/v1/data/logs:range")
  .header("API-Token", "<api-key>")
  .asString();
const options = {method: 'GET', headers: {'API-Token': '<api-key>'}};

fetch('https://{tenant}.chronosphere.io/api/v1/data/logs:range', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
import requests

url = "https://{tenant}.chronosphere.io/api/v1/data/logs:range"

headers = {"API-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "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>"
        ]
      }
    ]
  }
}
{
  "code": 123,
  "details": [
    {
      "@type": "<string>"
    }
  ],
  "message": "<string>"
}

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.