6.3 業務可觀測性(Observability)與 SLA/SLO 守護

🏆 ERP 旗艦專案・模組 7:總裁營運儀表板 本節產出:一鍵彙總營收、毛利、在庫資金,並用燈號告訴老闆「毛利率有沒有達標」的儀表板分頁。

學完本節,你能夠:

  1. 說明為什麼「系統沒有報錯」不等於「生意是健康的」,並為一個業務流程挑出 3 個業務指標。
  2. 區分 SLI、SLO、SLA,並算出一個 SLO 對應的錯誤預算(每月可停機幾分鐘)。
  3. 在 ERP 試算表上產生總裁儀表板,並驗算營收、毛利率、在庫資金三個數字。

壹、開場情境:每個模組都是綠燈,公司卻在變薄

📌 以下為教學情境(依實務改編)。

延續第 4.2 節的 ERP。月底經營會議上,各模組負責人輪流報告:

模組 報告內容 狀態
模組 4 採購入庫 A 款補貨 30 台,加權成本已過帳為 €112 ✅
模組 5 銷貨出庫 兩張訂單出貨成功,沒有超賣 ✅
模組 6 安全庫存 B、C 款低水位,已寄出補貨信 ✅

每個程式都正常執行、沒有任何錯誤訊息。總經理只問了一句:「所以這個月到底賺多少?」會議室一片安靜——沒有人能當場回答。

事後用計算機算出來:這個月毛利率只有 8.4%,遠低於第 1.1 節訂下的 15% 底線。原因是 A 款的售價 NT$ 4,200 是依舊成本 €100 訂的;第 4.2 節補貨後加權成本已經漲到 €112,業務卻一直沒有改用新報價,而沒有任何一張表把這件事攤在老闆眼前。

💡 同樣的盲點也發生在網站上。 常見的情況是:金流服務商更新了驗證流程,買家在付款頁一直失敗;但因為請求根本沒進到我方伺服器,CPU 和記憶體看起來都「很健康」。技術指標全綠,訂單卻歸零。

本節要解決的問題: 讓老闆按一個按鈕,就看到營收、毛利、在庫資金三個數字,以及「毛利率有沒有達標」的燈號。


貳、為什麼會這樣:監控 vs. 可觀測性

1. 技術指標不等於業務指標

可觀測性(Observability) 指的是:從系統對外輸出的資料,推斷系統內部真實狀態的能力。技術上常說的三大資料來源是指標(Metrics)、日誌(Logs)、追蹤(Traces)。但商管人更需要的是業務指標:

層次 看什麼 回答的問題 開場情境中
技術指標 CPU、記憶體、錯誤率、回應時間 系統有沒有在跑? 每個模組都 ✅
業務指標 訂單數、轉換率、營收、毛利率、庫存資金 生意有沒有在賺? 毛利率 8.4%,沒人看見

外貿電商常用的業務指標:每小時訂單數、結帳轉換率(加入購物車 → 付款成功)、付款失敗率、平均通關天數。這些指標下跌時,系統可能完全沒有報錯。

2. SLI、SLO、SLA:量測、目標、合約

SLI 服務水準指標 SLO 服務水準目標 SLA 服務水準協議
是什麼 實際量到的數字 團隊內部承諾的目標 對客戶的合約承諾,違約要賠
誰訂的 由量測產生 團隊與主管 業務與法務,與客戶簽約
例子 上個月訂單 API 可用率 99.92% 每月可用率 ≥ 99.9% 每月可用率低於 99.5%,退還當月服務費 15%;低於 99.0%,退還 30%

三者的關係:SLO 要訂得比 SLA 嚴(99.9% vs. 99.5%),中間的差距就是緩衝。SLI 跌破 SLO 時團隊就該處理,不要等到跌破 SLA 才開始賠錢。

3. 錯誤預算:100% 不是好目標

追求 100% 可用率,代價會急遽上升,而且團隊會因為怕出錯而不敢發布任何新功能。Google 的 SRE(網站可靠性工程)實務因此提出錯誤預算(Error Budget):

