Đây là luồng dữ liệu một chiều: hiện chưa có kết nối API tới PagerDuty. Xem Khả năng của agent để biết điều này loại trừ những gì.
Điều kiện tiên quyết
- Vai trò Admin trong workspace CloudThinker. Chỉ Admin của workspace mới tạo hoặc sửa được webhook.
- Quyền thêm webhook trong PagerDuty tại Integrations → Generic Webhooks (v3).
- Một service PagerDuty mà bạn có thể kích hoạt sự cố thử.
- Kết nối tới các hệ thống phía sau service của bạn, như AWS hoặc Datadog, nếu bạn muốn RCA truy vấn các hệ thống đó.
Thiết lập
1
Tạo webhook trong CloudThinker
Vào Resolve → Triggers & Outcomes và chọn PagerDuty. Trong Signals to Resolve, nhấn Add signal. Hộp thoại Create Webhook mở ra với preset PagerDuty.Ở Basic Info, giữ nguyên hoặc đổi Webhook Name rồi nhấn Next. Ở Configure, tự tay đổi Service Path từ giá trị preset
event.data.service.name thành event.data.service.summary. Event v3 của PagerDuty đặt tên service trong summary, và preset không tự đặt giá trị này cho bạn. Giữ nguyên phần còn lại của Field Mapping và Severity Mapping, rồi nhấn Next.2
Giữ nguyên cài đặt chữ ký của PagerDuty
Ở Advanced, Auth Method đã là HMAC Signature với HMAC Signature Header đặt thành
X-PagerDuty-Signature. Giữ nguyên cả hai. Tạm để trống Provider signing secret. Giữ Auto-investigate bật cho lần thử đầu tiên, để sự cố thử nhận được RCA, rồi nhấn Create.Sao chép Webhook URL từ hộp thoại vừa mở. Bạn không cần secret hiển thị trong hộp thoại, vì PagerDuty ký bằng secret của riêng mình.3
Thêm webhook trong PagerDuty
Trong PagerDuty, vào Integrations → Generic Webhooks (v3) và nhấn New Webhook. Dán Webhook URL của CloudThinker. Đặt Scope Type là Service (hoặc Account) và chọn Scope có các sự cố bạn muốn gửi. Sau đó chọn các event sau:
incident.triggeredincident.acknowledgedincident.resolved
4
Dán secret của PagerDuty vào CloudThinker
Quay lại Resolve → Triggers & Outcomes → PagerDuty, tìm webhook của bạn trong Signals to Resolve. Mở menu (⋯), nhấn Edit, dán secret vào Provider signing secret, rồi nhấn Save.Trạng thái thành công: webhook có trong danh sách Signals to Resolve, và từ giờ Resolve xác minh mọi event PagerDuty bằng secret PagerDuty của bạn.
Chi tiết kết nối
Preset PagerDuty ánh xạ các trường sau từ payload webhook v3 của PagerDuty:
Severity Mapping chuyển các giá trị PagerDuty gửi sang năm mức độ nghiêm trọng của CloudThinker. Incident event mang mức ưu tiên của sự cố (
P1 tới P5) trong priority.summary. Các hàng critical, error, warning và info chỉ khớp nếu bạn trỏ Severity Path tới một trường chứa các giá trị đó.
Việc khớp giá trị không phân biệt hoa thường, nên
P1 và p1 đều ánh xạ thành critical. Sự cố chưa đặt mức ưu tiên sẽ đến với mức medium. Tên mức ưu tiên được đặt riêng cho từng tài khoản PagerDuty, nên nếu tài khoản của bạn không dùng P1 tới P5, hãy thêm chúng vào Severity Mapping.
Quyền yêu cầu
CloudThinker không cần gì từ PagerDuty ngoài các event có chữ ký. Không có API key nào cần lưu.Khả năng của agent
Từ event tới cuộc điều tra:
Theo loại event:
Xem Webhook signals để biết mọi tùy chọn của Auto-investigate, kể cả mức độ nghiêm trọng tối thiểu.
Xác minh kết nối
Kích hoạt một sự cố thử trên một service PagerDuty không phải production, rồi kiểm tra hai nơi:- Resolve → Pulse hiển thị một tín hiệu với tiêu đề sự cố PagerDuty, đúng mức độ nghiêm trọng và đúng service.
- Resolve → Investigation hiển thị sự cố. Khi cả Auto-investigate lẫn On duty đều bật, sự cố hiển thị AI is handling.
Khắc phục sự cố
PagerDuty báo gửi thất bại với lỗi 401 hoặc 403
PagerDuty báo gửi thất bại với lỗi 401 hoặc 403
Bước kiểm tra chữ ký thất bại. Kiểm tra: bạn đã dán signing secret của PagerDuty vào Provider signing secret, không phải secret của CloudThinker, và HMAC Signature Header là
X-PagerDuty-Signature. Cách sửa: sao chép lại secret từ webhook PagerDuty, sửa webhook CloudThinker, dán secret và nhấn Save.Mọi sự cố PagerDuty đều đến với mức medium
Mọi sự cố PagerDuty đều đến với mức medium
Sự cố không có mức ưu tiên, hoặc giá trị đó không có trong Severity Mapping. Cách sửa: đặt mức ưu tiên trong PagerDuty, hoặc sửa webhook và thêm một hàng ánh xạ cho giá trị PagerDuty gửi.
Tín hiệu đến mà không có service
Tín hiệu đến mà không có service
Service Path vẫn giữ giá trị preset
event.data.service.name, trường mà event v3 của PagerDuty không có, nên Resolve ghi service là unknown và Pulse không nhóm theo service được. Cách sửa: sửa webhook và đặt Service Path thành event.data.service.summary.Tín hiệu đã có trong Pulse nhưng RCA không bắt đầu
Tín hiệu đã có trong Pulse nhưng RCA không bắt đầu
Auto-investigate đang tắt, mức độ nghiêm trọng thấp hơn mức tối thiểu, hoặc On duty hiển thị Paused. Cách sửa: kiểm tra cả ba, hoặc tự bắt đầu cuộc điều tra. Xem Cài đặt Resolve.
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Chỉ nhận event có chữ ký. Giữ HMAC Signature bật để Resolve từ chối mọi event không được ký bằng secret PagerDuty của bạn.
- Xoay vòng ở cả hai phía. Khi tạo lại signing secret trong PagerDuty, hãy dán giá trị mới vào Provider signing secret ngay. Event sẽ thất bại cho đến khi bạn làm vậy.
- Xóa khi không dùng nữa. Xóa webhook trong PagerDuty và trong Resolve → Triggers & Outcomes khi bạn ngừng sử dụng. Nếu chỉ xóa phía CloudThinker, PagerDuty vẫn tiếp tục gửi các event thất bại.
Liên quan
Webhook signals
Ánh xạ trường, xác thực và các tùy chọn Auto-investigate
Kết nối Rootly
Phân loại sự cố và action item trong Rootly