Chuyển đến nội dung chính
Kết nối một Redis server, như Redis tự host, Upstash hoặc Redis Cloud, để agent CloudThinker kiểm tra bộ nhớ và eviction, tìm các key lớn nhất và các key không có TTL, liệt kê client và đọc độ trễ lệnh. Bạn cung cấp cho CloudThinker một URL kết nối (REDIS_URL): agent chạy được các lệnh mà ACL của user đó cho phép, và các công cụ ghi của kết nối luôn đi qua Approvals trước.

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

  • Một Redis endpoint mà CloudThinker truy cập được từ internet. Agent kết nối từ CloudThinker Cloud, nên localhost và địa chỉ private được phân giải ở phía CloudThinker, không phải trong mạng của bạn. Không có tùy chọn private link, nên các dịch vụ chỉ chạy trong VPC như Amazon ElastiCache và MemoryDB không kết nối được. Xem Truy cập dịch vụ private.
  • Redis 6 trở lên nếu bạn muốn dùng một ACL user riêng. Các phiên bản cũ hơn chỉ hỗ trợ một password dùng chung.
  • Quyền admin để chạy ACL SETUSER, hoặc để tạo user trong console của nhà cung cấp dịch vụ managed.

Thiết lập

1

Tạo user chỉ đọc

Tạo một user chỉ đọc được key và chạy các lệnh chẩn đoán mà agent dùng, ngoài ra không gì khác:
--askpass hỏi password admin qua prompt, nên password không nằm trong lịch sử shell. Thêm --user <admin-user> nếu bạn không đăng nhập bằng default. Giữ dấu nháy quanh '+client|list': thiếu dấu nháy, shell sẽ hiểu | là pipe.Lưu cấu hình để giữ lại sau khi khởi động lại: chạy ACL SAVE nếu bạn dùng aclfile, hoặc CONFIG REWRITE nếu user nằm trong redis.conf.
2

Kiểm tra user là chỉ đọc

Chỉ dùng redis:// nếu server của bạn không dùng TLS. Scheme không khớp với server sẽ báo lỗi kết nối, không phải NOPERM.Trạng thái thành công: SET thất bại với NOPERM, còn INFO memory in ra thống kê bộ nhớ.
3

Mở quyền truy cập mạng

Cho phép kết nối vào port Redis từ egress IP của CloudThinker trong tường lửa, security group hoặc allowlist của nhà cung cấp. 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 liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi. Port mặc định là 6379, 6380 với Azure TLS, còn trên Redis Cloud thì mỗi database được cấp một port riêng. Với Redis tự host, hãy đảm bảo bind trong redis.conf không chỉ có 127.0.0.1.
4

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, chọn Redis, rồi nhấn Connect trên bảng chi tiết. Trong hộp thoại, bạn có thể đổi Alias và Description nếu muốn. Dán URL vào REDIS_URL và nhấn Connect:
Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi Connected. Sau đó CloudThinker chạy Discovery một lần: một lượt xem chỉ đọc trên server, kết quả hiện trong mục Discovery của bảng chi tiết kết nối.

Chi tiết kết nối

Mã hóa URL các ký tự đặc biệt trong password (@ thành %40).

Quyền yêu cầu

Giữ user ở chế độ chỉ đọc. ACL chỉ đọc chặn mọi thao tác ghi ngay tại Redis, bất kể thao tác đó đã được phê duyệt hay chưa.

Khả năng của agent

Xác minh kết nối

Kết quả mong đợi: bộ nhớ đã dùng và mức đỉnh, số client, chính sách maxmemory, và số key của từng database index. Lỗi NOPERM sẽ nêu tên lệnh còn thiếu. Thêm lệnh đó bằng ACL SETUSER cloudthinker-readonly, rồi hỏi lại.

Ví dụ prompt

Quyền ghi

Kết nối Redis có công cụ ghi. Nếu ACL cho phép ghi, mỗi thao tác ghi đều đi qua Approvals trước, và một rule có thể yêu cầu hỏi trước hoặc từ chối thao tác đó. 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.

Khắc phục sự cố

User hoặc password sai hoặc bị thiếu. Kiểm tra cả hai trong REDIS_URL, kể cả phần mã hóa URL. Trên Upstash, dùng default làm user và database token làm password. Trên Redis tự host, chạy ACL LIST để xác nhận user tồn tại và đang on.
Thường do URL sai định dạng. Kiểm tra scheme (rediss:// cho endpoint TLS, Upstash bắt buộc dùng), host, port, và URL có kèm password. URL REST hoặc SDK của nhà cung cấp sẽ không hoạt động: hãy dùng URL TCP hoặc Redis CLI.
CloudThinker không truy cập được server. Kiểm tra tường lửa, security group hoặc allowlist của nhà cung cấp, và đảm bảo bind trong redis.conf không chỉ có 127.0.0.1. Server trong mạng private cần có một endpoint truy cập được trước.
ACL thiếu một lệnh. Thêm +info, '+client|list' hoặc nhóm lệnh mà thông báo lỗi nêu tên bằng ACL SETUSER cloudthinker-readonly ..., rồi hỏi lại. NOPERM với lệnh ghi là điều bình thường đối với user chỉ đọc.
Server chưa nạp module RediSearch hoặc RedisJSON. Nhiều gói hosted không đi kèm các module này. Mọi chức năng khác vẫn hoạt động bình thường.

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 rediss://: redis:// thường gửi password và mọi giá trị dưới dạng không mã hóa. Hãy dùng TLS bất cứ khi nào server hoặc nhà cung cấp hỗ trợ.
  • Giới hạn phạm vi key: thay ~* bằng các prefix agent cần, như ~cache:*, để session token và các key nhạy cảm khác nằm ngoài tầm với.

Liên quan

MongoDB

Kết nối MongoDB hoặc Atlas ở chế độ chỉ đọc.

Approvals

Quyết định thao tác ghi Redis nào được chạy, phải chờ người duyệt hoặc bị từ chối.