錯誤預算 = 100% − SLO
每月可停機時間 = 30 天 × 24 小時 × 60 分鐘 × 錯誤預算
SLO 錯誤預算 每月(30 天)可停機 每年可停機
99% 1% 432 分鐘(7.2 小時) 87.6 小時
99.5% 0.5% 216 分鐘(3.6 小時) 43.8 小時
99.9% 0.1% 43.2 分鐘 8.76 小時
99.99% 0.01% 4.32 分鐘 約 53 分鐘

用法:本月預算還很多 → 可以發布新功能、做第 6.1 節的金絲雀發布;預算快用完 → 暫停新功能,先修穩定性。這把「業務要快、維運要穩」的爭論,變成一個大家都看得懂的數字。

4. 把 SLO 的觀念借到業務指標上

SLO 原本用在系統可用率,但同樣的思路可以用在業務上:先講好目標值,量測結果自動跟目標比,跌破就亮燈。 本節的儀表板就把「毛利率 ≥ 15%」(第 1.1 節的 MIN_MARGIN)當成業務 SLO。


參、把規則寫下來:老闆要看的三個數字

老闆說的話 需要追問的問題 寫成規格
「這個月賣了多少?」 哪些訂單算數? 「銷售訂單」E 欄狀態以 ✅ 開頭(已出庫)才計入;⏳ 待審核、❌ 庫存不足不算
「真正賺多少?」 成本用哪個數字? 成本 = 銷售數量 × 「庫存主檔」C 欄加權單位成本(EUR)× 帳務匯率
「用哪個匯率?」 每天變動的匯率,報表要用哪一個? 先固定一個帳務匯率 35.0,宣告為常數,由財務決定何時調整
「倉庫壓了多少錢?」 用售價還是成本算? 在庫資金 = 即時庫存 × 加權單位成本 × 帳務匯率(用成本,不用售價)
「毛利要健康」 多少算健康? 毛利率 ≥ 15% 亮 ✅,否則亮 🛑
(老闆沒說) 訂單的品項在庫存主檔找不到怎麼辦? 不可以把成本當成 0(會讓毛利虛增);毛利顯示「⚠️ 無法計算」並跳出告警

最後一列是本節最重要的例外:儀表板寧可說「我不知道」,也不能給老闆一個錯的數字。


肆、讓 AI 做出來

1. 會用到的兩張表(沿用第 4.2 節,欄位不變)

庫存主檔

A 產品名稱 B 即時庫存 C 加權單位成本 (EUR) D 安全庫存 E 庫存狀態
2 人體工學鍵盤 A款 50 112.00 15 🟢 充足
3 無線雙模鍵盤 B款 8 150.00 10 🚨 緊急補貨
4 靜電容旗艦鍵盤 C款 5 180.00 10 🚨 緊急補貨

銷售訂單

A 訂單編號 B 訂購品項 C 銷售數量 D 銷售單價 (TWD) E 訂單狀態
2 SO-2026-881 人體工學鍵盤 A款 10 4,200 ✅ 已出貨扣庫
3 SO-2026-882 無線雙模鍵盤 B款 2 6,120 ✅ 已出貨扣庫

以上是執行選單【⚙️ 一鍵初始化/重置全新進銷存系統】後的預設資料。

📌 這份預設資料是本節的教學情境,和第 4.2 節的手動練習不同: A 款仍沿用舊報價 NT$ 4,200(業務沒有依第 4.2 節的加權成本調到 4,900,這正是儀表板要抓出來的盲點);庫存主檔的 50 台是已含本月補貨、並扣掉 SO-2026-881 出貨 10 台之後的現況。

2. 先用手算一次(驗收的標準答案)

