Chuyển đến nội dung chính
Kết nối một instance InfluxDB để các agent CloudThinker liệt kê bucket hoặc database, tìm những nơi giữ dữ liệu vĩnh viễn, và trả lời câu hỏi bằng cách truy vấn chính dữ liệu time series. Kết nối đăng nhập bằng một API token, tự phát hiện bạn chạy InfluxDB 2 hay 3, và ở chế độ chỉ đọc cho đến khi bạn bật Allow writes.

​
Phiên bản được hỗ trợ

Bạn không cần chọn phiên bản. Thông báo Connected nêu tên phiên bản CloudThinker tìm thấy, và agent dùng Flux hoặc SQL cho phù hợp.

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

  • InfluxDB HTTP API mà CloudThinker truy cập được qua HTTPS. http thuần chỉ được chấp nhận trên các triển khai CloudThinker tự host.
  • Với instance tự host sau tường lửa, hãy cho phép các egress IP của CloudThinker. 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. Xem Truy cập dịch vụ private để biết các lựa chọn khác.
  • Quyền tạo API token có quyền đọc các bucket hoặc database mà agent cần thấy.
  • Trên InfluxDB 2: tên organization, nếu token truy cập được nhiều hơn một organization.
  • Vai trò Admin trong workspace CloudThinker, vai trò có thể thêm và sửa kết nối. Xem Vai trò.

​
Thiết lập

1

Tạo token đọc

Trong giao diện InfluxDB, mở Load Data → API Tokens, nhấn Generate API Token và chọn Custom API Token (hoặc Read/Write API Token trên các phiên bản cũ). Chọn các bucket trong Read và để trống Write. Sao chép token. InfluxDB chỉ hiển thị token một lần.
2

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections và chọn InfluxDB. Nhập:
  • Base URL: scheme, host và port, chẳng hạn https://influx.example.com:8086 hoặc https://us-east-1-1.aws.cloud2.influxdata.com
  • API token: token bạn đã sao chép
  • Organization: chỉ khi token truy cập được nhiều hơn một organization
Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connected với thông báo như InfluxDB 2 connection verified (v2.7.12).

​
Chi tiết kết nối

InfluxDB 2 tự host thường lắng nghe trên 8086, InfluxDB 3 Core trên 8181.

​
Quyền yêu cầu

Token chỉ cần quyền ghi nếu bạn bật Allow writes, và khi đó chỉ để thay đổi retention hoặc tạo và xóa bucket hay database.
Tạo một token chỉ dành cho CloudThinker để bạn có thể xem và thu hồi riêng quyền của token đó. Nếu token có phạm vi quan trọng với bạn, hãy ưu tiên InfluxDB 2 hoặc InfluxDB 3 Enterprise thay vì Core.

​
Khả năng của agent

Kết quả có giới hạn. Mặc định, bước kiểm kê đọc tối đa 25 bucket hoặc database. Mỗi truy vấn trả về 50 hàng theo mặc định, và bạn có thể yêu cầu nhiều hơn trong prompt, tối đa 200. Truy vấn hết thời gian sau 60 giây theo mặc định, và không bao giờ chạy quá 300 giây. Agent cho biết khi một kết quả bị cắt ngắn. Retention mà token không đọc được sẽ được báo là unreadable, không bao giờ bị tính là vĩnh viễn. Truy vấn luôn là thao tác đọc. Agent từ chối Flux ghi point hoặc mở kết nối ra ngoài, và SQL insert, update hoặc delete. Không có gì được gửi đến instance của bạn khi một truy vấn bị từ chối.

​
Xác minh kết nối

Kết quả mong đợi là tên từng bucket hoặc database cùng retention, và danh sách những bucket hoặc database giữ dữ liệu vĩnh viễn.

​
Ví dụ prompt

​
Quyền ghi

Quyền ghi mặc định tắt. Để cho phép agent thay đổi retention hoặc tạo và xóa bucket hay database, mở More → Workspace settings → Connections, chọn InfluxDB và bật công tắc Allow writes trong bảng chi tiết. Thay đổi có hiệu lực ngay. Sau đó mỗi thay đổi đều đi qua Rules và chế độ của Approvals, và agent nêu chính xác bucket hoặc database cùng thay đổi trước. Token cũng cần quyền tương ứng:
Rút ngắn retention sẽ xóa dữ liệu ngay lập tức: mọi point cũ hơn khoảng thời gian mới đều hết hạn, và không có bản sao nào được giữ lại. Xóa bucket trên InfluxDB 2 sẽ xóa dữ liệu trong bucket và không thể hoàn tác. InfluxDB 3 xóa mềm database và giải phóng dung lượng sau.

​
Khắc phục sự cố

Token đã bị thu hồi, sao chép không đầy đủ hoặc thuộc về một instance khác. InfluxDB chỉ hiển thị token khi tạo, vì vậy hãy tạo token mới và cập nhật kết nối.
Token hợp lệ nhưng không bao gồm các bucket hoặc database. Mở rộng phạm vi đọc của token trong InfluxDB, hoặc tạo token bao gồm chúng, rồi kết nối lại.
Kiểm tra instance đang chạy và truy cập được, Base URL trỏ đến HTTP port (thường là 8086 hoặc 8181), và mọi path chỉ là tiền tố proxy. InfluxDB 1.x và Cloud Dedicated phản hồi khác và không được hỗ trợ.
http thuần bị từ chối trên CloudThinker Cloud vì token được gửi kèm mọi request. Đặt instance sau TLS và dùng URL https.
Trên InfluxDB 2, không bucket hay truy vấn nào được giới hạn phạm vi cho đến khi bạn chọn một organization. Sửa kết nối và đặt Organization.
Hoặc token không thấy được phần còn lại, hoặc bước kiểm kê đã dừng ở giới hạn mặc định 25. Kiểm tra phạm vi đọc của token, rồi hỏi về bucket theo tê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.
  • InfluxDB 3 Core không có token chỉ đọc: Core chỉ cấp admin token, nên không thể làm theo lời khuyên chỉ đọc ở trên. Hãy giữ Allow writes ở trạng thái tắt, và dùng token chỉ đọc trên InfluxDB 2 hoặc InfluxDB 3 Enterprise.
  • Token là toàn bộ thông tin xác thực: không có yếu tố thứ hai, vì vậy hãy giới hạn token trong các bucket hoặc database agent cần và coi mọi token InfluxDB 3 Core là thông tin xác thực admin.
  • Không theo chuyển hướng: nếu một proxy chuyển hướng lệnh gọi API sang host khác, CloudThinker dừng lại thay vì gửi token của bạn đến đó.

​
Liên quan

Approvals

Quyết định thay đổi retention nào được chạy, chờ người duyệt hoặc bị từ chối.

Prometheus

Kết nối Prometheus để truy vấn metric, quy tắc cảnh báo và tình trạng target.