Tenderduty

Bước 1. Cài Tenderduty

Giữ Go hiện có (không cần hạ xuống Go 1.18 nếu máy đang dùng bản mới tương thích).

cd $HOME
rm -rf tenderduty
git clone https://github.com/blockpane/tenderduty
cd tenderduty
go install
cp example-config.yml config.yml

Tenderduty hỗ trợ dashboard, Prometheus, Telegram, Discord, theo dõi nhiều chain và nhiều loại cảnh báo.

---

Create service

sudo tee /etc/systemd/system/tenderdutyd.service > /dev/null <<EOF
[Unit]
Description=Tenderduty Monitoring Service
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/tenderduty
ExecStart=/root/go/bin/tenderduty

Restart=always
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Start service

sudo systemctl daemon-reload
sudo systemctl enable tenderdutyd
sudo systemctl start tenderdutyd

2. Tạo Bot Telegram

Trong Telegram:

• tìm @BotFather

• gõ

/newbot

• nhập tên bot

• nhập username (phải kết thúc bằng bot)

Ví dụ:

shentu247_bot

BotFather sẽ trả về:

123456789:AAxxxxxxxxxxxxxxxxxxxx

Đây là Bot Token.

⚠️ Không chia sẻ token này công khai.

Bước 3. Tạo nhóm Telegram

Ví dụ:

Shentu Alerts

Sau đó

• thêm bot vào nhóm

• cấp quyền Admin cho bot (để bot có thể gửi tin)

---

Bước 4. Lấy Chat ID

Gửi một tin nhắn trong nhóm:

test

Sau đó chạy:

curl "https://api.telegram.org/bot<TOKEN>/getUpdates"

Ví dụ bạn đã nhận được:

"id": -5157857623

Thì:

channel: "-5157857623"

---

Bước 5. Cấu hình Telegram

Trong config.yml

telegram:  enabled: yes  
api_key: "<BOT_TOKEN>"  
channel: "-5157857623"

---

Bước 6. Cấu hình chain

Ví dụ với Shentu:

chains:  "Shentu"
chain_id: shentu-2.2    
valoper_address: shentuvaloper1xxxxxxxxxxxx

Tên "Shentu" chỉ là nhãn hiển thị trên dashboard, không bắt buộc phải trùng chain id.

---

Bước 7. Khai báo RPC

Đây là chỗ nhiều người cấu hình sai.

Trước tiên kiểm tra RPC:

ss -ltnp | grep shentud

Máy của bạn cho kết quả:

18657 RPC18656 P2P

Do đó:

nodes:  - url: tcp://localhost:18657    
alert_if_down: yes

Không để:

https://some-other-node:443

vì đó chỉ là ví dụ trong file mẫu.

---

Bước 8. Cấu hình cảnh báo

Mình khuyến nghị:

alerts:  stalled_enabled: yes  
stalled_minutes: 10  
consecutive_enabled: yes  
consecutive_missed: 5  
percentage_enabled: yes  
percentage_missed: 5  
alert_if_inactive: yes  
alert_if_no_servers: yes

Các loại cảnh báo này được Tenderduty hỗ trợ cho validator Cosmos.

---

Bước 9. Khởi động

sudo systemctl daemon-reloadsudo 
systemctl enable tenderdutydsudo 
systemctl restart tenderdutyd

---

Bước 10. Kiểm tra log

sudo journalctl -fu tenderdutyd

Nếu thấy:

watching for NewBlock

found shentuvaloper...

node localhost:18657 is healthy

thì cấu hình đã đúng.

---

Bước 11. Kiểm tra Telegram

Gửi thử:

curl -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
-d chat_id="-5157857623" \
-d text="Tenderduty Telegram test"

Nếu nhóm nhận được tin nhắn thì Telegram đã hoạt động.

Bước 12. Test thực tế

Dừng validator:

sudo systemctl stop shentud

Quan sát:

sudo journalctl -fu tenderdutyd

Tenderduty sẽ phát hiện:

• RPC down

• no usable endpoints

• validator inactive (nếu đủ điều kiện)

• miss block

Đồng thời gửi Telegram theo cấu hình.

Sau đó chạy lại:

sudo systemctl start shentud

---

Cấu hình mình khuyên dùng cho validator production

• ✅ Dashboard: bật.

• ✅ Telegram: bật.

• ❌ Discord: tắt.

• ❌ PagerDuty: tắt.

• ❌ Slack: tắt.

• ❌ Healthcheck: tắt.

• ❌ Public fallback: no (để phát hiện ngay khi RPC local có vấn đề).

• ⚠️ Prometheus: chỉ bật nếu bạn thực sự dùng Grafana/Prometheus; nếu không thì đặt prometheus_enabled: no để giảm một cổng dịch vụ không cần thiết.

Đây là cấu hình gọn, ổn định và phù hợp với một validator vận hành trên VPS như Shentu của bạn.