Chuyển đến nội dung chính
Kết nối FireHydrant để các agent CloudThinker có thể liệt kê sự cố đang mở và gần đây, đọc cảnh báo Signals (sản phẩm cảnh báo và gọi trực của FireHydrant) và biết mỗi cảnh báo có trở thành sự cố hay không, cũng như tra cứu team nào sở hữu một dịch vụ. Kết nối dùng một API key của FireHydrant và chỉ đọc: agent không bao giờ khai báo, cập nhật, gọi trực, gán hay công bố bất cứ điều gì trong FireHydrant, kể cả khi bạn yêu cầu.

​
Điều kiện tiên quyết

  • Người dùng FireHydrant có vai trò Owner. FireHydrant chỉ cho phép Owner tạo API key.
  • Key được tạo riêng cho CloudThinker, để bạn có thể xóa key mà không làm hỏng tích hợp khác.
  • Quyền chỉnh sửa kết nối trong workspace CloudThinker của bạn.
API key của FireHydrant mang quyền Owner và không thể thu hẹp phạm vi. CloudThinker chỉ gửi yêu cầu đọc bằng key này, nhưng hãy lưu trữ và xoay vòng key như một thông tin xác thực cấp Owner.

​
Thiết lập

1

Tạo API key trong FireHydrant

Đăng nhập FireHydrant với tư cách Owner và vào Settings → API Keys. Nhấn + Create API key, đặt tên là cloudthinker, thêm mô tả như “CloudThinker read-only connection”, và nhấn Save.Sao chép token ngay. FireHydrant chỉ hiển thị token một lần, nên mất token đồng nghĩa với việc phải tạo key mới.
2

Thêm kết nối trong CloudThinker

Trong sidebar, nhấn More → Workspace settings → Connections. Trên tab Builtin Connections, tìm FireHydrant và nhấn Connect.Dán token vào API Key và nhấn Connect. CloudThinker kiểm tra key với API đọc của FireHydrant.Trạng thái thành công: kết nối hiển thị Connected, và thông báo kiểm tra nêu tên tổ chức của bạn, ví dụ FireHydrant read-only connection verified (Example Org).

​
Chi tiết kết nối

Không cần nhập region hay URL. Một key bao phủ một tổ chức FireHydrant.

​
Quyền yêu cầu

FireHydrant không có key giới hạn phạm vi: mọi key đều ở cấp Owner. Thay vào đó, CloudThinker tự giới hạn. Với kết nối này, agent chỉ có thể chạy ba lệnh đọc (discovery, sự cố và cảnh báo), và các lệnh đó chỉ đọc từ FireHydrant. CloudThinker chặn mọi lệnh khác trước khi chạy.
Dùng một key riêng tên cloudthinker và xóa key khi bạn gỡ kết nối. Xóa key chỉ dừng kết nối này.

​
Khả năng của agent

Nếu bạn yêu cầu một thay đổi, agent sẽ báo không thể thực hiện và nêu tên trang FireHydrant nơi bạn có thể làm điều đó.

​
Mặc định và giới hạn

Mỗi câu trả lời cho biết đã đọc bao nhiêu dòng và FireHydrant khớp được bao nhiêu. Khi hai con số khác nhau, hãy yêu cầu thêm dòng (tối đa 100) hoặc khoảng thời gian ngắn hơn trước khi coi câu trả lời là đầy đủ. Không có phân trang quá 100 dòng, vì vậy hãy thu hẹp khoảng thời gian, ví dụ List FireHydrant incidents from the last 30 days, up to 100 rows.

​
Xác minh kết nối

Kết nối hoạt động tốt sẽ nêu tên tổ chức của bạn và liệt kê các mức độ nghiêm trọng, như SEV1 và SEV2. Lỗi như “FireHydrant rejected the API key” nghĩa là key cần được thay.

​
Ví dụ prompt

​
Khắc phục sự cố

FireHydrant trả về 401. Key bị sao chép thiếu hoặc đã bị thu hồi. Tạo key mới trong Settings → API Keys. Trong CloudThinker, mở FireHydrant trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên dòng của tài khoản, nhấn Replace… trong Edit Instance, dán key và nhấn Save and test.
FireHydrant trả về 403. Vì key luôn ở cấp Owner, đây không phải vấn đề về quyền. Kiểm tra key vẫn tồn tại trong Settings → API Keys. Nếu đã mất, hãy tạo key mới và thay trong CloudThinker. Nếu key vẫn còn, tài khoản của tổ chức có thể đã bị tạm ngưng: hãy liên hệ bộ phận hỗ trợ FireHydrant.
FireHydrant trả về 429. Giới hạn của FireHydrant là 50 yêu cầu mỗi 10 giây, dùng chung cho mọi API key trong tổ chức, nên một tích hợp khác có thể dùng hết. Chờ một phút và kiểm tra lại.
CloudThinker hoàn toàn không thể kết nối đến FireHydrant. Kiểm tra trạng thái của FireHydrant, rồi kết nối lại.
FireHydrant trả về danh sách trống, không phải lỗi, cho một tên mức độ nghiêm trọng, mức ưu tiên hoặc team mà tài khoản của bạn không dùng. Yêu cầu agent chạy discovery trước, rồi lặp lại câu hỏi với chính xác các tên mà discovery trả về, chẳng hạn SEV1 thay vì SEV-1.

​
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.
  • Key cấp Owner. Không đưa key vào chat và repository, chỉ dán vào hộp thoại kết nối, và xóa key trong FireHydrant khi bạn gỡ kết nối.
  • Xoay vòng không gián đoạn. Tạo key mới trong FireHydrant, thay trong CloudThinker (biểu tượng bút chì → Replace… → Save and test), và xóa key cũ khi kiểm tra thành công. Xem Xoay vòng thông tin xác thực.
  • Chỉ đọc theo thiết kế. CloudThinker chỉ đọc từ FireHydrant trên kết nối này, nên một prompt nhầm lẫn không thể thay đổi sự cố.
  • Giới hạn tốc độ dùng chung. Mọi tích hợp trên tổ chức FireHydrant của bạn dùng chung một giới hạn tốc độ. Agent chạy từng thao tác đọc một để không vượt quá giới hạn.

​
Liên quan

Resolve

Điều tra sự cố và tìm nguyên nhân gốc với CloudThinker

Kết nối Rootly

Phân loại sự cố và xem xét cảnh báo trong Rootly