Better Stack

telemetry_add_chart_to_dashboard_tool

Add a new chart to a dashboard. Use the `section` parameter to organize charts into named sections — sections are auto-created if they don't exist, and charts are auto-positioned within them. **IMPORTANT: Follow this workflow:** 1) Call get_chart_building_instructions first for chart type, unit, and settings reference. 2) If you haven't already verified the query by previewing with `telemetry_chart` (which runs the query and reports errors automatically), test it with `telemetry_query` first. The SQL query should use variables like {{source}}, {{start_time}}, {{end_time}}, and {{time}} for proper integration with dashboard filters

Remote betterstack

Other tools also called telemetry_add_chart_to_dashboard_tool? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name/title for the chart"
    },
    "query": {
      "type": "string",
      "description": "SQL query for the chart. Use {{source}}, {{start_time}}, {{end_time}}, {{time}} variables"
    },
    "width": {
      "type": "integer",
      "description": "Chart width in grid units (1-12, default: 6)"
    },
    "height": {
      "type": "integer",
      "description": "Chart height in grid units (default: 8)"
    },
    "section": {
      "type": "string",
      "description": "Section name — chart is auto-placed within it. Section auto-created if it doesn't exist."
    },
    "settings": {
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "description": "Value format: percent, B_si, B_iec, ms, s, shortened, e/s, rps, none, auto"
        },
        "legend": {
          "enum": [
            "hidden",
            "shown_below",
            "shown_right"
          ],
          "type": "string",
          "description": "Legend placement"
        },
        "stacking": {
          "enum": [
            "dont_stack",
            "stack",
            "stack_to_100"
          ],
          "type": "string",
          "description": "Stacking mode for line/bar charts"
        },
        "y_axis_max": {
          "type": "number",
          "description": "Y-axis maximum value (use 1 for 0-1 ratios with percent unit)"
        },
        "y_axis_min": {
          "type": "number",
          "description": "Y-axis minimum value"
        },
        "y_axis_scale": {
          "enum": [
            "linear",
            "log"
          ],
          "type": "string",
          "description": "Y-axis scale type"
        },
        "series_column": {
          "type": "string",
          "description": "Column that groups data into series (e.g., 'service', 'host')"
        },
        "value_columns": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Which result columns contain numeric data to chart (optional, inferred from query results). Must match column names/aliases from the SQL query."
        },
        "decimal_places": {
          "type": "number",
          "description": "Number of decimal places for values"
        },
        "treat_missing_values": {
          "enum": [
            "connected",
            "disconnected",
            "zero",
            "previous"
          ],
          "type": "string",
          "description": "How to handle gaps in data"
        }
      },
      "description": "Chart display settings"
    },
    "chart_type": {
      "enum": [
        "line_chart",
        "bar_chart",
        "number_chart",
        "table_chart",
        "pie_chart",
        "heatmap_chart",
        "scatter_chart",
        "gauge_chart",
        "static_text_chart"
      ],
      "type": "string",
      "description": "Type of chart to create"
    },
    "dashboard_id": {
      "type": "integer",
      "description": "The ID of the dashboard to add the chart to"
    },
    "source_variable": {
      "type": "string",
      "description": "Variable name for the source in query templates. Most queries use 'source' (default). Change only if query uses a different variable name like 'my_source'"
    }
  }
}