Điều kiện của kênh - Lọc thông báo thông minh

Điều kiện của kênh là những biểu thức mạnh mẽ quyết định khi nào thông báo được gửi đi. Bằng cách đặt điều kiện cho kênh, bạn có thể lọc thông báo dựa trên nội dung của biến hoặc HTTP header, đảm bảo người đăng ký chỉ nhận những cảnh báo thực sự liên quan. Đây là điều then chốt để giảm mệt mỏi vì cảnh báo và giữ tỷ lệ tín hiệu trên nhiễu ở mức cao trong hệ thống thông báo của bạn.

Bạn có thể hình dung điều kiện như người gác cổng cho thông báo - chúng đánh giá dữ liệu kích hoạt đi vào và chỉ cho thông báo đi qua khi những tiêu chí cụ thể được thỏa mãn.

Hiểu về điều kiện

Điều kiện là những biểu thức cho ra kết quả true hoặc false. Khi một kênh được kích hoạt:

Nếu điều kiện không được đặt (để trống), thông báo sẽ được gửi tới toàn bộ người đăng ký.
Nếu điều kiện được đặt, thông báo chỉ được gửi khi biểu thức cho kết quả true.

Viết điều kiện

Điều kiện được viết dưới dạng biểu thức, không có cặp {{}} bao quanh như khi dùng trong mẫu. Ví dụ:

status == "active"

Điều kiện này chỉ cho phép gửi thông báo khi biến status bằng "active".

Các trường hợp sử dụng phổ biến

Dưới đây là vài ví dụ thực tế về cách bạn có thể dùng điều kiện:

Kiểm tra biến cơ bản

amount > 100

Chỉ thông báo khi biến "amount" lớn hơn 100.

message != ""

Chỉ thông báo khi biến "message" không rỗng.

isUrgent == true

Chỉ thông báo khi biến "isUrgent" là true.

Kiểm tra HTTP header

Bạn có thể truy cập HTTP header bằng biến đặc biệt header:

header["x-webhook-source"] == "grafana"

Chỉ thông báo khi header nguồn tùy chỉnh khớp chính xác với "grafana".

header["content-type"] == "application/json"

Chỉ thông báo khi kiểu nội dung là JSON.

header["x-priority"] == "high"

Chỉ thông báo khi header ưu tiên tùy chỉnh được đặt là "high".

Mọi khóa trong header đều là chữ thường.

Điều kiện phức tạp

Bạn có thể kết hợp nhiều điều kiện bằng toán tử logic:

(temperature > 30 || pressure > 100) && status == "monitoring"

Chỉ thông báo khi nhiệt độ vượt 30 hoặc áp suất vượt 100, và trạng thái là "monitoring".

environment == "production" && (errorLevel == "critical" || errorLevel == "high")

Chỉ thông báo cho những lỗi ở mức critical hoặc high trong môi trường production.

Các toán tử được hỗ trợ

Những toán tử sau được hỗ trợ trong biểu thức điều kiện:

Toán tử	Mô tả	Ví dụ
`==`	Bằng	`status == "active"`
`!=`	Khác	`status != "inactive"`
`!`	Phủ định logic	`!isCompleted`
`<`	Nhỏ hơn	`count < 10`
`>`	Lớn hơn	`price > 99.99`
`<=`	Nhỏ hơn hoặc bằng	`battery <= 20`
`>=`	Lớn hơn hoặc bằng	`confidence >= 0.95`
`&&`	VÀ logic	`isAdmin && isActive`
`\|\|`	HOẶC logic	`isError \|\| isWarning`

Biến dùng trong điều kiện

Khi một kênh được kích hoạt qua webhook, bạn có thể truy cập:

Tham số query từ URL
Body JSON từ request POST
HTTP header thông qua object header

Với kích hoạt qua email, bạn có thể truy cập:

from: Địa chỉ email người gửi
to: Địa chỉ email người nhận
subject: Tiêu đề email
text: Nội dung body dạng văn bản thuần
html: Nội dung body dạng HTML

Biến thời gian hệ thống (UTC)

Những biến chỉ đọc này luôn có sẵn cả trong điều kiện lẫn trong mẫu. Mọi giá trị đều được tính theo UTC.

Các giá trị sau được đưa vào trực tiếp (dạng phẳng) và có thể dùng theo tên:

year: Năm 4 chữ số (dạng số)
month: Số tháng 1–12
dayOfMonth: Ngày trong tháng 1–31
dayOfWeek: Thứ trong tuần 0–6 (Chủ nhật = 0)
hour: Giờ trong ngày 0–23
minute: Phút 0–59
second: Giây 0–59
date: Chuỗi YYYY-MM-DD
time: Chuỗi HH:mm:ss
iso: Thời gian hiện tại dạng chuỗi ISO‑8601 (ví dụ: 2025-05-06T12:34:56.789Z)

Một số giá trị khác chỉ có trong không gian tên sys. (chúng không được đưa vào dưới dạng tên phẳng):

