Dashboard Management

Build custom monitoring dashboards with real-time metrics, visualizations, and insights to monitor your TensorOne infrastructure and applications effectively.

Request Parameters

dashboardId

string

Specific dashboard ID to retrieve. If not provided, returns list of available dashboards.

includeData

boolean

default:"false"

Whether to include current metric data with dashboard configuration

timeRange

string

default:"1h"

Time range for dashboard data:

5m - Last 5 minutes
15m - Last 15 minutes
1h - Last hour
6h - Last 6 hours
24h - Last 24 hours
7d - Last 7 days
30d - Last 30 days

refresh

boolean

default:"false"

Force refresh of cached dashboard data

format

string

default:"json"

Response format:

json - JSON response
export - Export format for sharing
embed - Embeddable HTML format

filters

object

Filters to apply to dashboard data:

regions - Array of region codes
resourceIds - Array of specific resource IDs
tags - Array of tags to filter by

Response

dashboards

array

Array of dashboard objects (when no specific dashboardId provided)

Show Dashboard Object

dashboardId

string

Unique dashboard identifier

name

string

Dashboard name

description

string

Dashboard description

type

string

Dashboard type: system, custom, template

Example

curl -X GET "https://api.tensorone.ai/v2/monitoring/dashboards" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G \
  -d "includeData=true" \
  -d "timeRange=6h"

{
  "dashboards": [
    {
      "dashboardId": "dashboard-infra-001",
      "name": "Infrastructure Overview",
      "description": "Comprehensive infrastructure monitoring dashboard",
      "type": "system",
      "category": "infrastructure",
      "layout": {
        "grid": {
          "rows": 4,
          "columns": 6
        },
        "widgets": 8,
        "theme": "dark"
      },
      "widgets": [
        {
          "widgetId": "widget-cpu-001",
          "title": "CPU Utilization",
          "type": "gauge",
          "position": {
            "row": 0,
            "col": 0,
            "width": 2,
            "height": 1
          },
          "config": {
            "metric": "cpu_utilization",
            "thresholds": {
              "warning": 70,
              "critical": 90
            },
            "unit": "%",
            "displayFormat": "percentage"
          },
          "dataSource": {
            "resource": "clusters",
            "aggregation": "avg",
            "timeRange": "5m"
          },
          "data": {
            "currentValue": 68.5,
            "previousValue": 65.2,
            "status": "normal",
            "trend": "increasing"
          }
        },
        {
          "widgetId": "widget-memory-chart-001",
          "title": "Memory Usage Trend",
          "type": "chart",
          "position": {
            "row": 0,
            "col": 2,
            "width": 4,
            "height": 2
          },
          "config": {
            "chartType": "line",
            "metrics": ["memory_utilization"],
            "yAxis": {
              "min": 0,
              "max": 100,
              "unit": "%"
            },
            "legend": true,
            "colors": ["#4ECDC4"]
          },
          "dataSource": {
            "resource": "clusters",
            "granularity": "1m",
            "timeRange": "1h"
          },
          "data": {
            "timeSeries": [
              {
                "name": "Memory Utilization",
                "data": [72.1, 73.5, 74.2, 75.8, 76.3],
                "timestamps": [
                  "2024-01-16T17:00:00Z",
                  "2024-01-16T17:01:00Z",
                  "2024-01-16T17:02:00Z",
                  "2024-01-16T17:03:00Z",
                  "2024-01-16T17:04:00Z"
                ]
              }
            ]
          }
        },
        {
          "widgetId": "widget-alerts-001",
          "title": "Active Alerts",
          "type": "alert_list",
          "position": {
            "row": 2,
            "col": 0,
            "width": 6,
            "height": 1
          },
          "config": {
            "maxItems": 5,
            "severityFilter": ["critical", "high"],
            "showResolved": false
          },
          "dataSource": {
            "resource": "alerts",
            "status": "active"
          },
          "data": {
            "alerts": [
              {
                "alertId": "alert-001",
                "title": "High GPU utilization on cluster-001",
                "severity": "high",
                "timestamp": "2024-01-16T17:45:00Z"
              }
            ],
            "totalCount": 3
          }
        }
      ],
      "permissions": {
        "owner": "admin@company.com",
        "shared": true,
        "viewers": ["team@company.com"],
        "editors": ["ops@company.com"],
        "public": false
      },
      "metadata": {
        "createdAt": "2024-01-15T10:00:00Z",
        "updatedAt": "2024-01-16T14:30:00Z",
        "version": "1.2",
        "tags": ["infrastructure", "monitoring", "system"],
        "autoRefresh": 30
      }
    }
  ],
  "templates": [
    {
      "templateId": "template-gpu-monitoring",
      "name": "GPU Cluster Monitoring",
      "description": "Pre-configured dashboard for GPU cluster monitoring",
      "category": "infrastructure",
      "preview": "https://assets.tensorone.ai/dashboard-previews/gpu-monitoring.png"
    },
    {
      "templateId": "template-cost-optimization",
      "name": "Cost Optimization Dashboard",
      "description": "Track costs and identify optimization opportunities",
      "category": "business",
      "preview": "https://assets.tensorone.ai/dashboard-previews/cost-optimization.png"
    }
  ]
}