> ## 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.

# QueryLogsRange

> Logging



## OpenAPI

````yaml openapi/api_v1_data_openapi3_DOCUMENTATION_ONLY.json GET /api/v1/data/logs:range
openapi: 3.0.3
info:
  description: |

    The Data API provides HTTP/JSON REST endpoints for reading and writing data
    to the Chronosphere system.

    Use this link to download the raw Swagger specification:
    <a href="/api/v1/data/swagger.json">/api/v1/data/swagger.json</a>
  title: Data V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: DataV1
paths:
  /api/v1/data/logs:range:
    get:
      tags:
        - DataV1
      description: Logging
      operationId: QueryLogsRange
      parameters:
        - description: Specifies the query to run to filter logs.
          in: query
          name: query
          schema:
            type: string
        - description: >-
            Returns only log messages with a timestamp after this time. If
            omitted,

            defaults to the last 30 minutes.
          in: query
          name: time_range.after
          schema:
            format: date-time
            type: string
        - description: >-
            Returns only log messages with a timestamp before this time. If
            omitted,

            defaults to the last 30 minutes.
          in: query
          name: time_range.before
          schema:
            format: date-time
            type: string
        - description: |-
            Opaque page token identifying which page to request. An empty token
            identifies the first page.
          in: query
          name: page.token
          schema:
            type: string
        - description: When true, the query will include data from long-term storage.
          in: query
          name: include_long_term_storage
          schema:
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/datav1QueryLogsRangeResponse'
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googlerpcStatus'
          description: An unexpected error response.
components:
  schemas:
    datav1QueryLogsRangeResponse:
      properties:
        grid_data:
          allOf:
            - $ref: '#/components/schemas/QueryLogsRangeResponseGridData'
          description: Returns log query results as in tabular format.
        metadata:
          allOf:
            - $ref: '#/components/schemas/QueryLogsRangeResponseMetadata'
          description: The metadata of the query.
        time_series_data:
          allOf:
            - $ref: '#/components/schemas/QueryLogsRangeResponseTimeSeriesData'
          description: >-
            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.
      type: object
    googlerpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            $ref: '#/components/schemas/protobufAny'
          type: array
        message:
          type: string
      type: object
    QueryLogsRangeResponseGridData:
      properties:
        columns:
          description: >-
            Defines the structure and data types of columns in tabular log
            results.
          items:
            $ref: '#/components/schemas/QueryLogsRangeResponseColumnMeta'
          type: array
        rows:
          description: Defines the structure and data types of rows in tabular log results.
          items:
            $ref: '#/components/schemas/QueryLogsRangeResponseRow'
          type: array
      type: object
    QueryLogsRangeResponseMetadata:
      properties:
        limit_enforced:
          description: Indicates whether the result is truncated by the request limit.
          type: boolean
        page:
          allOf:
            - $ref: '#/components/schemas/QueryLogsRangeResponseMetadataPageResult'
          description: If set, there are more results to return.
      type: object
    QueryLogsRangeResponseTimeSeriesData:
      properties:
        group_by_dimension_names:
          description: Names of the dimensions to group results by.
          items:
            type: string
          type: array
        series:
          description: Specifies the time series to return from query results.
          items:
            $ref: '#/components/schemas/TimeSeriesDataTimeSeries'
          type: array
      type: object
    protobufAny:
      additionalProperties: {}
      properties:
        '@type':
          type: string
      type: object
    QueryLogsRangeResponseColumnMeta:
      properties:
        name:
          description: The column names to include in the tabular results.
          type: string
        type:
          $ref: '#/components/schemas/QueryLogsRangeResponseColumnMetaType'
      type: object
    QueryLogsRangeResponseRow:
      properties:
        values:
          description: >-
            Values to include that match each column type. Only one of the
            supported

            fields can be set depending on the type of value.
          items:
            $ref: '#/components/schemas/QueryLogsRangeResponseRowValue'
          type: array
      type: object
    QueryLogsRangeResponseMetadataPageResult:
      properties:
        next_token:
          description: |-
            Opaque page token that identifies the next page of items to request.
            An empty value indicates there are no more items to return.
          type: string
      type: object
    TimeSeriesDataTimeSeries:
      properties:
        aggregation_name:
          description: Name of the aggregation used to calculate the values.
          type: string
        buckets:
          description: >-
            Defines a time-bounded data point in a time series to store
            aggregated

            values over specific time intervals.
          items:
            $ref: '#/components/schemas/TimeSeriesBucket'
          type: array
        group_by_dimension_values:
          description: Values of the dimensions to group results by.
          items:
            type: string
          type: array
      type: object
    QueryLogsRangeResponseColumnMetaType:
      description: The data type to include in each column.
      enum:
        - BOOLEAN
        - FLOAT
        - STRING
      type: string
    QueryLogsRangeResponseRowValue:
      properties:
        bool_value:
          description: Indicates a boolean value.
          type: boolean
        float_value:
          description: Indicates a float value.
          format: double
          type: number
        string_value:
          description: Indicates a string value.
          type: string
      type: object
    TimeSeriesBucket:
      properties:
        end_time:
          description: The end time of the time range for this bucket.
          format: date-time
          type: string
        float_value:
          description: |-
            The aggregated value for the time period of this bucket.
            This value is nullable.
          format: double
          type: number
        start_time:
          description: The start time of the time range for this bucket.
          format: date-time
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````