項目 算式 結果
A 款營收 10 × 4,200 NT$ 42,000
A 款成本 10 × 112 × 35 NT$ 39,200
B 款營收 2 × 6,120 NT$ 12,240
B 款成本 2 × 150 × 35 NT$ 10,500
累計營收 42,000 + 12,240 NT$ 54,240
累計毛利 54,240 − 39,200 − 10,500 NT$ 4,540
毛利率 4,540 ÷ 54,240 8.4% 🛑
A 款在庫資金 50 × 112 × 35 NT$ 196,000
B 款在庫資金 8 × 150 × 35 NT$ 42,000
C 款在庫資金 5 × 180 × 35 NT$ 31,500
在庫資金合計 NT$ 269,500

注意 A 款:售價 4,200 是用舊成本 €100 × 35 加成 20% 算出來的(毛利率 16.7%),成本漲到 €112 之後,毛利率只剩 2,800 ÷ 42,000 = 6.7%。儀表板的價值,就是把這種「慢慢變薄」攤在桌上。

3. 給 AI 的 Prompt

你是熟悉 Google Apps Script 的商業系統工程師。請寫函式 generateExecutiveDashboard()。

【資料來源】(第 1 列為標題,資料從第 2 列開始,不要改動這兩張表)
- 「庫存主檔」A 產品名稱|B 即時庫存|C 加權單位成本(EUR)|D 安全庫存|E 庫存狀態
- 「銷售訂單」A 訂單編號|B 訂購品項|C 銷售數量|D 銷售單價(TWD)|E 訂單狀態

【商業規則】
1. 帳務匯率 35.0、毛利率目標 15%,宣告為程式最上方的常數 DASH_FX_RATE、DASH_MARGIN_SLO。
2. 營收:E 欄以「✅」開頭的訂單,加總 C × D。
3. 成本:C × 該品項加權單位成本 × 帳務匯率。毛利 = 營收 − 成本,毛利率 = 毛利 ÷ 營收。
4. 在庫資金:每個品項 B × C × 帳務匯率,四捨五入到整數。

【例外處理】
- 任一已出庫訂單的品項在庫存主檔找不到:不可把成本當 0;毛利顯示「⚠️ 無法計算」,並跳出告警列出訂單編號。
- 找不到兩張表:跳出告警並結束。沒有已出庫訂單:顯示「ℹ️ 目前沒有已出庫的訂單」。

【輸出要求】
- 分頁「總裁儀表板」:A1:E1 標題;第 3 列 A/C/E 為三個 KPI 名稱,第 4 列為數值;
  第 5 列合併 A5:E5 顯示毛利率燈號(✅ 綠底 / 🛑 紅底 / ⚠️ 黃底);
  第 7 列起寫入各品項在庫資金明細,並在 D7 附近插入橫條圖。
- 每次執行先清除舊內容與舊圖表。一次讀取、批次寫入,附中文註解。

4. AI 產出的程式碼(已人工驗收)

// ===== 儀表板參數(經理人只需要改這兩行)=====
const DASH_FX_RATE = 35.0;     // 帳務匯率:把歐元成本換算成台幣
const DASH_MARGIN_SLO = 0.15;  // 毛利率目標(SLO),與 1.1 節的毛利底線一致

/**
 * 模組 7:進銷存財務毛利總裁儀表板與視覺長條圖
 */