sys.timezone: Chuỗi hằng "UTC"
sys.now: Thời gian hiện tại dạng chuỗi ISO‑8601 (cùng giá trị với iso)
sys.epochMs: Số mili giây tính từ mốc Unix epoch (dạng số)
sys.epochSeconds: Số giây tính từ mốc Unix epoch (dạng số)
sys.monthName: Tên tháng January–December
sys.dayOfWeekName: Tên thứ Sunday–Saturday

Không gian tên sys. cũng phản chiếu mọi giá trị phẳng (ví dụ sys.year, sys.hour).

Ví dụ:

// Ngày trong tuần, từ 09:00–17:00 UTC
hour >= 9 && hour < 17 && dayOfWeek >= 1 && dayOfWeek <= 5

// Chỉ cuối tuần
dayOfWeek == 0 || dayOfWeek == 6

// Ngày đầu tháng, đúng đầu giờ
dayOfMonth == 1 && minute == 0

Thực hành tốt nhất

Bắt đầu đơn giản

Hãy bắt đầu với điều kiện cơ bản rồi tăng dần độ phức tạp khi cần:

Giai đoạn 1: Bắt đầu với một điều kiện duy nhất

temperature > 30

Giai đoạn 2: Thêm toán tử logic

temperature > 30 && location == "server-room"

Giai đoạn 3: Thêm logic lồng nhau

(temperature > 30 || humidity > 80) && location == "server-room" && status == "monitoring"

Kiểm thử kỹ lưỡng

Hãy thử điều kiện với nhiều dữ liệu đầu vào khác nhau để đảm bảo chúng hoạt động đúng như mong đợi:

Thử với giá trị bình thường - Xác nhận điều kiện hoạt động trong những tình huống dự kiến
Thử các trường hợp biên - Chuyện gì xảy ra khi giá trị đúng bằng ngưỡng?
Thử khi thiếu biến - Điều kiện xử lý dữ liệu vắng mặt ra sao?
Thử với kiểu dữ liệu bất ngờ - Nếu một con số được gửi dưới dạng chuỗi thì sao?
Dùng webhook thử nghiệm - Gửi các lần kích hoạt thử với những tổ hợp dữ liệu khác nhau

Ghi chú lại điều kiện của bạn

Hãy thêm chú thích vào ô ghi chú của kênh để giải thích những điều kiện phức tạp:

Ghi chú kênh:
Điều kiện: (cpu > 80 && memory > 90) || diskSpace < 10

Điều kiện này kích hoạt cảnh báo khi:
- CPU trên 80% VÀ bộ nhớ trên 90%
- HOẶC khi dung lượng đĩa trống tụt dưới 10GB

Nhờ vậy các thành viên trong nhóm hiểu được logic cảnh báo mà không phải ngồi phân tích biểu thức.

Lưu ý các trường hợp biên

Hãy tính đến những biến bị thiếu hoặc giá trị bất ngờ:

Biến bị thiếu: Biến chưa được định nghĩa sẽ được đánh giá là rỗng/false - hãy đảm bảo logic của bạn xử lý được điều đó
So sánh số học: <, >, <= và >= chuyển cả hai toán hạng bằng Number(), nên chúng so sánh theo giá trị số chứ không theo thứ tự từ điển. "100" > "20" là true (100 > 20), chứ không theo thứ tự từ điển.
Giá trị không phải số: Nếu một trong hai vế của phép so sánh <, >, <= hay >= không phải là số, Number() sẽ cho ra NaN và phép so sánh luôn là false.
Bằng nhau so với so sánh thứ tự: == và != dùng phép so sánh bằng lỏng (nên count == "5" khớp với số 5), còn các toán tử so sánh thứ tự thì luôn so sánh dưới dạng số.
Phân biệt chữ hoa chữ thường: status == "Active" khác với status == "active"

Ngăn bão cảnh báo

Hãy dùng điều kiện để tránh những loạt thông báo dồn dập vì các sự cố thoáng qua:

errorCount > 5    # Chứ không phải chỉ errorCount > 0
cpuUsage > 90     # Chứ không phải cpuUsage > 50
failureRate > 0.1 # Chứ không phải chỉ hasFailures

Hãy kết hợp với những ngưỡng phù hợp để giảm nhiễu mà không bỏ lỡ sự kiện quan trọng.

Lọc theo giờ làm việc

Hãy kết hợp mức nghiêm trọng với điều kiện theo thời gian:

severity == "critical" || (severity == "high" && hour >= 9 && hour < 17)

Cách này gửi cảnh báo nguy cấp 24/7, còn cảnh báo mức ưu tiên cao thì chỉ trong giờ làm việc.

Tận dụng việc kiểm tra header

Hãy xác thực nguồn gửi webhook để chặn spam hoặc những lần kích hoạt trái phép:

header["x-webhook-source"] == "grafana" || header["x-webhook-source"] == "prometheus"

Cách này thêm một lớp bảo mật bằng việc kiểm tra nguồn gốc của request.

Ví dụ thực tế

Giám sát máy chủ - Cảnh báo theo mức độ

# Chỉ cảnh báo khi CPU cao kéo dài, không phải những lần tăng vọt thoáng qua
cpu > 80 && duration >= 300

