Cách Giám Sát Máy Đào Bằng API NoxHash Tự Động

Tại Sao Nên Giám Sát Máy Đào Qua API Thay Vì Dashboard

Dashboard web NoxHash được thiết kế cho con người: bạn đăng nhập, liếc nhìn hashrate và số dư BTC, rồi đăng xuất. Điều đó hiệu quả với một hoặc hai máy đào. Một khi bạn vận hành nhiều hợp đồng thuê — hoặc bạn muốn nhận cảnh báo khi có sự cố lúc 3 giờ sáng — bạn cần một cỗ máy canh chừng thay bạn.

Một hệ thống giám sát API nằm ngoài dashboard và kéo cùng dữ liệu theo lịch định kỳ. Nó có thể ghi thu nhập vào bảng tính, đẩy metric vào Grafana, hoặc nhắn tin cho bạn ngay khi một máy đào tụt offline. Bạn sở hữu logic, nên bạn quyết định chính xác khi nào được thông báo và cái gì được tính là "vấn đề".

Bước 1 — Tạo API Key Trong Tài Khoản NoxHash

Mỗi lệnh gọi API đều cần danh tính đã xác thực. NoxHash phát hành API key cá nhân từ phần cài đặt tài khoản, và bạn có thể đặt ngày hết hạn để một key bị rò rỉ tự động ngừng hoạt động.

Bước 2 — Một Script Python Giám Sát Tối Thiểu (Giả mã)

Đây là một script Python nhỏ, dễ đọc, xác thực, lấy danh sách máy đào, và gắn cờ những máy đã offline hơn 30 phút. Nó được giữ đơn giản có chủ đích — không phụ thuộc gì ngoài requests — nên bạn có thể thả vào cron job hôm nay và củng cố vào ngày mai.

import os, time, requests
from datetime import datetime, timedelta, timezone

API_BASE = "https://api.noxhash.com/v1"   # confirm in current docs
API_KEY  = os.environ["NOXHASH_API_KEY"]  # never hard-code
OFFLINE_THRESHOLD = timedelta(minutes=30)

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Accept": "application/json",
}

def fetch_miners():
    r = requests.get(f"{API_BASE}/miners", headers=headers, timeout=10)
    r.raise_for_status()
    return r.json().get("data", [])

def check_offline(miners):
    now = datetime.now(timezone.utc)
    alerts = []
    for m in miners:
        if m["status"] != "running":
            last_seen = datetime.fromisoformat(m["last_seen_at"])
            if now - last_seen > OFFLINE_THRESHOLD:
                alerts.append(m)
    return alerts

def send_sms(miner):
    # plug in Twilio / Vonage / a webhook to your phone
    print(f"ALERT: {miner['name']} offline since {miner['last_seen_at']}")

if __name__ == "__main__":
    while True:
        try:
            for miner in check_offline(fetch_miners()):
                send_sms(miner)
        except requests.HTTPError as e:
            print(f"API error: {e}")
        time.sleep(300)  # poll every 5 minutes — be kind to the API

Thích JavaScript hơn? Cùng hình dạng đó hoạt động với fetch trong một script Node.js, lên lịch bằng cron runner hoặc serverless scheduler. Logic giống hệt: xác thực, liệt kê máy đào, lọc theo status và timestamp, thông báo.

const API_BASE = "https://api.noxhash.com/v1";
const API_KEY  = process.env.NOXHASH_API_KEY;
const OFFLINE_MS = 30 * 60 * 1000;

async function fetchMiners() {
  const res = await fetch(`${API_BASE}/miners`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = await res.json();
  return data;
}

function offlineAlerts(miners) {
  const now = Date.now();
  return miners.filter(m =>
    m.status !== "running" &&
    now - new Date(m.last_seen_at).getTime() > OFFLINE_MS
  );
}

setInterval(async () => {
  try {
    const alerts = offlineAlerts(await fetchMiners());
    alerts.forEach(m => console.log(`ALERT: ${m.name} offline`));
  } catch (e) { console.error(e.message); }
}, 5 * 60 * 1000);

Ba Use Case Đáng Xây Dựng Đầu Tiên

Bạn không cần xây dựng mọi thứ trong ngày đầu. Chọn một trong những cái này và ship vào cuối tuần này — mỗi cái đủ nhỏ cho một buổi tối và thực sự hữu ích vào sáng thứ Hai.

Polling vs Webhook — Mẫu Nào Phù Hợp?

Polling nghĩa là script của bạn hỏi API "có gì mới?" theo bộ đếm giờ. Webhook đảo ngược dòng: NoxHash đẩy sự kiện tới một URL bạn host. Cả hai đều có chỗ đứng. Nếu API hiện hỗ trợ webhook cho các sự kiện bạn quan tâm, chúng rẻ hơn và nhanh hơn; nếu không, một vòng polling lịch sự vẫn hoạt động tốt.

Một giải pháp lai thường là câu trả lời đúng: webhook cho cảnh báo quan trọng (máy đào offline, thuê sắp hết hạn), polling cho tóm tắt định kỳ (log thu nhập hàng ngày, báo cáo hàng tuần). Chọn dựa trên sự kiện nào API cung cấp và bạn chịu được độ trễ 1 đến 5 phút ở mức nào.

Phép Lịch Sự Với Rate Limit và Vệ Sinh Key

Một API bị bạn lạm dụng là một API bạn sẽ mất. NoxHash, giống như mọi nền tảng nghiêm túc, áp dụng rate limit và có thể tạm chặn các key hành xử xấu. Vài thói quen nhỏ giữ cho tích hợp của bạn được hoan nghênh và tài khoản an toàn.

Câu Hỏi Thường Gặp