function generateExecutiveDashboard() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let ui = null;                                 // 時間觸發條件執行時沒有畫面,getUi() 會出錯
  try { ui = SpreadsheetApp.getUi(); } catch (e) { ui = null; }
  const salesSheet = ss.getSheetByName('銷售訂單');
  const stockSheet = ss.getSheetByName('庫存主檔');
  if (!salesSheet || !stockSheet) {
    const msg = '❌ 找不到「銷售訂單」或「庫存主檔」,請先執行一鍵初始化!';
    if (ui) ui.alert(msg); else Logger.log(msg);
    return;
  }

  // 1. 庫存主檔 A~C:產品名稱|即時庫存|加權單位成本 (EUR)
  const stockRows = stockSheet.getLastRow() >= 2
    ? stockSheet.getRange(2, 1, stockSheet.getLastRow() - 1, 3).getValues() : [];
  const unitCostTWD = {};                        // 品項 → 台幣單位成本
  const holding = [['產品名稱', '在庫積壓金額 (TWD)']];
  let totalHolding = 0;
  for (const [item, qty, costEUR] of stockRows) {
    if (!item) continue;                         // 跳過空白列
    unitCostTWD[item] = Number(costEUR) * DASH_FX_RATE;
    const value = Math.round(Number(qty) * unitCostTWD[item]);
    totalHolding += value;
    holding.push([item, value]);
  }

  // 2. 銷售訂單 A~E:訂單編號|訂購品項|銷售數量|銷售單價 (TWD)|訂單狀態
  const salesRows = salesSheet.getLastRow() >= 2
    ? salesSheet.getRange(2, 1, salesSheet.getLastRow() - 1, 5).getValues() : [];
  let revenue = 0;
  let cost = 0;
  const noCost = [];                             // 找不到成本的訂單編號
  for (const [orderId, item, qty, price, status] of salesRows) {
    // 只計入已出庫的訂單:狀態以 ✅ 開頭(模組 5 與前端入口網頁寫入的都算)
    if (!String(status).startsWith('✅')) continue;
    revenue += Number(qty) * Number(price);
    if (item in unitCostTWD) {
      cost += Number(qty) * unitCostTWD[item];
    } else {
      noCost.push(orderId);                      // 不可以把成本當成 0
    }
  }

  // 3. 判斷毛利率是否達到 SLO
  const profit = revenue - cost;
  const margin = revenue > 0 ? profit / revenue : 0;
  const pct = (x) => (x * 100).toFixed(1) + '%';
  let profitText;
  let sloText;
  if (noCost.length > 0) {
    profitText = '⚠️ 無法計算';
    sloText = `⚠️ 資料異常:訂單 ${noCost.join('、')} 的品項不在庫存主檔,毛利暫不顯示`;
  } else if (revenue === 0) {
    profitText = 'NT$ 0';
    sloText = 'ℹ️ 目前沒有已出庫的訂單';
  } else {
    profitText = `NT$ ${Math.round(profit).toLocaleString()} (${pct(margin)})`;
    sloText = margin >= DASH_MARGIN_SLO
      ? `✅ 毛利率 ${pct(margin)},達到目標 ${pct(DASH_MARGIN_SLO)}`
      : `🛑 毛利率 ${pct(margin)},低於目標 ${pct(DASH_MARGIN_SLO)}`;
  }

  // 4. 重建「總裁儀表板」分頁(先清掉舊內容與舊圖表)
  let dash = ss.getSheetByName('總裁儀表板');
  if (!dash) dash = ss.insertSheet('總裁儀表板');
  dash.clear();
  dash.getCharts().forEach(c => dash.removeChart(c));

  dash.getRange('A1:E1').merge()
    .setValue('🏬 跨國進銷存 ERP 總裁營運儀表板')
    .setFontWeight('bold').setFontSize(15)
    .setBackground('#0f172a').setFontColor('#ffffff').setHorizontalAlignment('center');

  // 三張 KPI 卡片:標題在第 3 列,數值在第 4 列
  dash.getRange('A3:E4').setValues([
    ['💰 累計銷貨營收', '', '📈 累計毛利 (毛利率)', '', '📦 在庫積壓資金'],
    [`NT$ ${revenue.toLocaleString()}`, '', profitText, '', `NT$ ${totalHolding.toLocaleString()}`]
  ]);
  dash.getRange('A3:E3').setFontWeight('bold').setBackground('#f8fafc');
  dash.getRange('A4:E4').setFontSize(14).setFontWeight('bold')
    .setFontColors([['#047857', '#000000', '#1d4ed8', '#000000', '#b91c1c']]);
  dash.getRange('A3:E4').setBorder(true, true, true, true, true, true,
    '#cbd5e1', SpreadsheetApp.BorderStyle.SOLID);

  // 第 5 列:SLO 燈號
  dash.getRange('A5:E5').merge().setValue(sloText).setFontWeight('bold')
    .setBackground(sloText.startsWith('✅') ? '#dcfce7'
      : sloText.startsWith('🛑') ? '#fee2e2' : '#fef9c3');

  // 5. 第 7 列起:各品項積壓資金明細 + 長條圖
  dash.getRange(7, 1, holding.length, 2).setValues(holding);
  dash.getRange(7, 1, 1, 2).setFontWeight('bold')
    .setBackground('#1e293b').setFontColor('#ffffff');
  if (holding.length > 1) {
    const chart = dash.newChart()
      .setChartType(Charts.ChartType.BAR)
      .addRange(dash.getRange(7, 1, holding.length, 2))
      .setPosition(7, 4, 10, 10)
      .setOption('title', '各品項在庫積壓資金 (TWD)')
      .setOption('legend', { position: 'none' })
      .build();
    dash.insertChart(chart);
  }
  dash.autoResizeColumns(1, 5);

  if (noCost.length > 0) {
    if (ui) ui.alert('⚠️ 儀表板資料異常', sloText, ui.ButtonSet.OK);  // 異常一定要讓人看到
    else Logger.log('⚠️ 儀表板資料異常:' + sloText);              // 觸發條件執行:留在執行紀錄,A5 也會變黃底
  } else {
    if (ui) ss.toast('儀表板已更新'); else Logger.log('儀表板已更新');
  }
}

