{
  "id": null,
  "uid": "netconf-transceiver-exporter",
  "title": "NETCONF Transceiver Exporter",
  "tags": ["netconf", "transceiver", "exporter"],
  "timezone": "browser",
  "schemaVersion": 38,
  "version": 1,
  "refresh": "30s",
  "panels": [
    {
      "type": "stat",
      "title": "Exporter Scrape Success Ratio",
      "description": "含义：当前选择的所有 $device 的 netconf_scrape_success 平均值，介于 0–1。用法：一眼看整体抓取健康度（≈1 表示基本都成功，<1 表示有失败）；多选多个设备时是平均值，可快速知道整体是否在抖。",
      "id": 1,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "avg(netconf_scrape_success{job=~\"$job\", device=~\"$device\"})",
          "legendFormat": "success_ratio",
          "refId": "A"
        }
      ],
      "options": {
        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
        "orientation": "horizontal",
        "textMode": "auto"
      },
      "gridPos": { "h": 4, "w": 6, "x": 0, "y": 0 }
    },
    {
      "type": "timeseries",
      "title": "Exporter Build Info (TODO)",
      "description": "含义：预留的 exporter_build_info{version,python_version} 指标，可查看 exporter 版本与 Python 运行环境。用法：目前 exporter 尚未实现该指标，显示 No data 属正常；未来实现后，可以用来确认线上跑的是哪个版本/解释器，排查“是不是在用最新代码”。",
      "id": 9,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "exporter_build_info{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{version}} ({{python_version}})",
          "refId": "A"
        }
      ],
      "gridPos": { "h": 4, "w": 6, "x": 6, "y": 0 }
    },
    {
      "type": "stat",
      "title": "Exporter Devices Total (TODO)",
      "description": "含义：预留的 exporter_devices_total，表示 exporter 配置或注册的设备总数。用法：当前无数据属预期；未来实现后，可对比 total 与 enabled（Panel 11），例如 total=10 但 enabled=8，用来找出被禁用或注册失败的设备。",
      "id": 10,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "exporter_devices_total{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}} total",
          "refId": "A"
        }
      ],
      "fieldConfig": { "defaults": { "unit": "none" }, "overrides": [] },
      "options": {
        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
        "orientation": "horizontal",
        "textMode": "auto"
      },
      "gridPos": { "h": 4, "w": 6, "x": 12, "y": 0 }
    },
    {
      "type": "stat",
      "title": "Exporter Devices Enabled (TODO)",
      "description": "含义：预留的 exporter_devices_enabled，表示实际启用抓取的设备数量。用法：当前无数据属预期；未来实现后，可快速判断是否有设备被标记为 disabled 或注册失败，并与 Panel 10 对比排查配置问题。",
      "id": 11,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "exporter_devices_enabled{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}} enabled",
          "refId": "A"
        }
      ],
      "fieldConfig": { "defaults": { "unit": "none" }, "overrides": [] },
      "options": {
        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
        "orientation": "horizontal",
        "textMode": "auto"
      },
      "gridPos": { "h": 4, "w": 6, "x": 18, "y": 0 }
    },
    {
      "type": "timeseries",
      "title": "Scrape Success by Device",
      "description": "含义：每个设备的 netconf_scrape_success 随时间的 0/1 曲线（按 $device 过滤）。用法：查看“哪个设备最近在频繁失败”：曲线掉到 0 的时间段就是失败窗口；多设备同时查看时，每条线代表一个 device，可以直观看出谁最不稳定。",
      "id": 2,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "netconf_scrape_success{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "bool" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 9, "x": 6, "y": 0 }
    },
    {
      "type": "timeseries",
      "title": "Scrape Duration per Device",
      "description": "含义：每个设备的 netconf_scrape_duration_seconds，单位秒。用法：判断哪台设备抓取最慢（曲线越高，抓取耗时越长，可能 RPC 多或设备性能差）；观察趋势变化，例如某设备 duration 从 2s 突然升到 10s，提示设备压力或链路问题。",
      "id": 3,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "netconf_scrape_duration_seconds{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "s" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 9, "x": 15, "y": 0 }
    },
    {
      "type": "table",
      "title": "Scrape Errors by Device & Type (5m)",
      "description": "含义：最近 5 分钟内 netconf_scrape_errors_total 的增长量，按 (device,error_type) 聚合。用法：出现异常时优先查看 error_type（如 AuthError、RpcTimeout、UnknownError 等）；配合 Panel 2/3 使用，当某设备 success 掉、duration 拉长时，看对应的 error_type 是什么以定位问题。",
      "id": 4,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "sum(increase(netconf_scrape_errors_total{job=~\"$job\", device=~\"$device\"}[5m])) by (device, error_type)",
          "format": "table",
          "refId": "A"
        }
      ],
      "fieldConfig": { "defaults": {}, "overrides": [] },
      "gridPos": { "h": 6, "w": 12, "x": 0, "y": 4 }
    },
    {
      "type": "timeseries",
      "title": "Transceiver Supply Voltage",
      "description": "含义：transceiver_supply_voltage_volts，按 {device,port,component_name} 展示各光模块电压。用法：$port 选 All 时可对比不同端口/模块电压是否在合理区间；当某个 transceiver 电压明显过低或过高时，通过 legend 中的 device/port/component_name 精确定位异常模块。",
      "id": 12,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_supply_voltage_volts{job=~\"$job\", device=~\"$device\", port=~\"$port\"}",
          "legendFormat": "{{device}}/{{port}}/{{component_name}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "volt" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 6 }
    },
    {
      "type": "timeseries",
      "title": "Transceiver Temperature (with vendor/serial)",
      "description": "含义：transceiver_temperature_celsius 与 transceiver_info_info join 后的温度曲线，legend 中包含 vendor 与 serial 等元数据。用法：在同一设备下对比多个模块温度，快速发现温度显著偏高的模块；带 serial 的 legend 方便截图或记录，用于资产与维护（如“序列号为 X 的模块长期偏高”）。",
      "id": 13,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "transceiver_temperature_celsius{job=~\"$job\", device=~\"$device\", port=~\"$port\"} * on(job, device, port, component_name) group_left(vendor, serial, part_number, hardware_rev) transceiver_info_info{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}}/{{port}} {{vendor}}({{serial}})",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "celsius" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 6 }
    },
    {
      "type": "bargauge",
      "title": "Transceiver Present & Oper Status",
      "description": "含义：transceiver_present 表示模块是否在位 (1=在位,0=不在位)，同时预留展示 transceiver_oper_status（运行状态，例如 up/down），当前无该数据属预期。用法：快速确认某设备端口上光模块是否插着（present=1）；未来实现 oper_status 后，可在同一面板中发现“模块在位但状态为 down”这类异常。",
      "id": 14,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_present{job=~\"$job\", device=~\"$device\", port=~\"$port\"}",
          "legendFormat": "{{device}}/{{port}}/{{component_name}}",
          "refId": "A"
        },
        {
          "expr": "transceiver_oper_status{job=~\"$job\", device=~\"$device\", port=~\"$port\"}",
          "legendFormat": "oper: {{device}}/{{port}}/{{component_name}}",
          "refId": "B"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "bool" },
        "overrides": []
      },
      "gridPos": { "h": 6, "w": 12, "x": 0, "y": 14 }
    },
    {
      "type": "timeseries",
      "title": "Channel Tx Power (dBm)",
      "description": "含义：transceiver_channel_tx_power_dbm，按 channel 维度展示发射光功率。用法：$device + $port 指定后，$component 可选单个或多个模块，查看各通道的 TX 功率；用于对比多通道是否功率均衡，以及定位某个通道发射功率突然下降的情况。",
      "id": 15,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "transceiver_channel_tx_power_dbm{job=~\"$job\", device=~\"$device\", port=~\"$port\", component_name=~\"$component\"}",
          "legendFormat": "{{component_name}}:{{channel}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "dBm" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 20 }
    },
    {
      "type": "timeseries",
      "title": "Channel Rx Power (dBm)",
      "description": "含义：transceiver_channel_rx_power_dbm，按 channel 展示接收光功率。用法：配合 TX 面板一起查看链路健康度（TX 正常但 RX 很低可能是远端/链路问题）；多 device、多 port 对比场景下，可快速识别接收功率异常低的通道。",
      "id": 16,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_channel_rx_power_dbm{job=~\"$job\", device=~\"$device\", port=~\"$port\", component_name=~\"$component\"}",
          "legendFormat": "{{component_name}}:{{channel}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "dBm" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 20 }
    },
    {
      "type": "timeseries",
      "title": "Channel Bias Current (mA)",
      "description": "含义：transceiver_channel_bias_current_ma，每个 channel 对应激光器偏置电流。用法：检查不同通道的电流是否在合理范围内，识别某个通道电流特别高的情况（可能模块老化）；结合历史趋势观察电流缓慢爬升，用于预判光模块老化风险。",
      "id": 17,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_channel_bias_current_ma{job=~\"$job\", device=~\"$device\", port=~\"$port\", component_name=~\"$component\"}",
          "legendFormat": "{{component_name}}:{{channel}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "mA" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 28 }
    },
    {
      "type": "timeseries",
      "title": "Channel Laser Temperature (C, device-dependent)",
      "description": "含义：transceiver_channel_laser_temperature_celsius，按通道展示激光器温度。用法：当前 H3C 设备通常不返回该字段，因此本面板往往无数据，这是设备特性而非 bug；若未来设备或其他厂商实现该字段，本面板可用于更细粒度地观察每个通道的激光温度。",
      "id": 18,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_channel_laser_temperature_celsius{job=~\"$job\", device=~\"$device\", port=~\"$port\", component_name=~\"$component\"}",
          "legendFormat": "{{component_name}}:{{channel}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "celsius" },
        "overrides": []
      },
      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 28 }
    },
    {
      "type": "table",
      "title": "Channel Info (Instant)",
      "description": "含义：transceiver_channel_info_info 与 transceiver_info_info join 后形成的静态资产表，每行对应一个 channel，并附带 vendor/serial/part_number/hardware_rev 等上游光模块信息。用法：使用 Instant 查询和表格展示，仅保留 label 列；作为“光模块资产清单”，可按 port、component_name、channel_index 排序，清晰查看每个端口有哪些模块及其通道数量，并通过 vendor/serial 等字段核对现场资产或反查某个 channel 属于哪个物理模块。",
      "id": 19,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "transceiver_channel_info_info{job=~\"$job\", device=~\"$device\"} * on(job, device, port, component_name) group_left(vendor, serial, part_number, hardware_rev) transceiver_info_info{job=~\"$job\", device=~\"$device\"}",
          "format": "table",
          "instant": true,
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": {},
        "overrides": [
          {
            "matcher": { "id": "byName", "options": "Time" },
            "properties": [
              { "id": "custom.hidden", "value": true }
            ]
          },
          {
            "matcher": { "id": "byName", "options": "Value" },
            "properties": [
              { "id": "custom.hidden", "value": true }
            ]
          }
        ]
      },
      "options": {
        "showHeader": true
      },
      "gridPos": { "h": 10, "w": 24, "x": 0, "y": 36 }
    },
    {
      "type": "stat",
      "title": "Time Since Last Scrape (s)",
      "description": "含义：time() - netconf_last_scrape_timestamp_seconds，表示每个设备距离最近一次 NETCONF 抓取已过去的秒数。用法：如果数值一直在几十秒以内，说明抓取在持续正常执行；若某设备数值突然飙高且长期不回落，说明它很久没有被成功抓取，需检查连接、认证或设备状态。",
      "id": 20,
      "datasource": {
        "type": "prometheus",
        "uid": "prometheus"
      },
      "targets": [
        {
          "expr": "time() - netconf_last_scrape_timestamp_seconds{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}}",
          "refId": "A"
        }
      ],
      "fieldConfig": {
        "defaults": { "unit": "s" },
        "overrides": []
      },
      "options": {
        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
        "orientation": "horizontal",
        "textMode": "auto"
      },
      "gridPos": { "h": 4, "w": 6, "x": 0, "y": 46 }
    },
    {
      "type": "stat",
      "title": "Transceiver Data Staleness (TODO)",
      "description": "含义：设计中的 transceiver_data_staleness_seconds，计划表示 Transceiver 业务数据（最近一次成功抓取）相对当前时间的滞后程度。用法：目前仅注册 metric，逻辑尚未实现，因此无数据属预期；未来实现后，将比 Panel 20 更直接地体现“业务数据本身有多旧”，用于监控数据新鲜度。",
      "id": 21,
      "datasource": { "type": "prometheus", "uid": "prometheus" },
      "targets": [
        {
          "expr": "transceiver_data_staleness_seconds{job=~\"$job\", device=~\"$device\"}",
          "legendFormat": "{{device}}",
          "refId": "A"
        }
      ],
      "fieldConfig": { "defaults": { "unit": "s" }, "overrides": [] },
      "options": {
        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
        "orientation": "horizontal",
        "textMode": "auto"
      },
      "gridPos": { "h": 4, "w": 6, "x": 6, "y": 46 }
    }
  ],
  "templating": {
    "list": [
      {
        "name": "job",
        "label": "Job",
        "type": "query",
        "datasource": {
          "type": "prometheus",
          "uid": "prometheus"
        },
        "query": "label_values(netconf_scrape_success, job)",
        "refresh": 1,
        "multi": true,
        "includeAll": true,
        "current": {
          "text": "All",
          "value": "$__all"
        }
      },
      {
        "name": "device",
        "label": "Device",
        "type": "query",
        "datasource": {
          "type": "prometheus",
          "uid": "prometheus"
        },
        "query": "label_values(netconf_scrape_success{job=~\"$job\"}, device)",
        "refresh": 2,
        "multi": true,
        "includeAll": true
      },
      {
        "name": "port",
        "label": "Port",
        "type": "query",
        "datasource": {
          "type": "prometheus",
          "uid": "prometheus"
        },
        "query": "label_values(transceiver_channel_info_info{job=~\"$job\",device=~\"$device\"}, port)",
        "refresh": 2,
        "multi": true,
        "includeAll": true
      },
      {
        "name": "component",
        "label": "Component",
        "type": "query",
        "datasource": {
          "type": "prometheus",
          "uid": "prometheus"
        },
        "query": "label_values(transceiver_channel_info_info{job=~\"$job\",device=~\"$device\",port=~\"$port\"}, component_name)",
        "refresh": 2,
        "multi": true,
        "includeAll": true
      }
    ]
  },
  "time": {
    "from": "now-1h",
    "to": "now"
  }
}