Skip to content

Table

Tables enable you to quickly represent trace data in a tabular format.

Since tables sit on top of trace data, the steps to create a table from scratch are as follows:

  1. Create a model.
  2. Create a trace with columns or props that references your model.
  3. Create a table that references the trace. Within the table.columns block you will need to explicitly state the trace columns and header names that you want to include.

Example

models:
  - name: table-model
    sql: |
        select
            project_name,
            project_created_at,
            cli_version,
            stage_name,
            account_name,
            stage_archived
        FROM visivo_project
traces:
  - name: pre-table-trace
    model: ref(table-model)
    columns:
        project_name: project_name
        project_created_at: project_created_at::varchar
        cli_version: cli_version
        stage_name: stage_name
        account_name: account_name
        stage_archived: stage_archived::varchar
    props:
        type: scatter
        x: column(project_created_at)
        y: column(project_name)
tables:
  - name: latest-projects-table
    traces:
      - ref(pre-table-trace)
    column_defs:
      - trace_name: pre-table-trace
        columns:
        - header: "Project Name"
          key: columns.project_name
        - header: "Project Created At"
          key: columns.project_created_at
        - header: "Project Json"
          key: columns.project_json
        - header: "CLI Version"
          key: columns.cli_version
        - header: "Stage Name"
          key: columns.stage_name
        - header: "Account Name"
          key: columns.account_name
        - header: "Account Name"
          key: columns.stage_archived
Tables are built on the material react table framework.

Attributes

Field Type Default Description
name string None The unique name of the object across the entire project.
selector #/$defs/Selector None The selector for the choosing which trace data is shown.
traces Array of Trace [] A ref() to a trace or trace defined in line. Data for the table will come from the trace.
column_defs Any of: TableColumnDefinition, array None A list of column definitions. These definitions define the columns for a given trace included in this table.