API-proposed.yaml

###############################################################################
# Copyright (c) 2018, 2024 Ericsson
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
###############################################################################
openapi: 3.0.1
info:
  title: Trace Server Protocol
  description: "Open source REST API for viewing and analyzing any type of logs or\
    \ traces. Its goal is to provide models to populate views, graphs, metrics, and\
    \ more to help extract useful information from traces, in a way that is more user-friendly\
    \ and informative than huge text dumps."
  termsOfService: https://www.eclipse.org/tracecompass/
  contact:
    email: tracecompass-dev@eclipse.org
  license:
    name: Apache 2
    url: http://www.apache.org/licenses/
  version: 0.2.0
servers:
- url: https://localhost:8080/tsp/api
tags:
- name: Annotations
  description: Retrieve annotations for different outputs.
- name: Configurations
  description: Manage configuration source types and configurations.
- name: Diagnostic
  description: Retrieve the server's status.
- name: Data Tree
  description: Query data tree models (e.g. for statistics).
- name: Experiments
  description: "Manage experiments on your server; an experiment represents a collection\
    \ of traces, which can produce output models."
- name: Identifier
  description: Retrieve information about the server and the system it is running
    on.
- name: Output Configurations
  description: Manage configuration source types and configurations for given outputs.
- name: Styles
  description: Retrieve styles for different outputs.
- name: TimeGraph
  description: Query Time Graph models.
- name: Traces
  description: Manage physical traces on your server.
- name: Virtual Tables
  description: Query virtual table models (e.g. Events Table).
- name: XY
  description: Query XY chart models.
- name: Bookmarks
  description: How to bookmark areas of interest in the trace.
- name: Filters
  description: How to filter and query.
- name: Features
  description: Discover the features which are available on a given server.
- name: Symbols
  description: Learn how to provide symbol providers.