🔍 驗收重點(不懂語法也能檢查) - 兩個參數(35.0、15%)是否放在最上方? - 營收是否只算 ✅ 開頭的訂單?前端入口網頁寫入的「✅ 前端網頁下單出庫」有沒有被算進去? - 找不到成本時,是停下來告警,還是偷偷用 0 繼續算?(noCost 那段) - 毛利率是除以營收,不是除以成本(第 1.1 節)。

5. 安裝與執行

  1. 打開第 4.2 節的 ERP 試算表,進入【擴充功能】→【Apps Script】。
  2. 如果你的專案用的是範例程式 ERP_Full_System.js 完整版,模組 7 和兩個常數 DASH_FX_RATE、DASH_MARGIN_SLO 都已經在裡面(常數在檔案最上方的「商業規則」區),不用再貼,直接跳到步驟 3。如果是自己一路貼上來的專案:找到原本的 generateExecutiveDashboard 函式,只把函式本體整段替換;兩個常數先用 Ctrl+F 搜尋,已經存在就只改數值,不要重複貼上。同一個專案裡不能有兩個同名函式或兩個同名常數:同名函式會讓你搞不清楚哪一個被執行,同名常數(const)則會讓整個專案載入失敗、所有選單都不能用(第 6.1 節的開場就是這樣出事的)。
  3. 存檔,回到試算表重新整理。
  4. 點選【🏬 跨國進銷存 ERP】→【📊 一鍵產製總裁營運儀表板 (模組 7)】。
  5. 核對「總裁儀表板」分頁:
儲存格 預期內容
A4 NT$ 54,240
C4 NT$ 4,540 (8.4%)
E4 NT$ 269,500
A5 🛑 毛利率 8.4%,低於目標 15.0%(紅底)
A8:B10 A款 196,000|B款 42,000|C款 31,500,右側出現橫條圖

伍、跑跑看、壞給你看

每個實驗做完後重新產製儀表板;做下一個實驗前,先執行一鍵初始化還原資料。

