Điều kiện tiên quyết
- Một endpoint PostgreSQL mà CloudThinker truy cập được từ internet, ví dụ PostgreSQL tự host, Amazon RDS hoặc Aurora, Cloud SQL, hay Azure Database for PostgreSQL. Agent kết nối từ CloudThinker Cloud, nên
localhostvà địa chỉ private được phân giải ở phía CloudThinker, không phải trong mạng của bạn. - Kết nối này chưa có tùy chọn private link hay VPN. Nếu cơ sở dữ liệu là private, hãy mở một endpoint chỉ cho phép các egress IP của CloudThinker. Mở một read replica giúp giữ primary ở chế độ private, nhưng thống kê truy vấn chỉ phản ánh workload của chính replica đó. Xem Truy cập dịch vụ private.
- Một tài khoản admin có thể chạy
CREATE ROLEvàGRANT. - Extension
pg_stat_statements, nếu bạn muốn xếp hạng truy vấn chậm và nhận tư vấn index theo workload. Mọi tính năng khác hoạt động mà không cần extension này.
Thiết lập
1
Tạo user chỉ đọc
Kết nối bằng tài khoản admin và tạo login role cho CloudThinker:
2
Cấp quyền đọc
Chạy các lệnh sau trong cơ sở dữ liệu bạn muốn phân tích. Lặp lại các dòng về schema cho mọi schema ngoài Thay
public mà agent cần đọc.app_owner bằng role tạo bảng cho ứng dụng của bạn, thường là role mà migration chạy dưới tên đó. Default privileges chỉ áp dụng cho bảng do role bạn nêu tạo ra, nên hãy lặp lại dòng này cho từng role có tạo bảng.pg_monitor cho phép agent xem mọi session, lock và thống kê truy vấn, không chỉ của riêng chúng.3
Bật pg_stat_statements
Kiểm tra trước, vì nhiều dịch vụ managed đã preload sẵn:Nếu thiếu Trạng thái thành công: khi đăng nhập bằng
pg_stat_statements, thêm vào shared_preload_libraries rồi khởi động lại PostgreSQL. Trên RDS, Aurora hoặc Cloud SQL, đặt trong parameter group hoặc database flags rồi reboot. Bỏ qua bước khởi động lại nếu extension đã có trong danh sách. Sau đó, với tài khoản admin trong cơ sở dữ liệu đích:cloudthinker_readonly, SELECT count(*) FROM pg_stat_statements; trả về một con số thay vì lỗi. Kết quả này cũng chứng minh quyền pg_monitor đã có hiệu lực.4
Mở truy cập mạng
Cho phép kết nối vào trên cổng PostgreSQL (mặc định Sau đó tải lại cấu hình bằng
5432) từ các egress IP của CloudThinker trong firewall, security group hoặc danh sách authorized networks. 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.Với PostgreSQL tự host, cũng cần cho phép cloudthinker_readonly đăng nhập từ các địa chỉ đó trong pg_hba.conf, mỗi IP một dòng:SELECT pg_reload_conf();. Dịch vụ managed tự xử lý phần này.5
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, chọn PostgreSQL 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 (agent đọc description để chọn đúng cơ sở dữ liệu khi bạn kết nối nhiều cơ sở dữ liệu). Dán URL vào DATABASE_URI rồi 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 cơ sở dữ liệu, kết quả hiển thị trong mục Discovery trên bảng chi tiết của kết nối.
Chi tiết kết nối
Biểu mẫu gắn nhãn trường URL là DATABASE_URI. Mỗi kết nối chỉ bao phủ một cơ sở dữ liệu được nêu trong URL. Để phân tích cơ sở dữ liệu khác, hãy thêm một kết nối PostgreSQL khác với Alias khác.
Nếu password chứa
@, :, / hoặc #, hãy URL-encode (ví dụ @ thành %40), nếu không URL sẽ không phân tích được.
Quyền yêu cầu
Khả năng của agent
Xác minh kết nối
permission denied nêu tên đối tượng mà user không đọc được.
Ví dụ prompt
Khắc phục sự cố
Connection refused hoặc timed out
Connection refused hoặc timed out
CloudThinker không truy cập được host. Kiểm tra host và port trong DATABASE_URI là public hoặc truy cập được bằng cách khác, firewall hoặc security group cho phép CloudThinker, và
listen_addresses trong postgresql.conf không phải localhost. Trên RDS, instance phải ở chế độ publicly accessible hoặc truy cập được qua thiết lập mạng của bạn.Password authentication failed hoặc no pg_hba.conf entry
Password authentication failed hoặc no pg_hba.conf entry
User hoặc password sai, hoặc
pg_hba.conf không cho phép user này từ địa chỉ của CloudThinker. Kiểm tra password đã được URL-encode trong DATABASE_URI, thêm dòng pg_hba.conf cho user rồi tải lại PostgreSQL.Không tìm thấy pg_stat_statements, hoặc không có dữ liệu truy vấn chậm
Không tìm thấy pg_stat_statements, hoặc không có dữ liệu truy vấn chậm
Extension chưa được nạp hoặc chưa được tạo. Xác nhận
SHOW shared_preload_libraries; có pg_stat_statements, khởi động lại nếu bạn vừa thêm, và chạy CREATE EXTENSION pg_stat_statements; trong cơ sở dữ liệu đích. Thống kê tính từ lần reset gần nhất, nên server mới có rất ít lịch sử.Permission denied cho bảng hoặc schema
Permission denied cho bảng hoặc schema
User thiếu
USAGE trên schema hoặc SELECT trên bảng. Bảng tạo sau khi cấp quyền cần dòng ALTER DEFAULT PRIVILEGES FOR ROLE, nêu tên role tạo ra các bảng đó.Chưa cài HypoPG
Chưa cài HypoPG
Thử index giả định cần extension
hypopg. Hãy cài extension, hoặc yêu cầu đề xuất index mà không thử nghiệm.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.
- Mã hóa khi truyền: đặt
sslmode=requiretrong DATABASE_URI để thông tin xác thực và kết quả không bao giờ đi qua mạng ở dạng văn bản thuần.verify-fullcòn cần CA certificate của server ở phía CloudThinker, mà kết nối không có trường nào để cung cấp, nên hãy dùngrequire. - Chế độ hạn chế cho mọi truy vấn: CloudThinker mở kết nối PostgreSQL ở chế độ chỉ đọc, nên agent không thể ghi dù quyền của role cho phép.
Liên quan
CockroachDB
Kết nối cluster CockroachDB tương thích PostgreSQL với user đọc và user ghi riêng biệt.
MySQL
Kết nối MySQL cũng bằng user chỉ đọc. Khác với PostgreSQL, thao tác ghi trên MySQL đi qua Approvals thay vì bị chặn.