paths:
  /config/types/{typeId}/configs/{configId}:
    get:
      tags:
      - Configurations
      summary: Get a configuration instance of a given configuration source type
      operationId: getConfiguration
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      - name: configId
        in: path
        description: The configuration instance ID
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Get a configuration instance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Configuration'
        "404":
          description: No such configuration source type or configuration instance
          content:
            application/json:
              schema:
                type: string
    put:
      tags:
      - Configurations
      summary: Update a configuration instance of a given configuration source type
      operationId: putConfiguration
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      - name: configId
        in: path
        description: The configuration instance ID
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to update a configuration instance. Provide
          all query parameter keys and values as specified in the corresponding configuration
          source type.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigurationQueryParameters'
            example:
              name: test.xml
              description: Configuration with test.xml
              parameters:
                path: /home/user/test.xml
        required: true
      responses:
        "200":
          description: The configuration instance was successfully updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Configuration'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: No such configuration source type or configuration instance
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Internal trace-server error while trying to update configuration
            instance
          content:
            application/json:
              schema:
                type: string
    delete:
      tags:
      - Configurations
      summary: Delete a configuration instance of a given configuration source type
      operationId: deleteConfiguration
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      - name: configId
        in: path
        description: The configuration instance ID
        required: true
        schema:
          type: string
      responses:
        "200":
          description: The configuration instance was successfully deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Configuration'
        "404":
          description: No such configuration source type or configuration instance
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Internal trace-server error while trying to delete configuration
            instance
          content:
            application/json:
              schema:
                type: string
  /config/types/{typeId}:
    get:
      tags:
      - Configurations
      summary: Get a single configuration source type defined on the server
      operationId: getConfigurationType
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Returns a single configuration source type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigurationSourceType'
  /config/types:
    get:
      tags:
      - Configurations
      summary: Get the list of configuration source types defined on the server
      operationId: getConfigurationTypes
      responses:
        "200":
          description: Returns a list of configuration source types
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConfigurationSourceType'
  /config/types/{typeId}/configs:
    get:
      tags:
      - Configurations
      summary: Get the list of configurations that are instantiated of a given configuration
        source type
      operationId: getConfigurations
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      responses:
        "200":
          description: 'Get the list of configuration descriptors '
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Configuration'
        "404":
          description: No such configuration source type or configuration instance
          content:
            application/json:
              schema:
                type: string
    post:
      tags:
      - Configurations
      summary: Create a configuration instance for the given configuration source
        type
      operationId: postConfiguration
      parameters:
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to create a configuration instance. Provide
          all query parameter keys and values as specified in the corresponding configuration
          source type.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConfigurationQueryParameters'
            example:
              name: test.xml
              description: Configuration with test.xml
              parameters:
                path: /home/user/test.xml
        required: true
      responses:
        "200":
          description: The configuration instance was successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Configuration'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: No such configuration source type or configuration instance
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Internal trace-server error while trying to create configuration
            instance
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}:
    get:
      tags:
      - Experiments
      summary: Get the output descriptor for this experiment and output
      operationId: getProvider
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Returns the output provider descriptor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataProvider'
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
    post:
      tags:
      - Output Configurations
      summary: Get a derived data provider from a input configuration
      operationId: createProvider
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to create a derived output from
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to create a configuration instance. Provide
          all query parameter keys and values as specified in the corresponding configuration
          source type.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OutputConfigurationQueryParameters'
            example:
              name: Follow My-thread
              description: My-thread on even CPUs
              typeId: my.config.source.type.id
              parameters:
                threads: My-thread
                cpus:
                - 0
                - 2
                - 4
                - 6
        required: true
      responses:
        "200":
          description: Returns the derived data provider descriptor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataProvider'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: "Experiment, output provider or configuration type not found"
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}/{derivedOutputId}:
    delete:
      tags:
      - Output Configurations
      summary: Delete a derived output (and its configuration).
      operationId: deleteDerivedProvider
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the parent output provider
        required: true
        schema:
          type: string
      - name: derivedOutputId
        in: path
        description: ID of the derived output provider
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Returns the deleted derived data provider descriptor. The derived
            data provider (and its configuration) was successfully deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataProvider'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: "Experiment, output provider or configuration type not found"
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}/annotations:
    get:
      tags:
      - Annotations
      summary: API to get annotation categories associated to this experiment and
        output
      operationId: getAnnotationCategories
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      - name: markerSetId
        in: query
        description: The optional requested marker set's id
        schema:
          type: string
      responses:
        "200":
          description: Annotation categories
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnotationCategoriesResponse'
        "400":
          description: Missing parameter outputId
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
    post:
      tags:
      - Annotations
      summary: API to get the annotations associated to this experiment and output
      operationId: getAnnotations
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: "Query parameters to fetch the annotations. The object 'requested_timerange'\
          \ is the requested time range and number of samples. The array 'requested_items'\
          \ is the list of entryId being requested. The string 'requested_marker_set'\
          \ is the optional requested marker set's id. The array 'requested_marker_categories'\
          \ is the list of requested annotation categories; if absent, all annotations\
          \ are returned."
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnnotationsQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
                  nbTimes: 1920
                requested_items:
                - 1
                - 2
                requested_marker_set: markerSetId
                requested_marker_categories:
                - category1
                - category2
        required: true
      responses:
        "200":
          description: Annotation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnotationResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/timeGraph/{outputId}/arrows:
    post:
      tags:
      - TimeGraph
      summary: API to get the Time Graph arrows
      description: "Unique entry point for all TimeGraph models, ensures that the\
        \ same template is followed for all models"
      operationId: getArrows
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the timegraph arrows. The object 'requested_timerange'
          is the requested time range and number of samples.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ArrowsQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
                  nbTimes: 1920
        required: true
      responses:
        "200":
          description: Returns a sampled list of TimeGraph arrows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeGraphArrowsResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/table/{outputId}/columns:
    post:
      tags:
      - Virtual Tables
      summary: API to get table columns
      description: "Unique entry point for output providers, to get the column entries"
      operationId: getColumns
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the table columns
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OptionalQueryParameters'
            example:
              parameters: {}
        required: true
      responses:
        "200":
          description: Returns a list of table headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TableColumnHeadersResponse'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}/configTypes/{typeId}:
    get:
      tags:
      - Output Configurations
      summary: Get a single configuration source type defined on the server for a
        given data provider and experiment.
      operationId: getConfigurationType_1
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      - name: typeId
        in: path
        description: The configuration source type ID
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Returns a single configuration source type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigurationSourceType'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: "Experiment, output provider or configuration type not found"
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}/configTypes:
    get:
      tags:
      - Output Configurations
      summary: Get the list of configuration types defined on the server for a given
        output and experiment
      operationId: getConfigurationTypes_1
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      responses:
        "200":
          description: Returns a list of configuration types that this output supports.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConfigurationSourceType'
        "404":
          description: "Experiment, output provider or configuration type not found"
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/data/{outputId}/tree:
    post:
      tags:
      - Data Tree
      summary: API to get the data tree
      description: "Unique entry point for output providers, to get the tree of visible\
        \ entries"
      operationId: getDataTree
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the data tree entries. The object 'requested_timerange'
          specifies the requested time range. When absent the tree for the full range
          is returned.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TreeQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
        required: true
      responses:
        "200":
          description: "Returns a list of data tree entries. The returned model must\
            \ be consistent, parentIds must refer to a parent which exists in the\
            \ model."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XYTreeResponse'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/table/{outputId}/lines:
    post:
      tags:
      - Virtual Tables
      summary: API to get virtual table lines
      operationId: getLines
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: "Query parameters to fetch the table lines. One of 'requested_table_index'\
          \ or 'requested_times' should be present. If 'requested_table_index' is\
          \ used it is the starting index of the lines to be returned. If 'requested_times'\
          \ is used it should contain an array with a single timestamp. The returned\
          \ lines starting at the given timestamp (or the nearest following) will\
          \ be returned. The 'requested_table_count' is the number of lines that should\
          \ be returned. When 'requested_table_column_ids' is absent all columns are\
          \ returned. When present it is the array of requested columnIds. Use 'table_search_expressions'\
          \ for search providing a map of <columnId, regular expression>. Returned\
          \ lines that match the search expression will be tagged. Use 'table_search_direction'\
          \ to specify search direction [NEXT, PREVIOUS]. If present, 'requested_table_count'\
          \ events are returned starting from the first matching event. Matching and\
          \ not matching events are returned. Matching events will be tagged. If no\
          \ matches are found, an empty list will be returned."
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinesQueryParameters'
            example:
              parameters:
                requested_table_index: 0
                requested_table_count: 100
                requested_table_column_ids:
                - 0
                - 1
                - 2
                table_search_expressions:
                  "1": cpu.*
                table_search_direction: NEXT
        required: true
      responses:
        "200":
          description: Returns a table model with a 2D array of strings and metadata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VirtualTableResponse'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Error reading the experiment
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/markerSets:
    get:
      tags:
      - Annotations
      summary: API to get marker sets available for this experiment
      operationId: getMarkerSets
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: List of marker sets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarkerSetsResponse'
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs:
    get:
      tags:
      - Experiments
      summary: Get the list of outputs for this experiment
      operationId: getProviders
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: Returns a list of output provider descriptors
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/DataProvider'
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/timeGraph/{outputId}/states:
    post:
      tags:
      - TimeGraph
      summary: API to get the Time Graph states
      description: "Unique entry point for all TimeGraph states, ensures that the\
        \ same template is followed for all views"
      operationId: getStates
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: "Query parameters to fetch the timegraph states. The object 'requested_timerange'\
          \ is the requested time range and number of samples. The array 'requested_items'\
          \ is the list of entryId being requested. The object 'filter_query_parameters'\
          \ contains requests for search/filter queries. The object 'filter_expressions_map'\
          \ is the list of query requests, where the key 1 is DIMMED and 4 is EXCLUDED,\
          \ and the value is an array of the desired search query ('thread=1' or 'process=ls'\
          \ or 'duration>10ms'). The 'strategy' flag is an optional parameter within\
          \ 'filter_query_parameters', and if omitted then 'SAMPLED' search would\
          \ be the default value. If 'strategy' is set to 'DEEP' then the full time\
          \ range between the first and last requested timestamp should be searched\
          \ for filter matches. For timegraphs, only one matching state per gap in\
          \ requested timestamps needs to be returned in the response. If matches\
          \ to the queries from the 'filter_expressions_map' are found there'll be\
          \ a field 'tags' in 'states'. The TimeGraphState class has a bit-mask called\
          \ tags. If a state is supposed to be dimmed the tag will be the corresponding\
          \ bit set."
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestedQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
                  nbTimes: 1920
                requested_items:
                - 1
                - 2
                filter_query_parameters:
                  strategy: SAMPLED
                  filter_expressions_map:
                    "1":
                    - openat
                    - duration>10ms
        required: true
      responses:
        "200":
          description: Returns a list of time graph rows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeGraphStatesResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/{outputId}/style:
    post:
      tags:
      - Styles
      summary: API to get the style map associated to this experiment and output
      operationId: getStyles
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the style map
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OptionalQueryParameters'
            example:
              parameters: {}
        required: true
      responses:
        "200":
          description: Style model that can be used jointly with OutputElementStyle
            to retrieve specific style values
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StylesResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/timeGraph/{outputId}/tooltip:
    post:
      tags:
      - TimeGraph
      summary: API to get a Time Graph tooltip
      description: Endpoint to retrieve tooltips for time graph
      operationId: getTimeGraphTooltip
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the timegraph tooltip. The array 'requested_times'
          is an array with a single timestamp. The array 'requested_items' is an array
          with a single entryId being requested.  The object 'requested_element' is
          the element for which the tooltip is requested.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TooltipQueryParameters'
            example:
              parameters:
                requested_times:
                - 111200000
                requested_items:
                - 1
                requested_element:
                  elementType: state
                  time: 111100000
                  duration: 100000
        required: true
      responses:
        "200":
          description: Returns a list of tooltip keys to values
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeGraphTooltipResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/timeGraph/{outputId}/tree:
    post:
      tags:
      - TimeGraph
      summary: API to get the Time Graph tree
      description: "Unique entry point for output providers, to get the tree of visible\
        \ entries"
      operationId: getTimeGraphTree
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the timegraph tree. The object 'requested_timerange'
          specifies the requested time range. When absent the tree for the full range
          is returned.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TreeQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
        required: true
      responses:
        "200":
          description: "Returns a list of Time Graph entries. The returned model must\
            \ be consistent, parentIds must refer to a parent which exists in the\
            \ model."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimeGraphTreeResponse'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/XY/{outputId}/xy:
    post:
      tags:
      - XY
      summary: API to get the XY model
      description: "Unique endpoint for all xy models, ensures that the same template\
        \ is followed for all endpoints."
      operationId: getXY
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the XY model. The object 'requested_timerange'
          is the requested time range and number of samples. The array 'requested_items'
          is the list of entryId or seriesId being requested.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestedQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
                  nbTimes: 1920
                requested_items:
                - 1
                - 2
        required: true
      responses:
        "200":
          description: Return the queried XYResponse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XYResponse'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/XY/{outputId}/tree:
    post:
      tags:
      - XY
      summary: API to get the XY tree
      description: "Unique entry point for output providers, to get the tree of visible\
        \ entries"
      operationId: getXYTree
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      - name: outputId
        in: path
        description: ID of the output provider to query
        required: true
        schema:
          type: string
      requestBody:
        description: Query parameters to fetch the XY tree. The object 'requested_timerange'
          specifies the requested time range. When absent the tree for the full range
          is returned.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TreeQueryParameters'
            example:
              parameters:
                requested_timerange:
                  start: 111111111
                  end: 222222222
        required: true
      responses:
        "200":
          description: "Returns a list of XY entries. The returned model must be consistent,\
            \ parentIds must refer to a parent which exists in the model."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XYTreeResponse'
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
        "405":
          description: Analysis cannot run
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}:
    get:
      tags:
      - Experiments
      summary: Get the model object for an experiment
      operationId: getExperiment
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: Return the experiment model
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Experiment'
        "404":
          description: No such experiment
          content:
            application/json:
              schema:
                type: string
    delete:
      tags:
      - Experiments
      summary: Remove an experiment from the server
      operationId: deleteExperiment
      parameters:
      - name: expUUID
        in: path
        description: UUID of the experiment to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: "The trace was successfully deleted, return the deleted experiment."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Experiment'
        "404":
          description: No such experiment
          content:
            application/json:
              schema:
                type: string
    put:
      summary: Update an experiment's content and name.
      operationId: putExperiment
      tags:
        - Experiments
      parameters:
        - name: expUUID
          in: path
          description: UUID of the experiment to modify
          required: true
          schema:
            type: string
            format: uuid
        - name: name
          in: query
          description: The name to give this experiment
          required: true
          schema:
            type: string
      requestBody:
        description: Additional information to update an experiment
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                expTypeID:
                  description: Type ID to apply to this experiment
                  type: string
                traces:
                  description: Traces to modify in this experiment
                  type: array
                  items:
                    type: object
                    properties:
                      traceUUID:
                        description: The unique identifier of the trace
                        type: string
                        format: uuid
                      timeOffset:
                        description: Time offset to apply to this trace
                        type: integer
                        format: int64
                      action:
                        description: Action to perform on the given trace (add or remove from the experiment)
                        type: string
                        enum: [add, remove]
                        default: add
                    required:
                      - traceUUID
                      - action
      responses:
        200:
          description: The Experiment was successfully modified
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Experiment"
  /experiments:
    get:
      tags:
      - Experiments
      summary: Get the list of experiments on the server
      operationId: getExperiments
      responses:
        "200":
          description: Returns a list of experiments
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Experiment'
    post:
      tags:
      - Experiments
      summary: Create a new experiment on the server
      operationId: postExperiment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExperimentQueryParameters'
        required: true
      responses:
        "200":
          description: The experiment was successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Experiment'
        "204":
          description: The experiment has at least one trace which hasn't been created
            yet
          content:
            application/json:
              schema:
                type: string
        "400":
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: string
        "409":
          description: The experiment (name) already exists and both differ
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Internal trace-server error while trying to post experiment
          content:
            application/json:
              schema:
                type: string
  /health:
    get:
      tags:
      - Diagnostic
      summary: Get the health status of this server
      operationId: getHealthStatus
      responses:
        "200":
          description: The trace server is running and ready to receive requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerStatus'
        "503":
          description: The trace server is unavailable or in maintenance and cannot
            receive requests
  /identifier:
    get:
      tags:
      - Identifier
      summary: Retrieves system and server information
      operationId: getSystemInfo
      responses:
        "200":
          description: Successfully retrieved the system and server information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerInfoResponse'
  /traces/{uuid}:
    get:
      tags:
      - Traces
      summary: Get the model object for a trace
      operationId: getTrace
      parameters:
      - name: uuid
        in: path
        description: UUID of the trace to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: Return the trace model
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trace'
        "404":
          description: No such trace
          content:
            application/json:
              schema:
                type: string
    delete:
      tags:
      - Traces
      summary: Remove a trace from the server and disk
      operationId: deleteTrace
      parameters:
      - name: uuid
        in: path
        description: UUID of the trace to query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        "200":
          description: The trace was successfully deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trace'
        "404":
          description: No such trace
          content:
            application/json:
              schema:
                type: string
        "409":
          description: The trace is in use by at least one experiment thus cannot
            be deleted
          content:
            application/json:
              schema:
                type: string
  /traces:
    get:
      tags:
      - Traces
      summary: Get the list of physical traces imported on the server
      operationId: getTraces
      responses:
        "200":
          description: Returns a list of traces
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Trace'
    post:
      tags:
      - Traces
      summary: Import a trace
      description: Import a trace to the trace server. Return some base information
        once imported.
      operationId: putTrace
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TraceQueryParameters'
        required: true
      responses:
        "200":
          description: The trace has been successfully added to the trace server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trace'
        "400":
          description: Missing query parameters
          content:
            application/json:
              schema:
                type: string
        "404":
          description: No such trace
          content:
            application/json:
              schema:
                type: string
        "406":
          description: Cannot read this trace type
          content:
            application/json:
              schema:
                type: string
        "409":
          description: There was already a trace with this name
          content:
            application/json:
              schema:
                type: string
        "500":
          description: Trace resource creation failed
          content:
            application/json:
              schema:
                type: string
        "501":
          description: Trace type not supported
          content:
            application/json:
              schema:
                type: string
  /about/traceTypes:
    get:
      summary: Get the list of trace types supported by this server.
      operationId: getTraceTypes
      tags:
        - Features
      responses:
        200:
          description: List of the trace types supported by this server.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    ID:
                      description: The unique identifier for this trace type
                      type: string
                    description:
                      description: Human readable description of this trace type
                      type: string
                    versions:
                      description: List supported versions
                      type: array
                      items:
                        type: string
  /about/outputTypes:
    get:
      summary: Get the list of outputs supported by this server.
      tags:
        - Features
      responses:
        200:
          description: List of the output types supported by this server.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    ID:
                      description: The unique identifier for this output provider type
                      type: string
                    description:
                      description: Human readable description of this output type
                      type: string
                    versions:
                      description: List supported versions
                      type: array
                      items:
                        type: string
  /filters:
    get:
      summary: Get the list of filters available.
      operationId: getFilters
      tags:
        - Filters
      responses:
        200:
          description: List of filters available.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Filter"
    post:
      summary: Create a new filter.
      operationId: addFilter
      tags:
        - Filters
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Human readable label for this filter
                  type: string
                start:
                  description: start time for this filter
                  type: integer
                  format: int64
                end:
                  description: end time for this filter
                  type: integer
                  format: int64
                filterExpression:
                  description: expression from the filter language
                  type: string
                tags:
                  description: Desired tags to apply when an elements pass the filter
                  type: integer
                  format: int32
              required:
                - start
                - end
                - filterExpression
      responses:
        200:
          description: Created filter
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Filter"
  /filters/{filterID}:
    get:
      summary: Get the filter with the given ID.
      operationId: getFilter
      tags:
        - Filters
      parameters:
        - name: filterID
          description: Filter ID
          in: path
          required: true
          schema:
            type: integer
            format: int32
      responses:
        200:
          description: The filter
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Filter"
    put:
      summary: Update the given filter.
      operationId: updateFilter
      tags:
        - Filters
      parameters:
        - name: filterID
          description: Filter ID
          in: path
          required: true
          schema:
            type: integer
            format: int32
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Human readable label for this filter
                  type: string
                start:
                  description: start time for this filter
                  type: integer
                  format: int64
                end:
                  description: end time for this filter
                  type: integer
                  format: int64
                filterExpression:
                  description: expression from the filter language
                  type: string
                tags:
                  description: Desired tags to apply when an elements pass the filter
                  type: integer
                  format: int32
      responses:
        200:
          description: The filter
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Filter"
    delete:
      summary: Delete the given filter
      operationId: deleteFilter
      tags:
        - Filters
      parameters:
        - name: filterID
          description: Filter ID
          in: path
          required: true
          schema:
            type: integer
            format: int32
      responses:
        200:
          description: The deleted filter
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Filter"
        204:
          description: There was no filter with this ID to delete
  /symbols/{hostID}/{PID}:
    post:
      tags:
        - Symbols
      summary: Import/Upload a symbol provider.
      operationId: addSymbolProvider
      parameters:
        - name: hostID
          in: path
          description: Host ID for the symbol provider
          required: true
          schema:
            type: string
        - name: PID
          in: path
          description: PID for the symbol provider
          required: true
          schema:
            type: string
      requestBody:
        description: URL to the symbol provider, not required if the symbol provider is uploaded directly to the endpoint.
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  description: URL to the symbol provider, not required if the symbol provider is uploaded directly to the endpoint.
                  type: string
      responses:
        200:
          description: The symbol provider has been successfully added to the trace server.
        406:
          description: "Not acceptable: cannot read this symbol provider type"
    get:
      tags:
        - Symbols
      summary: Gets the symbol providers
      operationId: getSymbols
      parameters:
        - name: hostID
          in: path
          description: The host's ID
          required: true
          schema:
            type: string
        - name: PID
          in: path
          description: Process ID
          required: true
          schema:
            type: string
      responses:
        200:
          description: Returns the Symbol providers for this query.
        404:
          description: No such Host, Thread and address combination.
  /experiments/{expUUID}/bookmarks:
    get:
      summary: Get the collection of bookmarks for an experiment.
      operationId: getExperimentBookmarks
      tags:
        - Bookmarks
      parameters:
        - name: expUUID
          in: path
          description: The UUID of the experiment in the server
          required: true
          schema:
            type: string
            format: uuid
      responses:
        200:
          description: Returns a list of bookmarks for this trace
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Bookmark"
        404:
          description: No such experiment
          content:
            application/json:
              schema:
                type: string
    post:
      summary: Add a bookmark to an experiment.
      operationId: postExperimentBookmark
      tags:
        - Bookmarks
      parameters:
        - name: expUUID
          in: path
          description: The UUID of the experiment in the server
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        description: The bookmark to post
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Bookmark"
      responses:
        200:
          description: Returns the bookmark's Id
          content:
            application/json:
              schema:
                type: integer
        404:
          description: No such trace
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/bookmarks/{bookmarkId}:
    get:
      summary: Get a specific bookmark from this experiment
      operationId: getExperimentBookmark
      tags:
        - Bookmarks
      parameters:
        - name: expUUID
          in: path
          description: The UUID of the experiment in the server
          required: true
          schema:
            type: string
            format: uuid
        - name: bookmarkId
          in: path
          description: The unique identifier of the bookmark to get
          required: true
          schema:
            type: string
            format: uuid
      responses:
        200:
          description: Returns the queried bookmark
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Bookmark"
        404:
          description: No such experiment / No such bookmark
          content:
            application/json:
              schema:
                type: string
    put:
      summary: Modify a bookmark
      operationId: putExperimentBookmark
      tags:
        - Bookmarks
      parameters:
        - name: expUUID
          in: path
          description: The UUID of the experiment in the server
          required: true
          schema:
            type: string
            format: uuid
        - name: bookmarkId
          in: path
          description: The unique identifier of the bookmark to modify
          required: true
          schema:
            type: string
      requestBody:
        description: The bookmark to update
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Bookmark"
      responses:
        200:
          description: Returns the bookmark's Id
          content:
            application/json:
              schema:
                type: integer
        404:
          description: No such trace
          content:
            application/json:
              schema:
                type: string
    delete:
      summary: Delete a bookmark
      operationId: deleteExperimentBookmark
      tags:
        - Bookmarks
      parameters:
        - name: expUUID
          in: path
          description: The UUID of the experiment in the server
          required: true
          schema:
            type: string
            format: uuid
        - name: bookmarkId
          in: path
          description: The unique identifier of the bookmark to delete
          required: true
          schema:
            type: string
            format: uuid
      responses:
        200:
          description: Returns the deleted bookmark
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Bookmark"
        404:
          description: No such trace or bookmark
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/data/{outputID}/tree:
    post:
      tags:
        - Data Tree
      summary: API to get a data tree.
      description: Unique entry point for output providers,
        to get the tree of visible entries
      operationId: getDataTreeEntry
      parameters:
        - name: expUUID
          in: path
          description: UUID of the experiment to query
          required: true
          schema:
            type: string
            format: uuid
        - name: outputID
          in: path
          description: ID of the output provider to query
          required: true
          schema:
            type: string
      requestBody:
        description: Query parameters to fetch the data tree.
          When 'requested_times' is absent the tree for the full range is returned. When present it specifies a range as [start, end].
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                parameters:
                  type: object
                  properties:
                    requested_times:
                      type: array
                      items:
                        type: integer
                  additionalProperties:
                    type: object
              required:
                - parameters
              example:
                parameters:
                  requested_times: [111111111, 222222222]
      responses:
        200:
          description: Returns a list of data tree entries. The returned model must be consistent, parentIds must refer to a parent which exists in the model.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/GenericResponse"
                  - type: object
                    properties:
                      model:
                        $ref: "#/components/schemas/TreeEntryModel"
        404:
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/XY/{outputID}/tooltip:
    get:
      tags:
        - XY
      summary: API to get the XY tooltips.
      description: Endpoint to retrieve tooltips for XY
      operationId: getXYTooltip
      parameters:
        - name: expUUID
          in: path
          description: UUID of the experiment to query
          required: true
          schema:
            type: string
            format: uuid
        - name: outputID
          in: path
          description: ID of the output provider to query
          required: true
          schema:
            type: string
        - name: xValue
          in: query
          description: The xValue for which to get the tooltip
          required: true
          schema:
            type: integer
        - name: yValue
          in: query
          description: The yValue for which to get the tooltip
          schema:
            type: number
        - name: entryId
          in: query
          description: The entryId or seriesId for which to get the tooltip
          schema:
            type: integer
      responses:
        200:
          description: Returns a list of tooltip keys to values
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    key:
                      type: string
                    value:
                      type: string
        404:
          description: Experiment or output provider not found
          content:
            application/json:
              schema:
                type: string
  /experiments/{expUUID}/outputs/timeGraph/{outputID}/navigate/states:
    post:
      tags:
        - TimeGraph
      summary: Tentative API for TimeGraph navigation
      operationId: navigateStates
      description: Endpoint to retrieve the next / previous corresponding states
      parameters:
        - name: expUUID
          in: path
          description: UUID of the experiment to query
          required: true
          schema:
            type: string
            format: uuid
        - name: outputID
          in: path
          description: ID of the output provider to query
          required: true
          schema:
            type: string
        - name: direction
          in: query
          description: Direction of the navigation
          required: true
          schema:
            type: string
            enum: [next, previous]
      requestBody:
        description:
          Query parameters to fetch the next / previous timegraph state.
          The 'requested_times' array contains the currently selected time.
          The 'requested_times' array contains the currently selected entryId.
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                parameters:
                  type: object
                  properties:
                    requested_times:
                      type: array
                      items:
                        type: integer
                    requested_items:
                      type: array
                      items:
                        type: integer
                  required:
                    - requested_times
                    - requested_items
                  additionalProperties:
                    type: object
              required:
                - parameters
              example:
                parameters:
                  requested_times: [111111111]
                  requested_items: [1]
      responses:
        200:
          description: Returns a list of time graph row
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/GenericResponse"
                  - type: object
                    properties:
                      desiredTime:
                        type: integer
                        format: int64
                      desiredEntry:
                        type: integer
                        format: int64
                      model:
                        type: array
                        items:
                          $ref: "#/components/schemas/TimeGraphModel"