實驗 操作 預期結果 想想看
① 訂單還沒出貨 把「銷售訂單」E3 改成「⏳ 待審核」 營收 NT$ 42,000、毛利 NT$ 2,800 (6.7%) 待審核的訂單該不該算營收?會計上何時認列收入?
② 從前端入口網頁下單 用【📱 開啟業務行動填單入口網頁】賣出 A 款 3 台、單價 4,200 營收 NT$ 66,840、毛利 NT$ 5,380 (8.0%)、在庫資金 NT$ 257,740 入口網頁寫入的狀態是「✅ 前端網頁下單出庫」。如果程式只認「出貨」兩個字,這筆會不會被漏掉?
③ 品項名稱打錯 把「庫存主檔」A3 改成「無線雙模鍵盤B款」(刪掉空格) 跳出告警,C4 顯示「⚠️ 無法計算」,A5 變黃底 如果成本被當成 0,毛利會變成 NT$ 15,040(27.7%),燈號會怎麼亮?
④ 被攔截的訂單 新增一列:SO-TEST|靜電容旗艦鍵盤 C款|20|7,560|❌ 庫存不足 (現存 5 台) 三個數字都不變 被攔下的訂單雖然不算營收,但它是不是一個值得老闆知道的訊號?

實驗 ③ 最值得記住:一個看起來很漂亮的錯誤數字,比一個「⚠️ 無法計算」危險得多。 老闆會根據 27.7% 做出錯誤決策,卻不會根據「無法計算」做任何決策。


陸、回到情境

下次經營會議,總經理打開「總裁儀表板」,一眼看到 🛑 8.4%。討論立刻從「這個月賺多少」變成「A 款要不要調價」——這才是會議應該花時間的地方。

這個儀表板還做不到的事:

限制 後果 在哪一節解決
成本用「目前的」加權成本,不是「出貨當時的」成本 補貨後重算,過去訂單的毛利也會跟著變 正式 ERP 會在出貨時把成本寫進訂單;可當成本節練習的延伸
帳務匯率寫死 35.0 匯率大幅變動時,台幣成本失真 第 1.3 節連網匯率;由財務定期更新常數
要有人按按鈕才更新 沒人按,就沒人發現異常 第 4.2 節的時間觸發器;第 6.4 節的自動異常偵測
只看累計數字,沒有趨勢 看不出是「突然變差」還是「一直很差」 第 6.4 節動態基線

本節小結

  1. 技術指標全綠不代表生意健康;可觀測性要延伸到業務指標。
  2. SLI 是量測值、SLO 是內部目標、SLA 是合約承諾;SLO 要比 SLA 嚴。
  3. 錯誤預算 = 100% − SLO;99.9% 代表每月約 43 分鐘的可停機額度。
  4. 儀表板遇到不完整的資料,要顯示「無法計算」並告警,不能給出看似正常的錯誤數字。

柒、練習

  1. 改數字(5 分鐘):財務決定把帳務匯率改成 32.0。你要改哪一行?重新產製後,毛利率與在庫資金各是多少?燈號有沒有變?(答案:毛利 NT$ 8,800 (16.2%) ✅,在庫資金 NT$ 246,400。)想一想:交易一筆都沒變,燈號卻翻轉了,帳務匯率應該由誰決定?
  2. 加功能(20 分鐘):老闆想多看一個數字「低於安全庫存的品項數」(比較 B 欄即時庫存與 D 欄安全庫存,B ≤ D 就算一項)。請先在第參段規格表加一列,再修改 Prompt 讓 AI 產生新版程式碼。用預設資料驗證:答案應該是 2(B 款、C 款)。
  3. 管理反思(討論):一家物流平台和歐洲客戶簽了「每月 API 可用率 99.99%」的 SLA,某月因雲端廠商故障停機 2 小時,當月可用率只剩約 99.72%。(a) 99.99% 每月只容許約 4 分鐘停機,這個 SLA 一開始簽得合理嗎?(b) 如果由你重新談約,SLO 和 SLA 各要訂多少?(c) 除了賠償服務費,還有哪些看不見的損失?

國立臺中科技大學 國際貿易系 / 企業管理系 專用教材

《現代軟體工程:商學院的 AI 系統思維與 Agent 實踐》

作者:陳俊智 博士 Dr. Chun-Chih Chen

本書章節架構改編自陳鍾誠教授(金門大學)開源課程《現代軟體工程》(github.com/ccc115a/se,MIT 授權),內容針對商學院全面改寫與擴充。