Skip to content

Commit b744afe

Browse files
committed
doc: Add table of content to trace-server-dev-guide.md
Signed-off-by: Bernd Hufmann <[email protected]>
1 parent 7074455 commit b744afe

File tree

1 file changed

+71
-2
lines changed

1 file changed

+71
-2
lines changed

doc/trace-server/trace-server-dev-guide.md

Lines changed: 71 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,74 @@
1-
# Introduction
1+
# Trace Compass Server Developer Guide
2+
<!-- TOC START -->
3+
- [Trace Compass Server Developer Guide](#trace-compass-server-developer-guide)
4+
- [Introduction](#introduction)
5+
- [Key Concepts](#key-concepts)
6+
- [Analysis](#analysis)
7+
- [Configuration](#configuration)
8+
- [Configuration source](#configuration-source)
9+
- [Configuration source type](#configuration-source-type)
10+
- [Data Provider (Output)](#data-provider-output)
11+
- [Data Provider Configurator](#data-provider-configurator)
12+
- [Data Provider Factory](#data-provider-factory)
13+
- [Data Provider Descriptor (Output Descriptor)](#data-provider-descriptor-output-descriptor)
14+
- [Data Provider Manager](#data-provider-manager)
15+
- [Data Provider Type](#data-provider-type)
16+
- [Experiment](#experiment)
17+
- [Generic State system](#generic-state-system)
18+
- [Segment Store](#segment-store)
19+
- [Trace](#trace)
20+
- [Workspace](#workspace)
21+
- [Trace Compass Server Workspace](#trace-compass-server-workspace)
22+
- [Workspace Root](#workspace-root)
23+
- [`.metadata` Folder](#metadata-folder)
24+
- [`Tracing` Project folder](#tracing-project-folder)
25+
- [`Traces` Folder](#traces-folder)
26+
- [`Experiments` Folder](#experiments-folder)
27+
- [Supplementary `.tracing` Folder](#supplementary-tracing-folder)
28+
- [Finding the supplementary folder for a trace or experiment](#finding-the-supplementary-folder-for-a-trace-or-experiment)
29+
- [Implementing a custom trace server](#implementing-a-custom-trace-server)
30+
- [Implementing a new trace type](#implementing-a-new-trace-type)
31+
- [Component interactions](#component-interactions)
32+
- [Implementing a global configuration](#implementing-a-global-configuration)
33+
- [Implementing a configuration source](#implementing-a-configuration-source)
34+
- [Implementing an analysis module](#implementing-an-analysis-module)
35+
- [Taking advantage of the Analysis Framework](#taking-advantage-of-the-analysis-framework)
36+
- [Creating a data provider](#creating-a-data-provider)
37+
- [Creating an XY Data Provider](#creating-an-xy-data-provider)
38+
- [Supported query parameters](#supported-query-parameters)
39+
- [Creating a Time Graph Data Provider](#creating-a-time-graph-data-provider)
40+
- [Supported query parameters](#supported-query-parameters-1)
41+
- [Creating a Data Tree Data Provider](#creating-a-data-tree-data-provider)
42+
- [Supported query parameters](#supported-query-parameters-2)
43+
- [Virtual Table](#virtual-table)
44+
- [Supported query parameters](#supported-query-parameters-3)
45+
- [Using the data provider manager to access data providers](#using-the-data-provider-manager-to-access-data-providers)
46+
- [Implementing a Data Provider Factory](#implementing-a-data-provider-factory)
47+
- [Extension point](#extension-point)
48+
- [Using data provider factories with experiments](#using-data-provider-factories-with-experiments)
49+
- [Utilities](#utilities)
50+
- [Registering a data provider factory programmatically](#registering-a-data-provider-factory-programmatically)
51+
- [Implementing a facotry for single-instance data providers](#implementing-a-facotry-for-single-instance-data-providers)
52+
- [Implementing a facotry for multi-instance data providers](#implementing-a-facotry-for-multi-instance-data-providers)
53+
- [Grouping of data providers](#grouping-of-data-providers)
54+
- [Implementing a data provider without analysis module](#implementing-a-data-provider-without-analysis-module)
55+
- [Implementing a configurable data provider](#implementing-a-configurable-data-provider)
56+
- [Implementing a configuration source type](#implementing-a-configuration-source-type)
57+
- [The configuration source type describes the input parameters to provide when to pass when creating a new data provider or global configuration.](#the-configuration-source-type-describes-the-input-parameters-to-provide-when-to-pass-when-creating-a-new-data-provider-or-global-configuration)
58+
- [Implementing a configurable data provider without analysis module](#implementing-a-configurable-data-provider-without-analysis-module)
59+
- [Implementing an `ITmfDataProviderConfigurator` without analysis module](#implementing-an-itmfdataproviderconfigurator-without-analysis-module)
60+
- [Updating data provider factory for configurable data provider (without analysis module)](#updating-data-provider-factory-for-configurable-data-provider-without-analysis-module)
61+
- [Updating data provider class for configurable data provider (without analysis module)](#updating-data-provider-class-for-configurable-data-provider-without-analysis-module)
62+
- [Implementing a configurable data provider with an analysis module](#implementing-a-configurable-data-provider-with-an-analysis-module)
63+
- [Implementing an `ITmfDataProviderConfigurator` with analysis module](#implementing-an-itmfdataproviderconfigurator-with-analysis-module)
64+
- [Creating a configurable analysis module](#creating-a-configurable-analysis-module)
65+
- [Updating data provider factory for configurable data provider (with analysis module)](#updating-data-provider-factory-for-configurable-data-provider-with-analysis-module)
66+
- [Updating data provider class for configurable data provider (with analysis module)](#updating-data-provider-class-for-configurable-data-provider-with-analysis-module)
67+
- [Future considerations](#future-considerations)
68+
- [To Do](#to-do)
69+
<!-- TOC END -->
70+
71+
## Introduction
272

373
The purpose of Trace Compass trace server is to facilitate the integration of trace analysis and visualization using client applications that implement the `Trace Server Protocol`, for example, the `vscode-trace-extension` or `tsp-python-client`.
474

@@ -3157,4 +3227,3 @@ Provide guides for other features relevant for developing a custom trace server
31573227
- Time graph filtering
31583228
- Details on creating a virtual table
31593229
- How to add a new data provider type
3160-

0 commit comments

Comments
 (0)