components:
  schemas:
    Configuration:
      type: object
      properties:
        sourceTypeId:
          type: string
          description: The ID of the configuration source type
        description:
          type: string
          description: Describes the configuration instance
        name:
          type: string
          description: The human readable name
        id:
          type: string
          description: The unique ID of the configuration instance
        parameters:
          type: object
          additionalProperties:
            type: object
            description: Optional parameters representing the configuration parameters
              used to create this configuration.
          description: Optional parameters representing the configuration parameters
            used to create this configuration.
      description: Configuration instance describing user provided configuration parameters.
    ConfigurationParameterDescriptor:
      type: object
      properties:
        dataType:
          type: string
          description: The data type hint of the configuration parameter
        keyName:
          type: string
          description: The unique key name of the configuration parameter
        required:
          type: boolean
          description: A flag indicating whether the configuration parameter is required
            or not
        description:
          type: string
          description: Describes the configuration parameter
      description: A list of configuration parameter descriptors to be passed when
        creating or updating a configuration instance of this type. Use this instead
        of schema. Omit if not used.
    ConfigurationSourceType:
      type: object
      properties:
        parameterDescriptors:
          type: array
          description: A list of configuration parameter descriptors to be passed
            when creating or updating a configuration instance of this type. Use this
            instead of schema. Omit if not used.
          items:
            $ref: '#/components/schemas/ConfigurationParameterDescriptor'
        description:
          type: string
          description: Describes the configuration source type
        schema:
          $ref: '#/components/schemas/OptionalSchema'
        name:
          type: string
          description: The human readable name
        id:
          type: string
          description: The unique ID of the configuration source type
    OptionalSchema:
      type: object
      description: A JSON object that describes a JSON schema for parameters that
        the front-end needs to provide with corresponding values. The schema has to
        adhere to JSON schema specification (see https://json-schema.org/). Use this
        for complex parameter descriptions instead of parameterDescriptors. Omit if
        not used.
    ConfigurationQueryParameters:
      required:
      - name
      - parameters
      type: object
      properties:
        description:
          type: string
          description: Optional description of the configuration.
        name:
          type: string
          description: Unique name of the configuration.
        parameters:
          type: object
          additionalProperties:
            type: object
            description: Parameters as specified in the schema or list of ConfigurationParameterDescriptor
              of the corresponding ConfigurationTypeDescriptor.
          description: Parameters as specified in the schema or list of ConfigurationParameterDescriptor
            of the corresponding ConfigurationTypeDescriptor.
    DataProvider:
      type: object
      properties:
        parentId:
          type: string
          description: Optional parent Id for grouping purposes for example of derived
            data providers.
        description:
          type: string
          description: Describes the output provider's features
        name:
          type: string
          description: The human readable name
        id:
          type: string
          description: The output provider's ID
        type:
          type: string
          description: "Type of data returned by this output. Serves as a hint to\
            \ determine what kind of view should be used for this output (ex. XY,\
            \ Time Graph, Table, etc..). Providers of type TREE_TIME_XY and TIME_GRAPH\
            \ can be grouped under the same time axis. Providers of type DATA_TREE\
            \ only provide a tree with columns and don't have any XY nor time graph\
            \ data associated with it. Providers of type NONE have no data to visualize.\
            \ Can be used for grouping purposes and/or as data provider configurator."
          enum:
          - TABLE
          - TREE_TIME_XY
          - TIME_GRAPH
          - DATA_TREE
          - NONE
        configuration:
          $ref: '#/components/schemas/Configuration'
    OutputConfigurationQueryParameters:
      required:
      - typeId
      type: object
      allOf:
      - $ref: '#/components/schemas/ConfigurationQueryParameters'
      - type: object
        properties:
          sourceTypeId:
            type: string
            description: The type ID of the corresponding ConfigurationSourceType defined by this output.
              ConfigurationTypeDescriptor.
    AnnotationCategoriesModel:
      type: object
      properties:
        annotationCategories:
          type: array
          description: Array of all the categories
          items:
            type: string
      description: Model returned by outputs that contains annotation categories available
        for this output
    AnnotationCategoriesResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/AnnotationCategoriesModel'
    GenericResponse:
      type: object
      properties:
        statusMessage:
          type: string
        status:
          type: string
          description: All possible statuses for a server response
          enum:
          - RUNNING
          - COMPLETED
          - FAILED
          - CANCELLED
      description: Response that includes the status and a status message
    Annotation:
      required:
      - duration
      - entryId
      - time
      - type
      type: object
      properties:
        style:
          $ref: '#/components/schemas/OutputElementStyle'
        entryId:
          type: integer
          description: Entry's unique ID or -1 if annotation not associated with an
            entry
          format: int64
        type:
          type: string
          description: Type of annotation indicating its location
          enum:
          - CHART
          - TREE
        time:
          type: integer
          description: Time of this annotation
          format: int64
        duration:
          type: integer
          description: Duration of this annotation
          format: int64
        label:
          type: string
          description: Text label of this annotation
      description: An annotation is used to mark an interesting area at a given time
        or time range
    AnnotationModel:
      type: object
      properties:
        annotations:
          type: object
          additionalProperties:
            type: array
            description: Map of annotations where the keys are categories
            items:
              $ref: '#/components/schemas/Annotation'
          description: Map of annotations where the keys are categories
      description: Model returned by outputs that contains annotations per category
    AnnotationResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/AnnotationModel'
    OutputElementStyle:
      type: object
      properties:
        parentKey:
          type: string
          description: "Parent style key or empty if there is no parent. The parent\
            \ key should match a style key defined in the style model and is used\
            \ for style inheritance. A comma-delimited list of parent style keys can\
            \ be used for style composition, the last one taking precedence."
        values:
          type: object
          additionalProperties:
            type: object
            description: Style values or empty map if there are no values. Keys and
              values are defined in https://git.eclipse.org/r/plugins/gitiles/tracecompass/org.eclipse.tracecompass/+/refs/heads/master/tmf/org.eclipse.tracecompass.tmf.core/src/org/eclipse/tracecompass/tmf/core/model/StyleProperties.java
          description: Style values or empty map if there are no values. Keys and
            values are defined in https://git.eclipse.org/r/plugins/gitiles/tracecompass/org.eclipse.tracecompass/+/refs/heads/master/tmf/org.eclipse.tracecompass.tmf.core/src/org/eclipse/tracecompass/tmf/core/model/StyleProperties.java
      description: "Represents the style on an element (ex. Entry, TimeGraphState,\
        \ ...) returned by any output. Supports style inheritance. To avoid having\
        \ too many styles, the element style can have a parent style and will have\
        \ all the same style property values as the parent, and can add or override\
        \ style properties."
    AnnotationsParameters:
      required:
      - requested_timerange
      type: object
      properties:
        requested_marker_categories:
          type: array
          items:
            type: string
        requested_marker_set:
          type: string
        requested_timerange:
          $ref: '#/components/schemas/TimeRange'
        requested_items:
          type: array
          items:
            type: integer
            format: int32
    AnnotationsQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/AnnotationsParameters'
    TimeRange:
      required:
      - end
      - start
      type: object
      properties:
        nbTimes:
          type: integer
          description: The number of timestamps to be sampled (1-65536) in the given
            range
          format: int32
        end:
          type: integer
          description: The end of the time range
          format: int64
        start:
          type: integer
          description: The start of the time range
          format: int64
      description: A time range with optional number of timestamps to be sampled
    TimeGraphArrow:
      required:
      - end
      - sourceId
      - start
      - targetId
      type: object
      properties:
        targetId:
          type: integer
          description: Target entry's unique ID
          format: int64
        end:
          type: integer
          description: End time for this arrow
          format: int64
        start:
          type: integer
          description: Start time for this arrow
          format: int64
        style:
          $ref: '#/components/schemas/OutputElementStyle'
        sourceId:
          type: integer
          description: Source entry's unique ID
          format: int64
    TimeGraphArrowsResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            type: array
            items:
              $ref: '#/components/schemas/TimeGraphArrow'
    ArrowsParameters:
      required:
      - requested_timerange
      type: object
      properties:
        requested_timerange:
          $ref: '#/components/schemas/TimeRange'
    ArrowsQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/ArrowsParameters'
    TableColumnHeader:
      type: object
      properties:
        description:
          type: string
          description: Description of the column
        name:
          type: string
          description: Displayed name for this column
        id:
          type: integer
          description: Unique id to identify this column in the backend
          format: int64
        type:
          type: string
          description: Type of data associated to this column
    TableColumnHeadersResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            type: array
            items:
              $ref: '#/components/schemas/TableColumnHeader'
    OptionalParameters:
      type: object
    OptionalQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/OptionalParameters'
    TreeColumnHeader:
      required:
      - name
      type: object
      properties:
        dataType:
          type: string
          description: "Data type of column. Optional, data type STRING is applied\
            \ if absent."
          enum:
          - NUMBER
          - BINARY_NUMBER
          - TIMESTAMP
          - DURATION
          - STRING
          - TIME_RANGE
        tooltip:
          type: string
          description: "Displayed tooltip for this header. Optional, no tooltip is\
            \ applied if absent."
        name:
          type: string
          description: Displayed name for this header
    TreeDataModel:
      required:
      - id
      - labels
      type: object
      properties:
        hasData:
          type: boolean
          description: Whether or not this entry has data
        parentId:
          type: integer
          description: "Unique id to identify this parent's entry, optional if this\
            \ entry does not have a parent."
          format: int64
        style:
          $ref: '#/components/schemas/OutputElementStyle'
        id:
          type: integer
          description: Unique id to identify this entry in the backend
          format: int64
        labels:
          type: array
          description: Array of cell labels to be displayed. The length of the array
            and the index of each column need to correspond to the header array returned
            in the tree model.
          items:
            type: string
      description: Base entry returned by tree endpoints
    TreeEntryModel:
      required:
      - entries
      type: object
      properties:
        entries:
          type: array
          items:
            $ref: '#/components/schemas/TreeDataModel'
        headers:
          type: array
          items:
            $ref: '#/components/schemas/TreeColumnHeader'
    XYTreeEntry:
      type: object
      allOf:
      - $ref: '#/components/schemas/TreeDataModel'
      - type: object
        properties:
          isDefault:
            type: boolean
            description: Optional flag to indicate whether or not the entry is a default
              entry and its xy data should be fetched by default.
    XYTreeEntryModel:
      type: object
      allOf:
      - $ref: '#/components/schemas/TreeEntryModel'
      - type: object
        properties:
          entries:
            type: array
            items:
              $ref: '#/components/schemas/XYTreeEntry'
    XYTreeResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/XYTreeEntryModel'
    TreeParameters:
      type: object
      properties:
        requested_times:
          type: array
          items:
            type: integer
            format: int64
    TreeQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/TreeParameters'
    VirtualTableCell:
      type: object
      properties:
        tags:
          type: integer
          description: Specific tags for this cell. A value of 0 should be handled
            as none (no tags)
          format: int32
        content:
          type: string
          description: Content of the cell for this line
    VirtualTableLine:
      type: object
      properties:
        tags:
          type: integer
          description: "Tags for the entire line. A bit mask to apply for tagging\
            \ elements (e.g. table lines, states). This can be used by the server\
            \ to indicate if a filter matches and what action to apply. Use 0 for\
            \ no tags, 1 and 2 are reserved, 4 for 'BORDER' and 8 for 'HIGHLIGHT'."
          format: int32
        cells:
          type: array
          description: The content of the cells for this line. This array matches
            the column ids returned above
          items:
            $ref: '#/components/schemas/VirtualTableCell'
        index:
          type: integer
          description: The index of this line in the virtual table
          format: int64
    VirtualTableModel:
      type: object
      properties:
        columnIds:
          type: array
          description: The array of column ids that are returned. They should match
            the content of the lines' content
          items:
            type: integer
            format: int64
        lowIndex:
          type: integer
          description: Index in the virtual table of the first returned event
          format: int64
        lines:
          type: array
          items:
            $ref: '#/components/schemas/VirtualTableLine'
        size:
          type: integer
          description: "Number of events. If filtered, the size will be the number\
            \ of events that match the filters"
          format: int64
    VirtualTableResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/VirtualTableModel'
    LinesParameters:
      required:
      - requested_table_count
      type: object
      properties:
        requested_times:
          type: array
          items:
            type: integer
            format: int64
        requested_table_index:
          type: integer
          format: int64
        requested_table_count:
          type: integer
          format: int32
        requested_table_column_ids:
          type: array
          items:
            type: integer
            format: int64
        table_search_expressions:
          type: object
          additionalProperties:
            type: string
        table_search_direction:
          type: string
          description: "Search next or previous item (e.g. event, state etc.)"
          enum:
          - NEXT
          - PREVIOUS
    LinesQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/LinesParameters'
    MarkerSet:
      type: object
      properties:
        name:
          type: string
          description: Name of this marker set
        id:
          type: string
          description: ID of this marker set
      description: A marker set is used to represent a set of annotations that can
        be fetched
    MarkerSetsResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            type: array
            items:
              $ref: '#/components/schemas/MarkerSet'
    TimeGraphModel:
      type: object
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/TimeGraphRowModel'
    TimeGraphRowModel:
      required:
      - entryId
      - states
      type: object
      properties:
        states:
          type: array
          description: List of the time graph entry states associated to this entry
            and zoom level
          items:
            $ref: '#/components/schemas/TimeGraphState'
        entryId:
          type: integer
          description: The entry to map this state list to
          format: int64
    TimeGraphState:
      required:
      - end
      - start
      type: object
      properties:
        tags:
          type: integer
          description: Tags to apply on this state. A value of 0 should be handled
            as none (no tags)
          format: int32
        end:
          type: integer
          description: End time for this state
          format: int64
        start:
          type: integer
          description: Start time for this state
          format: int64
        style:
          $ref: '#/components/schemas/OutputElementStyle'
        label:
          type: string
          description: "Text label to apply to this TimeGraphState if resolution permits.\
            \ Optional, no label is applied if absent"
    TimeGraphStatesResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/TimeGraphModel'
    RequestedFilterQueryParameters:
      required:
      - filter_expressions_map
      type: object
      properties:
        filter_expressions_map:
          type: object
          additionalProperties:
            type: array
            description: "The key of this map can be \"1\" (means DIMMED) or \"4\"\
              \ (means EXCLUDED) and the value is an array of the desired search query\
              \ (e.g. {\"1\": [\"openat\", \"duration>10ms\"]})"
            items:
              type: string
              description: "The key of this map can be \"1\" (means DIMMED) or \"\
                4\" (means EXCLUDED) and the value is an array of the desired search\
                \ query (e.g. {\"1\": [\"openat\", \"duration>10ms\"]})"
          description: "The key of this map can be \"1\" (means DIMMED) or \"4\" (means\
            \ EXCLUDED) and the value is an array of the desired search query (e.g.\
            \ {\"1\": [\"openat\", \"duration>10ms\"]})"
        strategy:
          type: string
          description: Optional parameter that enables the full search (deep search)
            or not
          enum:
          - SAMPLED
          - DEEP
      description: FilterQueryParameters is used to support search and filter expressions
        for timegraph views
    RequestedParameters:
      required:
      - requested_items
      - requested_timerange
      type: object
      properties:
        requested_timerange:
          $ref: '#/components/schemas/TimeRange'
        requested_items:
          type: array
          items:
            type: integer
            format: int32
        filter_query_parameters:
          $ref: '#/components/schemas/RequestedFilterQueryParameters'
    RequestedQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/RequestedParameters'
    OutputStyleModel:
      type: object
      properties:
        styles:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/OutputElementStyle'
      description: Map of styles specific to an output where values give hints on
        the style. The keys are strings that can be used in OutputElementStyle
    StylesResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/OutputStyleModel'
    TimeGraphTooltip:
      type: object
      properties:
        value:
          type: string
        key:
          type: string
    TimeGraphTooltipResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            type: array
            items:
              $ref: '#/components/schemas/TimeGraphTooltip'
    Element:
      required:
      - duration
      - elementType
      - time
      type: object
      properties:
        entryId:
          type: integer
          description: "Entry's unique ID (annotation, arrow)"
          format: int64
        destinationId:
          type: integer
          description: Destination entry's unique ID (arrow)
          format: int64
        time:
          type: integer
          description: Element's start time
          format: int64
        duration:
          type: integer
          description: Element's duration
          format: int64
        elementType:
          type: string
          description: The type of element
          enum:
          - STATE
          - ANNOTATION
          - ARROW
      description: An element model to be identified
    TooltipParameters:
      required:
      - requested_element
      - requested_items
      - requested_times
      type: object
      properties:
        requested_items:
          type: array
          items:
            type: integer
            format: int32
        requested_times:
          type: array
          items:
            type: integer
            format: int64
        requested_element:
          $ref: '#/components/schemas/Element'
    TooltipQueryParameters:
      required:
      - parameters
      type: object
      properties:
        parameters:
          $ref: '#/components/schemas/TooltipParameters'
    TimeGraphEntry:
      type: object
      allOf:
      - $ref: '#/components/schemas/TreeDataModel'
      - type: object
        properties:
          end:
            type: integer
            description: End of the range for which this entry exists
            format: int64
          start:
            type: integer
            description: Beginning of the range for which this entry exists
            format: int64
          metadata:
            type: object
            additionalProperties:
              type: array
              description: Optional metadata map for domain specific data for matching
                data across data providers. Keys for the same data shall be the same
                across data providers. Only values of type Number or String are allowed.
                For each key all values shall have the same type.
              items:
                type: object
                description: Optional metadata map for domain specific data for matching
                  data across data providers. Keys for the same data shall be the
                  same across data providers. Only values of type Number or String
                  are allowed. For each key all values shall have the same type.
            description: Optional metadata map for domain specific data for matching
              data across data providers. Keys for the same data shall be the same
              across data providers. Only values of type Number or String are allowed.
              For each key all values shall have the same type.
    TimeGraphTreeModel:
      type: object
      allOf:
      - $ref: '#/components/schemas/TreeEntryModel'
      - type: object
        properties:
          entries:
            type: array
            items:
              $ref: '#/components/schemas/TimeGraphEntry'
    TimeGraphTreeResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/TimeGraphTreeModel'
    SeriesModel:
      required:
      - seriesId
      - seriesName
      - style
      - xValues
      - yValues
      type: object
      properties:
        seriesId:
          type: integer
          description: Series' ID
          format: int64
        seriesName:
          type: string
          description: Series' name
        style:
          $ref: '#/components/schemas/OutputElementStyle'
        xValues:
          type: array
          description: Series' X values
          items:
            type: integer
            format: int64
        yValues:
          type: array
          description: Series' Y values
          items:
            type: integer
            format: int64
      description: This model includes the series output style values.
    XYModel:
      required:
      - series
      - title
      type: object
      properties:
        series:
          type: array
          description: The collection of series
          items:
            $ref: '#/components/schemas/SeriesModel'
        title:
          type: string
          description: Title of the model
    XYResponse:
      type: object
      allOf:
      - $ref: '#/components/schemas/GenericResponse'
      - type: object
        properties:
          model:
            $ref: '#/components/schemas/XYModel'
    Experiment:
      type: object
      properties:
        traces:
          type: array
          description: The traces encapsulated by this experiment
          items:
            $ref: '#/components/schemas/Trace'
        end:
          type: integer
          description: The experiment's end time
          format: int64
        nbEvents:
          type: integer
          description: Current number of indexed events in the experiment
          format: int64
        start:
          type: integer
          description: The experiment's start time
          format: int64
        indexingStatus:
          type: string
          description: Status of the experiment indexing
          enum:
          - RUNNING
          - COMPLETED
          - CLOSED
        name:
          type: string
          description: User defined name for the experiment
        UUID:
          type: string
          description: The experiment's unique identifier
          format: uuid
    Trace:
      type: object
      properties:
        end:
          type: integer
          description: The trace's end time
          format: int64
        nbEvents:
          type: integer
          description: Current number of indexed events in the trace
          format: int64
        start:
          type: integer
          description: The trace's start time
          format: int64
        indexingStatus:
          type: string
          description: Status of the trace indexing
          enum:
          - RUNNING
          - COMPLETED
          - CLOSED
        name:
          type: string
          description: User defined name for the trace
        properties:
          type: object
          additionalProperties:
            type: string
            description: The trace's properties
          description: The trace's properties
        path:
          type: string
          description: Path to the trace on the server's file system
        UUID:
          type: string
          description: The trace's unique identifier
          format: uuid
    ExperimentQueryParameters:
      required:
      - name
      - traces
      type: object
      properties:
        traces:
          type: array
          description: The unique identifiers of the traces to encapsulate in this
            experiment
          items:
            type: string
            format: uuid
        name:
          type: string
          description: The name to give this experiment
    ServerStatus:
      type: object
      properties:
        status:
          type: string
          description: The status of the server
          enum:
          - UP
    ServerInfoResponse:
      required:
      - os
      - productId
      - tspVersion
      - version
      type: object
      properties:
        osArch:
          type: string
          description: Architecture of the operating system
        buildTime:
          type: string
          description: "Build time or qualifier of the server version, if available"
        os:
          type: string
          description: Operating system name
        osVersion:
          type: string
          description: Operating system version
        cpuCount:
          type: integer
          description: Number of CPUs available
          format: int32
        maxMemory:
          type: integer
          description: Maximum memory available to the JVM in bytes
          format: int64
        launcherName:
          type: string
          description: "Name of the launcher used, if available"
        productId:
          type: string
          description: Product identifier for the trace server
        tspVersion:
          type: string
          description: The TSP version that the trace server supports
        version:
          type: string
          description: Version in the format Major.Minor.Micro
      description: System Information Response
    TraceQueryParameters:
      required:
      - uri
      type: object
      properties:
        typeID:
          type: string
          description: "The trace type's ID, to force the use of a parser / disambiguate\
            \ the trace type"
        name:
          type: string
          description: "The name of the trace in the server, to override the default\
            \ name"
        uri:
          type: string
          description: URI of the trace
    Bookmark:
      type: object
      properties:
        start:
          description: the start time for this bookmark.
          type: integer
          format: int64
        end:
          description: the end time for this bookmark.
          type: integer
          format: int64
        name:
          description: this bookmark's name
          type: string
        type:
          description: The type of the bookmark (generic, output, ...)
          type: string
        iconUrl:
          description: URL to the bookmark's icon
          type: string
        UUID:
          description: The bookmark's unique ID, generated by the server.
          type: string
          format: uuid
    Filter:
      type: object
      properties:
        id:
          description: Unique id to identify this entry in the backend.
          type: integer
          format: int32
        name:
          description: Human readable label for this filter
          type: string
        start:
          description: start time for this filter
          type: integer
          format: int64
        end:
          description: end time for this filter
          type: integer
          format: int64
        expression:
          description: expression from the filter language
          type: string
        tags:
          description: Tags to be applied on elements that pass this filter
          type: integer
          format: int32