Điều kiện tiên quyết
- Một cluster Elasticsearch có endpoint HTTPS mà CloudThinker truy cập được qua mạng, như một deployment Elastic Cloud hoặc một tên DNS công khai. CloudThinker Cloud không truy cập được
localhostvà các địa chỉ private. - Nếu tường lửa hoặc traffic filter của Elastic Cloud bảo vệ cluster, 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 liên hệ CloudThinker của bạn, hoặc liên hệ với 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 key (Kibana Stack Management → Security → API keys, hoặc API
_security/api_key) hoặc tạo một user riêng. - Các index pattern mà agent cần đọc, như
logs-*hoặcfilebeat-*.
Thiết lập
1
Tạo API key chỉ đọc
Trong Kibana, mở Dev Tools và chạy request bên dưới. Thay Sao chép giá trị
logs-* bằng index pattern của bạn.encoded trong response. Elasticsearch chỉ hiển thị giá trị này một lần.Bạn cũng có thể tạo key trong Stack Management → Security → API keys: nhấn Create API key, bật Control security privileges, rồi dán cùng đối tượng role_descriptors ở trên.2
Sao chép endpoint của cluster
Dùng URL đầy đủ kèm scheme và port, như
https://elasticsearch.example.com:9200. Trên Elastic Cloud, sao chép Elasticsearch endpoint từ trang deployment.3
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections và chọn Elasticsearch. Nhập endpoint vào ES_URL, chọn API key trong Authentication, rồi dán key đã mã hóa. Giữ TLS certificate ở Verify trừ khi cluster dùng chứng chỉ tự ký. 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 kiểm tra thất bại, kết nối hiển thị lỗi kèm thông báo mà cluster trả về. Đối chiếu thông báo đó với mục Khắc phục sự cố.
Chi tiết kết nối
Chỉ điền một phương thức. Nếu bạn nhập cả API key lẫn username hoặc password, kết nối bị từ chối với thông báo “Choose either an API key or username and password.”
Quyền yêu cầu
Nếu dùng Username & password, hãy tạo một role có cùng các quyền trên và một user giữ role đó. Chạy từng request riêng trong Dev Tools:
Khả năng của agent
Kết nối không có công cụ nào ghi, xóa hay thay đổi cài đặt cluster.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Kết nối thất bại do timeout hoặc connection refused
Kết nối thất bại do timeout hoặc connection refused
ES_URL trỏ tới địa chỉ mà CloudThinker không truy cập được. Hãy dùng endpoint công khai, kèm scheme và port, và kiểm tra tường lửa hoặc traffic filter của Elastic Cloud có cho phép egress IP của CloudThinker (xem Điều kiện tiên quyết).
security_exception trên một index
security_exception trên một index
Key hoặc user không có quyền trên index đó. Thêm pattern của index vào
names trong một key mới, rồi thay thông tin xác thực trên kết nối.Lỗi chứng chỉ trên cluster tự host
Lỗi chứng chỉ trên cluster tự host
Cluster dùng chứng chỉ tự ký. Chỉ đặt TLS certificate thành Allow self-signed khi bạn tin cậy cluster đó.
Truy vấn không trả về kết quả
Truy vấn không trả về kết quả
Index pattern không khớp, tên field khác với tên prompt giả định, hoặc khoảng thời gian không có dữ liệu. Hãy yêu cầu agent liệt kê index và đọc mapping của index trước.
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.
- Đặt thời hạn cho key: một
expirationnhư90dgiới hạn thời gian key bị lộ còn dùng được. Tạo key mới trước khi key cũ hết hạn, sau đó mở kết nối, nhấn biểu tượng bút chì trên dòng của kết nối, và trong Edit Instance nhấn Replace…. Dán key mới và nhấn Save and test. Nếu kiểm tra thất bại, CloudThinker giữ key cũ, nên agent không mất quyền truy cập trong lúc đổi key. - Coi nội dung đã index là dữ liệu nhạy cảm: log có thể chứa token hoặc dữ liệu cá nhân mà ứng dụng đã ghi ra. Hãy giới hạn key trong các index bạn muốn agent đọc.
Liên quan
Phân tích nguyên nhân gốc
Xem cách agent dùng tìm kiếm log để tìm ra nguyên nhân của sự cố.
Tổng quan kết nối
Xoay vòng thông tin xác thực, truy cập dịch vụ private và xem mọi kết nối.