{
  "info": {
    "name": "TopRU API",
    "description": "TopRU APIs for RU (Request Unit) statistics from Delta Lake type=topsql/component=topru. Use collection variables to set base URL and cluster headers.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "base_url", "value": "http://localhost:8080/api/v1" },
    { "key": "x_provider", "value": "aws" },
    { "key": "x_region", "value": "us-west-2" },
    { "key": "x_org_id", "value": "1369847559692509642" },
    { "key": "x_cluster_id", "value": "10110362358366286743" },
    { "key": "x_deploy_type", "value": "nextgen" },
    { "key": "start_ts", "value": "1739000000" },
    { "key": "end_ts", "value": "1739100000" },
    { "key": "sql_digest", "value": "D28680C29009B286DD9708A1372FA8A9D6A01F73CA44C2B2A940DD3A119A2FD9" }
  ],
  "item": [
    {
      "name": "TopRU Config",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{base_url}}/topru/config",
          "host": ["{{base_url}}"],
          "path": ["topru", "config"]
        },
        "description": "Check if TopRU is enabled. No cluster headers required."
      }
    },
    {
      "name": "TopRU Summary (by digest)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "X-Provider", "value": "{{x_provider}}" },
          { "key": "X-Region", "value": "{{x_region}}" },
          { "key": "X-Org-Id", "value": "{{x_org_id}}" },
          { "key": "X-Cluster-Id", "value": "{{x_cluster_id}}" },
          { "key": "X-Deploy-Type", "value": "{{x_deploy_type}}" }
        ],
        "url": {
          "raw": "{{base_url}}/topru/summary?start={{start_ts}}&end={{end_ts}}&top=20&order_by=ru",
          "host": ["{{base_url}}"],
          "path": ["topru", "summary"],
          "query": [
            { "key": "start", "value": "{{start_ts}}" },
            { "key": "end", "value": "{{end_ts}}" },
            { "key": "top", "value": "20" },
            { "key": "order_by", "value": "ru", "description": "ru | exec_count | duration" }
          ]
        },
        "description": "Overall RU summary aggregated by sql_digest only (plans collapsed). order_by: ru (default), exec_count, duration."
      }
    },
    {
      "name": "TopRU Summary (by user)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "X-Provider", "value": "{{x_provider}}" },
          { "key": "X-Region", "value": "{{x_region}}" },
          { "key": "X-Org-Id", "value": "{{x_org_id}}" },
          { "key": "X-Cluster-Id", "value": "{{x_cluster_id}}" },
          { "key": "X-Deploy-Type", "value": "{{x_deploy_type}}" }
        ],
        "url": {
          "raw": "{{base_url}}/topru/summary?start={{start_ts}}&end={{end_ts}}&top=20&order_by=ru&user=my_user",
          "host": ["{{base_url}}"],
          "path": ["topru", "summary"],
          "query": [
            { "key": "start", "value": "{{start_ts}}" },
            { "key": "end", "value": "{{end_ts}}" },
            { "key": "top", "value": "20" },
            { "key": "order_by", "value": "ru" },
            { "key": "user", "value": "my_user", "description": "Filter summary by this user" }
          ]
        },
        "description": "RU summary for a specific user, still aggregated by sql_digest."
      }
    },
    {
      "name": "TopRU SummaryPlan (all digests)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "X-Provider", "value": "{{x_provider}}" },
          { "key": "X-Region", "value": "{{x_region}}" },
          { "key": "X-Org-Id", "value": "{{x_org_id}}" },
          { "key": "X-Cluster-Id", "value": "{{x_cluster_id}}" },
          { "key": "X-Deploy-Type", "value": "{{x_deploy_type}}" }
        ],
        "url": {
          "raw": "{{base_url}}/topru/summaryplan?start={{start_ts}}&end={{end_ts}}&top=20&order_by=ru",
          "host": ["{{base_url}}"],
          "path": ["topru", "summaryplan"],
          "query": [
            { "key": "start", "value": "{{start_ts}}" },
            { "key": "end", "value": "{{end_ts}}" },
            { "key": "top", "value": "20" },
            { "key": "order_by", "value": "ru" }
          ]
        },
        "description": "RU summary by sql_digest + plan_digest (former /topru/summary behavior)."
      }
    },
    {
      "name": "TopRU SummaryPlan (one digest)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "X-Provider", "value": "{{x_provider}}" },
          { "key": "X-Region", "value": "{{x_region}}" },
          { "key": "X-Org-Id", "value": "{{x_org_id}}" },
          { "key": "X-Cluster-Id", "value": "{{x_cluster_id}}" },
          { "key": "X-Deploy-Type", "value": "{{x_deploy_type}}" }
        ],
        "url": {
          "raw": "{{base_url}}/topru/summaryplan?start={{start_ts}}&end={{end_ts}}&top=20&order_by=ru&digest={{sql_digest}}",
          "host": ["{{base_url}}"],
          "path": ["topru", "summaryplan"],
          "query": [
            { "key": "start", "value": "{{start_ts}}" },
            { "key": "end", "value": "{{end_ts}}" },
            { "key": "top", "value": "20" },
            { "key": "order_by", "value": "ru" },
            { "key": "digest", "value": "{{sql_digest}}", "description": "sql_digest from /topru/summary" }
          ]
        },
        "description": "Plan breakdown for one sql_digest (drill-down from /topru/summary)."
      }
    },
    {
      "name": "TopRU User Stats",
      "request": {
        "method": "GET",
        "header": [
          { "key": "X-Provider", "value": "{{x_provider}}" },
          { "key": "X-Region", "value": "{{x_region}}" },
          { "key": "X-Org-Id", "value": "{{x_org_id}}" },
          { "key": "X-Cluster-Id", "value": "{{x_cluster_id}}" },
          { "key": "X-Deploy-Type", "value": "{{x_deploy_type}}" }
        ],
        "url": {
          "raw": "{{base_url}}/topru/user_stats?start={{start_ts}}&end={{end_ts}}&top=20",
          "host": ["{{base_url}}"],
          "path": ["topru", "user_stats"],
          "query": [
            { "key": "start", "value": "{{start_ts}}" },
            { "key": "end", "value": "{{end_ts}}" },
            { "key": "top", "value": "20", "description": "Top N users by total_ru, default 20" }
          ]
        },
        "description": "RU statistics per user (total_ru, exec_count, duration_ns), sorted by total_ru descending."
      }
    }
  ]
}