Chuyển đến nội dung chính
Kết nối RabbitMQ broker để CloudThinker cho bạn biết queue nào đang ùn ứ, queue nào không có consumer, dead-letter queue đang chứa gì, và node nào đang trong trạng thái alarm. Kết nối đăng nhập bằng username và password của broker qua Management HTTP API, chính API mà giao diện quản trị RabbitMQ sử dụng. Bạn không cần thay đổi code.

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: 15672 cho HTTP, thường là 15671 cho 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 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.
Ba chuỗi quyền lần lượt là configure, write và read. Để trống configure và write, đặt read là .* 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 <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:
Khi bật TLS, dù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
RABBITMQ_ALLOW_MUTATIONS mặc định là Allow writes. Chuyển sang Read-only trước khi nhấn Connect. Bản thân user của broker không chặn được mọi thao tác ghi: user chỉ có quyền read vẫn purge được queue, và purge xóa vĩnh viễn message trong queue. Read-only giữ các công cụ purge và xóa ngoài tầm của agent.
Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi Connected. Nếu xác minh thất bại, kết nối hiển thị Failed kèm thông báo lỗi. Đối chiếu thông báo với Khắc phục sự cố.

Chi tiết kết nối

Quyền yêu cầu

Bắt đầu với monitoring, quyền read, và RABBITMQ_ALLOW_MUTATIONS đặt là Read-only. Như vậy là đủ cho mọi khả năng đọc bên dưới. Chỉ chuyển sang Allow writes khi bạn đã quyết định cho agent purge hoặc xóa, và chỉ thêm quyền configure trên những vhost agent được phép xóa. Chỉ dùng administrator khi bạn cần cập nhật definition hàng loạt.

Khả năng của agent

Xác minh kết nối

Kết quả mong đợi gồm từng node với trạng thái chạy, rồi bảng queue với số message ready, unacknowledged và số consumer của mỗi queue.

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)
Mỗi thao tác đi qua Approvals riêng, còn thao tác đọc không bao giờ cần phê duyệt. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Purge chỉ cần quyền read trên queue, nên user của broker không chặn được. Nếu bật thao tác ghi, hãy chọn Manual để có người phê duyệt mọi thay đổi: đây là cơ chế kiểm soát dùng được ngay hôm nay. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể thu hẹp việc chờ duyệt chỉ còn các lần purge.
Purge hoặc xóa queue sẽ xóa vĩnh viễn message trong queue. RabbitMQ không giữ bản sao nào. Kiểm tra tên queue và vhost trong yêu cầu phê duyệt trước khi duyệt.

Khắc phục sự cố

  • 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.
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.
  • Kiểm tra lại username và password.
  • Xác nhận user có tag management: rabbitmqctl set_user_tags cloudthinker monitoring. User không có tag vẫn đăng nhập được qua AMQP nhưng bị management API từ chối.
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).
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.
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.
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 cloudthinker cho kết nối này. Không bao giờ dùng lại guest hoặ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.