Checklist go-live & thuật ngữ

#!/usr/bin/env bash
# smoke-test.sh — chạy trước khi lên production. Thoát khác 0 nếu có bước hỏng.
set -euo pipefail
: "${XUNIBOX_API_KEY:?Chưa đặt biến môi trường XUNIBOX_API_KEY}"

BASE="https://xunibox.vn/api/public"
call() { curl -sS -o /tmp/xb.json -w '%{http_code}' -H "X-API-Key: $XUNIBOX_API_KEY" "$BASE$1"; }

echo "1. Readiness"        && [ "$(curl -sS -o /dev/null -w '%{http_code}' "$BASE/readyz")" = 200 ]
echo "2. Danh sách bài"    && [ "$(call '/tracks?limit=1')" = 200 ]
echo "3. Thể loại"         && [ "$(call '/genres')" = 200 ]
echo "4. Nghệ sĩ"          && [ "$(call '/artists?limit=1')" = 200 ]
echo "5. Tìm kiếm"         && [ "$(call '/search?q=nang&limit=1')" = 200 ]

ID=$(curl -sS -H "X-API-Key: $XUNIBOX_API_KEY" "$BASE/tracks?limit=1" | jq -r '.data[0].id')
echo "6. Chi tiết bài"     && [ "$(call "/tracks/$ID")" = 200 ]
echo "7. Link media tươi"  && [ "$(call "/tracks/$ID/audio-url")" = 200 ]
echo "8. Sai key trả 403"  && [ "$(curl -sS -o /dev/null -w '%{http_code}' -H 'X-API-Key: xnb_live_sai' "$BASE/me/usage")" = 403 ]

echo "✅ Tất cả bước đều đạt."

# Prometheus: scrape số liệu vận hành XuniBOX (không cần API key)
scrape_configs:
  - job_name: xunibox
    metrics_path: /api/public/metrics
    scheme: https
    scrape_interval: 60s
    static_configs:
      - targets: ["xunibox.vn"]

# Cảnh báo gợi ý
groups:
  - name: xunibox
    rules:
      - alert: XuniBoxDown
        expr: xunibox_up == 0
        for: 3m
        annotations:
          summary: "API XuniBOX không phản hồi quá 3 phút"

      - alert: XuniBoxDatabaseSlow
        expr: xunibox_database_response_seconds > 1.5
        for: 5m
        annotations:
          summary: "Kho nhạc phản hồi chậm, cân nhắc phục vụ từ cache của bạn"