Thương mại điện tử - Đơn hàng giá trị cao

# Chỉ thông báo với đơn trên $500 hoặc đơn bị gắn cờ gian lận
orderAmount > 500 || isFraudSuspected == true

Phát triển - Lỗi build nghiêm trọng

# Chỉ cảnh báo khi nhánh chính lỗi hoặc triển khai thất bại
(branch == "main" || branch == "master") && status == "failed"

IoT - Giám sát môi trường

# Nhiệt độ vượt ra ngoài khoảng chấp nhận được
temperature < 15 || temperature > 28

Bảo mật - Đăng nhập thất bại

# Nhiều lần đăng nhập thất bại từ cùng một IP trong thời gian ngắn
failedAttempts >= 3 && timeSinceFirst < 300

CI/CD - Theo dõi triển khai

# Chỉ thông báo khi deploy lên production hoặc khi staging thất bại
(environment == "production") || (environment == "staging" && status == "failed")

Giao dịch - Cảnh báo giá

# Biến động giá đáng kể vượt ngưỡng
(priceChange > 5 || priceChange < -5) && volume > 1000000

Hỗ trợ - Vi phạm SLA

# Ticket sắp chạm hoặc đã vượt SLA
ticketAge > slaThreshold || priority == "urgent"

Các mẫu hình điều kiện thường gặp

Cảnh báo theo ngưỡng

value > threshold
percentage >= 90
count < minimumRequired

Lọc theo trạng thái

status == "error" || status == "critical"
state != "healthy"
isActive == true

Lọc theo khung thời gian

# Chỉ trong giờ làm việc (9 giờ sáng - 5 giờ chiều UTC, thứ Hai đến thứ Sáu)
hour >= 9 && hour < 17 && dayOfWeek >= 1 && dayOfWeek <= 5

# Chỉ ngoài giờ làm việc
hour < 9 || hour >= 17 || dayOfWeek == 0 || dayOfWeek == 6

# Khung bảo trì cuối tuần
(dayOfWeek == 0 || dayOfWeek == 6) && hour >= 2 && hour < 6

Điều kiện đa yếu tố

# Kết hợp nhiều tiêu chí
severity == "high" && environment == "production" && region == "us-east-1"

# Hoặc mức critical, hoặc production với mức nghiêm trọng cao
severity == "critical" || (severity == "high" && environment == "production")

So khớp chuỗi

# Khớp chính xác (không có toán tử "contains")
status == "error"
errorType == "database"

# So sánh chuỗi
environment == "production"
username != "test-user"

Kết hợp điều kiện với mẫu

Điều kiện và mẫu phối hợp với nhau để tạo ra những thông báo thông minh, đúng bối cảnh:

Điều kiện (lọc xem lần kích hoạt nào được gửi thông báo):

temperature > 30 || humidity > 80

Mẫu (định dạng nội dung thông báo):

Title: {{location}} Environment Alert
Body: Temp: {{temperature}}°C, Humidity: {{humidity}}%

Sự tách bạch này cho phép bạn:

Lọc những thông báo không mong muốn bằng điều kiện
Định dạng những thông báo quan trọng bằng mẫu
Điều chỉnh nội dung thông báo theo mức độ nghiêm trọng

Tìm hiểu thêm về cú pháp và tính năng của mẫu.

Gỡ lỗi điều kiện

Nếu điều kiện không hoạt động như mong đợi:

Đơn giản hóa điều kiện - Thử từng phép so sánh một
Kiểm tra tên biến - Đảm bảo chúng khớp chính xác (phân biệt chữ hoa chữ thường)
Kiểm tra kiểu dữ liệu - Dùng webhook thử nghiệm để xác nhận kiểu của biến
Thử logic boolean - Tách điều kiện phức tạp thành từng phần nhỏ
Xem lại thứ tự ưu tiên của toán tử - Dùng dấu ngoặc để làm rõ ý định
Kiểm tra lỗi gõ - Phải là header["content-type"] chứ không phải header["Content-Type"]

Tài liệu liên quan

Hướng dẫn về mẫu - Định dạng nội dung thông báo bằng biến
Tích hợp Webhook - Truyền biến qua HTTP request
Kích hoạt qua Email - Những biến có được từ kích hoạt qua email
Bắt đầu - Thiết lập kênh có điều kiện đầu tiên của bạn

Bước tiếp theo

Giờ bạn đã hiểu về điều kiện:

Tạo cảnh báo giám sát thông minh - Lọc cảnh báo hạ tầng
Thiết lập thông báo CI/CD - Chỉ cảnh báo với những sự kiện build quan trọng
Cấu hình cảnh báo theo thời gian - Lọc theo giờ làm việc
Khám phá mọi tính năng - Xem Echobell còn làm được những gì

Nếu dùng điều kiện một cách hiệu quả, bạn có thể giảm nhiễu thông báo và đảm bảo người đăng ký chỉ nhận những cảnh báo thực sự liên quan và có thể hành động được với họ. Hãy bắt đầu bằng những điều kiện đơn giản, rồi dần dần xây dựng logic lọc tinh vi hơn khi nhu cầu của bạn thay đổi.