Nền tảng được hỗ trợ
Điều kiện tiên quyết
- Plugin management đã được bật trên broker.
- Cổng management truy cập được từ internet:
15672cho HTTP, thường là15671cho HTTPS. Cổng này khác với cổng AMQP (5672). Kết nối chạy từ CloudThinker Cloud, nên broker trong mạng riêng cần một trong các phương án ở Tiếp cận dịch vụ trong mạng riêng. - Quyền truy cập shell vào broker (
rabbitmqctl), hoặc console của nhà cung cấp, để tạo user.
Thiết lập
1
Bật plugin management
Trên broker self-hosted, chạy:Nhà cung cấp managed thường đã bật sẵn. Bỏ qua bước này nếu console của nhà cung cấp có giao diện quản trị.
2
Tạo user giám sát cho CloudThinker
Tạo một user riêng, gắn tag Ba chuỗi quyền lần lượt là configure, write và read. Để trống configure và write, đặt read là
monitoring, và cấp quyền read trên từng virtual host (vhost) mà agent cần thấy. Vhost là namespace của RabbitMQ cho queue và exchange; / là vhost mặc định..* thì user thấy được mọi thứ trong vhost, nhưng chưa hoàn toàn chỉ đọc: RabbitMQ cho phép quyền read purge một queue, nên user này vẫn có thể xóa sạch queue. Xóa queue và exchange cần quyền configure, mà user này không có. Lặp lại set_permissions cho từng vhost khác.Để agent không purge được gì, đặt RABBITMQ_ALLOW_MUTATIONS thành Read-only ở các bước tiếp theo.3
Mở đường mạng
Trong firewall hoặc security group, cho phép lưu lượng vào từ các egress IP của CloudThinker tới Khi bật TLS, dùng
<host>:15672 (hoặc cổng management TLS của bạn). Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối CloudThinker của bạn, hoặc liên hệ chúng tôi. Trên broker self-hosted, đảm bảo listener management không chỉ bind vào 127.0.0.1.Trạng thái thành công: chạy lệnh sau từ một máy bên ngoài mạng của broker. Lệnh trả về JSON có rabbitmq_version và cluster_name, chứng minh cả user mới lẫn đường mạng đều hoạt động:https://<host>:15671 thay thế.4
Thêm kết nối trong CloudThinker
Ở thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn RabbitMQ. Điền:
- RABBITMQ_USERNAME:
cloudthinker - RABBITMQ_PASSWORD: password bạn đã đặt
- RABBITMQ_HOST: chỉ hostname hoặc IP, ví dụ
rabbit.internal.example.com - RABBITMQ_MANAGEMENT_PORT:
15672, hoặc cổng management TLS của bạn - RABBITMQ_USE_TLS: Enabled nếu management API phục vụ HTTPS
- RABBITMQ_ALLOW_MUTATIONS: Read-only (khuyến nghị). Chỉ chọn Allow writes khi bạn cần các thao tác trong Quyền ghi
- LOG_LEVEL: giữ Info
Chi tiết kết nối
Quyền yêu cầu
Khả năng của agent
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Khi RABBITMQ_ALLOW_MUTATIONS đặt là Allow writes và user có đúng quyền trên vhost (xem Quyền yêu cầu), agent có thể:- Purge queue (bỏ toàn bộ message trong queue)
- Xóa queue hoặc exchange
- Áp dụng cập nhật hàng loạt cho definition của broker (cần
administrator)
Khắc phục sự cố
Kết nối bị từ chối hoặc hết thời gian chờ
Kết nối bị từ chối hoặc hết thời gian chờ
- Kiểm tra CloudThinker truy cập được
<host>:15672(hoặc cổng management TLS của bạn). - Đảm bảo bạn đã mở cổng management, không phải cổng AMQP
5672. - Trên broker self-hosted, xác nhận listener management không chỉ bind vào
127.0.0.1.
404 Not Found từ management API
404 Not Found từ management API
Plugin management đang tắt. Chạy
rabbitmq-plugins enable rabbitmq_management rồi kết nối lại. Với broker managed, kiểm tra nhà cung cấp có mở Management HTTP API cho gói của bạn không.Lỗi TLS handshake hoặc chứng chỉ
Lỗi TLS handshake hoặc chứng chỉ
RABBITMQ_USE_TLS và RABBITMQ_MANAGEMENT_PORT phải khớp nhau. Enabled cần cổng phục vụ HTTPS (thường là
15671). Disabled cần cổng HTTP thường (thường là 15672).Lỗi ở trường host
Lỗi ở trường host
Chỉ nhập hostname hoặc IP vào RABBITMQ_HOST. Bỏ mọi
http://, https://, đường dẫn hoặc :port. TLS và cổng có trường riêng.Thiếu một số queue hoặc vhost
Thiếu một số queue hoặc vhost
User thiếu quyền read trên các vhost đó. Cấp quyền bằng
rabbitmqctl set_permissions -p <vhost> cloudthinker "" "" ".*", rồi hỏi lại.Purge hoặc xóa bị từ chối
Purge hoặc xóa bị từ chối
RABBITMQ_ALLOW_MUTATIONS đang là Read-only, hoặc user của broker thiếu quyền vhost mà thao tác cần: read để purge, configure để xóa. Thay đổi đúng thiết lập bạn muốn cho phép. Thao tác vẫn đi qua Approvals của bạn.
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.
- Dùng user riêng: tạo
cloudthinkercho kết nối này. Không bao giờ dùng lạiguesthoặc tài khoản admin cá nhân. - Bật TLS: khi RABBITMQ_USE_TLS đặt là Enabled, password và dữ liệu broker được mã hóa giữa CloudThinker và broker của bạn.
Liên quan
Approvals
Quyết định lần purge và xóa nào được chạy, phải chờ người duyệt, hoặc bị từ chối.
Kafka
Kết nối Kafka để theo dõi tình trạng topic và độ trễ consumer ở phía streaming.