Chuyển đến nội dung chính
Kết nối một organization Splunk Observability Cloud để các agent CloudThinker phân tích độ trễ và lỗi của một dịch vụ theo tag, lập bản đồ phụ thuộc, lấy exemplar trace và chạy SignalFlow (ngôn ngữ phân tích dữ liệu streaming của Splunk) trên số liệu của bạn. Kết nối chỉ đọc và dùng MCP Gateway do Splunk lưu trữ, nên bạn chỉ cần cung cấp access token, realm và gateway region.

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

  • Organization Splunk Observability Cloud đã được Splunk cấp quyền dùng các công cụ Observability MCP. Hãy kiểm tra điều này trước: một organization chưa được cấp quyền sẽ trả về Org Not Allowed, và không cài đặt nào trong CloudThinker khắc phục được. Hãy nhờ Splunk administrator hoặc bộ phận hỗ trợ của Splunk bật tính năng này trước khi bắt đầu.
  • Observability Cloud tách biệt với Splunk Enterprise và Splunk Cloud Platform, vốn dùng kết nối Splunk Platform.
  • Realm của bạn, tức deployment Splunk mà organization của bạn chạy trên đó. Đây là nhãn đầu tiên trong URL Observability của bạn: app.<realm>.signalfx.com hoặc app.<realm>.observability.splunkcloud.com, ví dụ us0, eu0 hoặc au0.
  • Splunk admin có quyền tạo org access token.
  • Instrumentation APM, nếu bạn muốn câu trả lời về dịch vụ và trace. Organization chỉ gửi số liệu sẽ trả về 0 APM environment, nhưng câu hỏi về số liệu và SignalFlow vẫn hoạt động.
  • Vai trò Admin trong workspace CloudThinker, cần để thêm kết nối. Xem Vai trò.

​
Thiết lập

1

Tạo access token

Trong Splunk Observability Cloud, mở Settings → Access Tokens và chọn New Token. Đặt tên là cloudthinker, chọn authorization scope API, và gắn role read_only.
2

Đặt thời hạn

Chọn ai có thể thấy token và đặt ngày hết hạn phù hợp với chính sách xoay vòng của bạn. Splunk làm hết hạn token sau 30 ngày kể từ khi tạo trừ khi bạn thay đổi ở đây.
3

Sao chép token

Chọn tên token, chọn Show Token, rồi Copy.
4

Thêm kết nối trong CloudThinker

Trong thanh bên, nhấn More → Workspace settings → Connections, ở lại tab Builtin Connections, và chọn Splunk Observability. Điền:
  • Access token: token bạn đã sao chép.
  • Realm: chỉ realm, viết thường như trong URL, chẳng hạn us0. Không dán toàn bộ URL.
  • Gateway region: region Splunk Cloud Services mà request của bạn sẽ đi qua (xem Chi tiết kết nối). Các organization ở EU hoặc APAC có quy định về nơi lưu trữ dữ liệu nên đổi mặc định US East.
Nhấn Connect.Trạng thái thành công: Splunk Observability hiển thị Connected. Chạy prompt xác minh bên dưới để xác nhận token khớp với realm.

​
Chi tiết kết nối

Gateway region không giới hạn realm bạn có thể truy cập. Bất kỳ region nào cũng truy cập được bất kỳ realm nào. Gateway region quyết định request và kết quả của bạn đi qua hạ tầng Splunk nào, nên hãy chọn region mà yêu cầu lưu trữ dữ liệu của bạn đòi hỏi.
User API access token từ hồ sơ Splunk của bạn cũng hoạt động, nhưng token này hết hạn khi bạn đăng xuất khỏi Splunk Observability Cloud. Khi đó kết nối dừng mà không có cảnh báo. Hãy dùng org access token cho mọi mục đích ngoài một lần dùng thử nhanh.

​
Quyền yêu cầu

Role read_only là đủ cho mọi công cụ mà kết nối này dùng, kể cả chạy chương trình SignalFlow. Role rộng hơn như power cấp nhiều hơn mức agent cần. Splunk thực thi role ngay tại API của mình, và kết nối này không có công cụ ghi nào. Agent không thể tạo, sửa, tắt tiếng hay xóa detector, dashboard, chart hoặc cảnh báo. Khi một cuộc điều tra chỉ ra một thay đổi cần làm, agent cho bạn biết cần thay đổi gì và bạn thực hiện trong Splunk.
Dùng một org access token tên cloudthinker với role read_only, để bạn có thể thu hồi riêng quyền truy cập của CloudThinker mà không ảnh hưởng đến ai khác.

​
Khả năng của agent

Agent tự viết SignalFlow và kiểm tra tên metric với danh mục của bạn trước. Agent không dùng trình tạo chương trình tích hợp sẵn của Splunk.

​
Xác minh kết nối

Kết quả mong đợi là realm của bạn, danh sách APM environment cùng các dịch vụ, và một ghi chú về việc instrumentation APM có đang báo cáo hay không. Không có environment nào và không có lỗi nghĩa là organization gửi số liệu nhưng không có dữ liệu APM.

​
Ví dụ prompt

​
Khắc phục sự cố

Organization của bạn chưa được cấp quyền dùng các công cụ Observability MCP của Splunk. Thay đổi token, realm hay region đều không giúp được. Hãy nhờ Splunk administrator hoặc bộ phận hỗ trợ của Splunk bật tính năng này.
Token sai, đã hết hạn, hoặc được cấp ở organization khác với organization mà Realm chỉ định. Token không khớp với realm thường trả về danh sách công cụ trống thay vì lỗi. Kiểm tra realm trong URL Observability, rồi tạo token mới trong organization đó và cập nhật Access token.
Token Splunk mặc định hết hạn sau 30 ngày kể từ khi tạo, và user API access token cũng hết hạn khi bạn đăng xuất. CloudThinker không biết ngày hết hạn của token, nên không thể cảnh báo trước. Tạo một org access token với thời hạn dài hơn, cập nhật kết nối, và đặt lời nhắc để xoay vòng token.
Organization có thể không có instrumentation APM, hoặc tên dịch vụ không khớp chính xác. Yêu cầu agent liệt kê dịch vụ trước và dùng một tên từ danh sách đó. Nếu agent báo tìm kiếm chưa hoàn tất, hãy hỏi lại với khoảng thời gian ngắn hơn.
Tìm kiếm exemplar trace của Splunk có thể chạy lâu hơn mức một lần gọi công cụ cho phép. Phần còn lại của câu trả lời về tình trạng dịch vụ vẫn hợp lệ. Hãy hỏi lại với cửa sổ thời gian ngắn hơn, chẳng hạn một giờ gần nhất.
Tìm kiếm danh mục khớp lỏng và chỉ trả về một vài tên mỗi lần gọi. Hãy cung cấp cho agent tên metric chính xác, hoặc thử từ khóa tìm kiếm khá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.
  • Chỉ đọc, do Splunk thực thi: token read_only là thông tin xác thực hẹp nhất chạy được mọi công cụ ở đây, và Splunk từ chối mọi thao tác ghi từ token này ở phía server.
  • Gateway region là đường đi của dữ liệu: request và kết quả đi qua region bạn chọn. Realm và region là giá trị định tuyến, không phải thông tin xác thực, nên agent có thể nêu chúng trong câu trả lời.

​
Liên quan

Splunk Platform

Tìm kiếm log Splunk và xem lại dung lượng index.

Honeycomb

Truy vấn trace, BubbleUp và thay đổi trigger có kiểm soát phê duyệt.