Pgbot: Công cụ Postgres chỉ đọc 5,9 MB dành cho con người và AI agents

Pgbot là một công cụ mã nguồn mở, nhẹ chỉ 5,9 MB, được viết bằng Go, giúp bạn kết nối và phân tích database PostgreSQL một cách nhanh chóng. Thay vì cung cấp các dashboard phức tạp, pgbot tập trung vào việc đưa ra câu trả lời trực tiếp về tình trạng sức khỏe, hiệu suất truy vấn và các vấn đề cần ưu tiên xử lý. Điểm đặc biệt là công cụ này hỗ trợ giao thức MCP, cho phép các AI agents như Claude hay Cursor sử dụng nó như một công cụ phân tích chỉ đọc an toàn.

Pgbot là gì?

Pgbot là một tiện ích dòng lệnh (CLI) mã nguồn mở được thiết kế để "đọc" database PostgreSQL của bạn và đưa ra những thông tin hữu ích. Theo lời giới thiệu của nhà phát triển: "Không ai đọc số liệu database. Pgbot sẽ làm điều đó." Thay vì bắt người dùng tự mày mò các con số, pgbot tổng hợp và giải thích chúng một cách dễ hiểu.

Công cụ này cung cấp các lệnh đơn giản như pgbot inspect để kiểm tra toàn diện, pgbot indexes để xem tình trạng index, hay pgbot tables để phân tích bảng. Đặc biệt, lệnh pgbot ask "why is it slow?" cho phép bạn đặt câu hỏi bằng ngôn ngữ tự nhiên và nhận được câu trả lời dựa trên dữ liệu thực tế từ database.

Các tính năng chính

Pgbot cung cấp một loạt các tính năng giúp bạn quản lý PostgreSQL hiệu quả hơn:

• Theo dõi sức khỏe database theo thời gian thực: Giám sát kết nối, khóa (locks), giao dịch, tỷ lệ cache hit, replication, WAL và sức khỏe tổng thể.
• Phân tích hiệu suất truy vấn: Phát hiện truy vấn chậm, sự suy giảm hiệu suất, throughput, độ trễ và các câu lệnh SQL tốn kém dựa trên số liệu thống kê của PostgreSQL.
• Kiểm tra bảng và index: Phân tích sự tăng trưởng của bảng, mức độ sử dụng index, index không dùng, index bị thiếu, hoạt động vacuum và mô hình lưu trữ.
• Giải thích bằng AI: Đặt câu hỏi bằng tiếng Anh đơn giản và nhận được tóm tắt, giải thích và khuyến nghị dựa trên các tín hiệu thực tế từ database.
• Tương thích mọi PostgreSQL: Kết nối trực tiếp với database công khai hoặc sử dụng Pgbot Agent cho môi trường riêng tư như Docker, Kubernetes, máy chủ nội bộ.
• An toàn cho môi trường production: Chỉ có quyền đọc, mã nguồn mở và hỗ trợ triển khai riêng tư mà không cần phơi bày database ra công chúng.

Tích hợp MCP cho AI agents

Một điểm nhấn quan trọng của pgbot là khả năng hoạt động như một công cụ cho AI agents thông qua giao thức Model Context Protocol (MCP). Với lệnh pgbot mcp, các AI agents có thể gọi pgbot như một công cụ chỉ đọc, an toàn.

Giao diện MCP này chỉ cung cấp các công cụ xác định (deterministic) như inspect (trả về kết quả dạng JSON) và unused_indexes. Điều này có nghĩa là agent không thể thao tác ghi vào database. Cách tiếp cận này khá thông minh: pgbot tính toán các kết quả một cách chính xác, còn mô hình AI sẽ đảm nhận việc giải thích chúng.

Bạn có thể dễ dàng thêm pgbot vào các MCP client phổ biến như Claude Desktop/Code, Cursor bằng cấu hình JSON đơn giản.

Kiến trúc kết nối linh hoạt

Pgbot cung cấp hai cách kết nối đến database của bạn:

1. Kết nối trực tiếp: Qua đường truyền mạng tới các dịch vụ như Supabase, Neon, RDS, PlanetScale hoặc database công khai.
2. Pgbot Agent: Chạy agent ngay cạnh database trong mạng nội bộ của bạn (Docker, Kubernetes, VPC). Dữ liệu không bao giờ rời khỏi hệ thống của bạn.

Kiến trúc này cho phép bạn linh hoạt lựa chọn giải pháp phù hợp với yêu cầu bảo mật và hạ tầng hiện có.

Vì sao nên dùng Pgbot?

Sự khác biệt của pgbot so với các công cụ giám sát truyền thống nằm ở triết lý thiết kế:

• Không chỉ là số liệu, mà là bối cảnh: Pgbot giúp bạn hiểu điều gì đã thay đổi và tại sao nó quan trọng.
• Không chỉ là dashboard, mà là giải thích: Đặt câu hỏi bằng tiếng Anh đơn giản và nhận được câu trả lời có thể hành động.
• Không chỉ cho Postgres được lưu trữ: Sử dụng với Supabase, Neon, RDS, Docker, Kubernetes và máy chủ riêng.
• Không chỉ là giám sát, mà là một chuyên gia DBA AI: Có được những hiểu biết giúp tìm ra vấn đề nhanh hơn và đưa ra quyết định tốt hơn.

Cài đặt và sử dụng

Việc cài đặt pgbot rất đơn giản. Bạn có thể sử dụng curl, npm hoặc brew:

$ curl -fsSL https://pgbot.dev/install | sh

Sau khi cài đặt, bạn chỉ cần trỏ công cụ tới database của mình và bắt đầu nhận được những phân tích hữu ích. Công cụ này có kích thước siêu nhỏ (5,9 MB), không yêu cầu cấu hình phức tạp và mặc định chỉ có quyền đọc.

Kết luận

Pgbot là một công cụ thú vị và hữu ích cho cả nhà phát triển, quản trị viên database lẫn các hệ thống AI agents. Với kích thước nhỏ gọn, khả năng phân tích sâu và tích hợp MCP, nó cung cấp một cách tiếp cận mới mẻ cho việc giám sát PostgreSQL. Đối với các đội ngũ đang sử dụng PostgreSQL ở Việt Nam, việc thử nghiệm pgbot có thể giúp giảm tải công việc DBA và đưa ra các quyết định tối ưu hiệu suất nhanh chóng hơn. Bạn có thể tìm hiểu thêm và đóng góp cho dự án trên GitHub.