> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt > Use this file to discover all available pages before exploring further. # Splunk Observability > Kết nối Splunk Observability Cloud để agent có thể đọc tình trạng dịch vụ APM, exemplar trace, số liệu và kết quả SignalFlow 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](https://docs.cloudthinker.io/vi/guide/connections/splunkplatform.md). * **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..signalfx.com` hoặc `app..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ò](https://docs.cloudthinker.io/vi/guide/security/roles.md). ## 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](#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 | Trường | Mô tả | Ví dụ | | - | - | - | | **Access token** | Một org access token có scope API, được cấp với role `read_only` | `` | | **Realm** | Realm chứa organization của bạn, nhập dạng văn bản tự do. Chỉ realm, không phải URL | `us0` | | **Gateway region** | Region Splunk Cloud Services phục vụ MCP Gateway. Mặc định `iad10 (US East)` | `fra10 (Germany)` | 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. | Gateway region | Vị trí | | - | - | | `iad10` | US East | | `pdx10` | US West | | `dub10` | Ireland | | `fra10` | Germany | | `lon10` | United Kingdom | | `tyo10` | Japan | | `syd10` | Australia | | `sin10` | Singapore | > [!WARNING] > > 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. > [!TIP] > > 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 | Khả năng | Agent có thể làm gì | Phê duyệt | | - | - | - | | **Environment và dịch vụ** | Liệt kê APM environment và các dịch vụ báo cáo trong từng environment | Không | | **Tình trạng dịch vụ** | Phân tích độ trễ, lỗi và số request của một dịch vụ theo tag | Không | | **Phụ thuộc** | Đọc các phụ thuộc đầu vào và đầu ra của một dịch vụ cùng số request và độ trễ | Không | | **Trace** | Lấy exemplar trace cho lỗi hoặc các nhóm độ trễ, rồi mở mọi span của một trace theo ID | Không | | **Số liệu** | Tìm kiếm danh mục metric và đọc dimension, property và giá trị mẫu của một metric | Không | | **SignalFlow** | Viết chương trình SignalFlow từ tên metric thực và chạy chương trình đó cho một chuỗi thời gian | Không | | **Cảnh báo** | Tìm kiếm cảnh báo và sự cố đã kích hoạt | Không | 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 ```text theme={null} Summarize my Splunk Observability setup: realm, APM environments, services, and whether APM is reporting ``` 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 ```text theme={null} Which service in the prod environment has the worst error rate over the last 24 hours? Why is checkout slow? Break its latency down by tag and show an exemplar error trace Run a SignalFlow query for the busiest kafka metric over the last 6 hours ``` ## Khắc phục sự cố > **Org Not Allowed** > > 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. > **Xác thực thất bại, hoặc kết nối không liệt kê công cụ nào** > > 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**. > **Kết nối ngừng hoạt động sau khoảng một tháng** > > 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. > **Câu trả lời APM trả về trống** > > 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. > **Exemplar trace bị hết thời gian chờ** > > 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. > **Không tìm thấy một metric mà bạn biết là có tồn tại** > > 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](https://docs.cloudthinker.io/vi/guide/connections/splunkplatform.md)** > > Tìm kiếm log Splunk và xem lại dung lượng index. > **[Honeycomb](https://docs.cloudthinker.io/vi/guide/connections/honeycomb.md)** > > Truy vấn trace, BubbleUp và thay đổi trigger có kiểm soát phê duyệt. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.