Chuyển đến nội dung chính
Webhook cho phép CloudThinker đẩy sự kiện đến các hệ thống bên ngoài của bạn theo thời gian thực, hỗ trợ tự động hóa, tích hợp và các quy trình làm việc tùy chỉnh.

Webhook hoạt động như thế nào

1

Cấu hình

Tạo một webhook endpoint với URL đích và chọn các sự kiện cần đăng ký
2

Kích hoạt

Khi các sự kiện đã đăng ký xảy ra, CloudThinker chuẩn bị payload webhook
3

Gửi đi

CloudThinker gửi một HTTP POST request đến endpoint của bạn kèm dữ liệu sự kiện
4

Xử lý

Hệ thống của bạn nhận và xử lý webhook, trả về phản hồi thành công

Tạo webhook

Từ giao diện console

  1. Điều hướng đến Settings > Webhooks
  2. Nhấp Create Webhook
  3. Cấu hình webhook:
    • Name: Tên định danh mô tả
    • URL: URL endpoint của bạn (phải là HTTPS)
    • Events: Chọn các sự kiện cần đăng ký
    • Secret: Secret tùy chọn để xác minh chữ ký
  4. Lưu và kiểm tra

Cấu hình webhook


Loại sự kiện

Đăng ký các sự kiện trên CloudThinker:

Sự kiện đề xuất

Sự kiện sự cố

Sự kiện bảo mật

Sự kiện tác vụ

Sự kiện agent

Sự kiện tài nguyên


Payload webhook

Mỗi webhook bao gồm một payload chuẩn hóa:

Các trường payload


Bảo mật

Xác minh chữ ký

Khi bạn cấu hình webhook secret, CloudThinker ký mỗi payload:
Xác minh chữ ký trong endpoint của bạn:

Cho phép IP

Webhook CloudThinker xuất phát từ các dải IP đã biết. Liên hệ hỗ trợ để lấy danh sách IP hiện tại và cấu hình quy tắc tường lửa.

Chỉ HTTPS

URL webhook phải sử dụng HTTPS. Chứng chỉ tự ký không được hỗ trợ trong môi trường production.

Logic thử lại

CloudThinker thử lại các lần gửi webhook thất bại:

Lịch trình thử lại

Tiêu chí thành công

Một lần gửi được coi là thành công khi endpoint của bạn trả về:
  • HTTP status code 2xx
  • Phản hồi trong vòng 30 giây

Xử lý thất bại

Sau khi tất cả các lần thử đều thất bại:
  • Sự kiện được đánh dấu là thất bại
  • Thông báo được gửi (nếu đã cấu hình)
  • Sự kiện có sẵn trong nhật ký webhook

Quản lý webhook

Kiểm tra webhook

Kiểm tra việc gửi webhook trước khi đưa vào production:
  1. Chọn webhook trong cài đặt
  2. Nhấp Send Test Event
  3. Chọn loại sự kiện
  4. Xem lại trạng thái gửi và payload

Xem nhật ký

Theo dõi hoạt động webhook:
  1. Điều hướng đến Settings > Webhooks > Logs
  2. Xem các lần gửi
  3. Xem chi tiết request/response
  4. Lọc theo trạng thái, loại sự kiện, ngày

Tạm dừng webhook

Tạm thời vô hiệu hóa webhook:
  1. Chọn webhook
  2. Tắt Active
  3. Các sự kiện trong thời gian tạm dừng không được xếp hàng

Mẫu webhook

Sử dụng mẫu cho các tích hợp phổ biến:

Slack

Đăng sự kiện lên các kênh Slack:

Jira

Tạo ticket Jira từ sự kiện CloudThinker:

PagerDuty

Kích hoạt sự cố PagerDuty:

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

Sử dụng webhook secret và xác minh chữ ký để đảm bảo request xuất phát từ CloudThinker.
Trả về phản hồi 2xx ngay lập tức, sau đó xử lý sự kiện bất đồng bộ. Độ trễ xử lý kéo dài gây ra timeout.
Các lần gửi webhook đôi khi có thể bị trùng. Sử dụng id của sự kiện để loại bỏ trùng lặp ở phía bạn.
Thiết lập cảnh báo cho các webhook thất bại. Điều tra và khắc phục sự cố kịp thời để tránh bỏ lỡ sự kiện.
Chỉ đăng ký các sự kiện bạn cần. Giảm nhiễu và chi phí xử lý.

Ví dụ tích hợp

GitHub Actions

Kích hoạt quy trình làm việc từ sự kiện CloudThinker:

AWS Lambda

Xử lý webhook bằng serverless function:

Liên quan

Webhook sự cố

Webhook đầu vào từ PagerDuty, Datadog, Prometheus và nhiều hơn nữa để tự động kích hoạt phân tích nguyên nhân gốc rễ

Tasks & Scheduling

Lên lịch các hoạt động định kỳ và tạo quy trình theo sự kiện

Thông báo

Cấu hình định tuyến cảnh báo cho đề xuất, sự cố và phát hiện bảo mật

Agent tự trị

Để agent tự động hành động theo sự kiện webhook mà không cần xem xét thủ công