> ## 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.

# Khắc phục sự cố

> Tìm cách khắc phục các sự cố CloudThinker thường gặp nhất, từ đăng nhập và kết nối đến phê duyệt, sản phẩm, Worker và CLI.

Tìm triệu chứng của bạn, thử bước kiểm tra nhanh, và mở hướng dẫn khắc phục đầy đủ nếu vẫn chưa giải quyết được.

## Bắt đầu

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Bạn muốn thử CloudThinker trước khi kết nối production | Kết nối trước một tài khoản staging hoặc sandbox với role chỉ đọc. | [Quickstart](https://docs.cloudthinker.io/vi/quickstart.md) |
| Bạn không tìm thấy nơi thêm kết nối | Trong thanh bên, nhấn **More → Workspace settings → Connections**. | [Thêm kết nối](https://docs.cloudthinker.io/vi/guide/connections/overview.md#thêm-kết-nối) |
| Agent không tìm thấy kết nối bạn đã thêm | Kết nối thuộc về một workspace. Kiểm tra tên workspace trong thanh bên. | [Workspace](https://docs.cloudthinker.io/vi/guide/workspaces.md#khắc-phục-sự-cố) |
| Mục Discovery của kết nối mới vẫn trống | Discovery chạy một lần cho mỗi kết nối, trong tối đa 30 phút. Discovery tạm dừng nếu số dư credit quá thấp. | [Sau khi bạn kết nối](https://docs.cloudthinker.io/vi/guide/connections/overview.md#điều-gì-xảy-ra-sau-khi-kết-nối) |
| Optimize không hiển thị dữ liệu chi phí sau khi quét | Với tài khoản AWS mới, Cost Explorer có thể mất đến 24 giờ để bắt đầu, và trễ so với mức sử dụng từ 24 đến 48 giờ. | [Optimize quickstart](https://docs.cloudthinker.io/vi/guide/cost-optimization/quickstart.md#khắc-phục-sự-cố) |

## Đăng nhập, SSO và thành viên

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Người dùng không thể đăng nhập sau khi bạn bắt buộc SSO | Người dùng đã được gán vào app CloudThinker trong IdP của bạn chưa? | [SSO](https://docs.cloudthinker.io/vi/guide/security/sso.md#khắc-phục-sự-cố) |
| IdP báo ACS hoặc reply URL không hợp lệ, hoặc audience không khớp | Các giá trị phải khớp chính xác: `https://`, không có dấu gạch chéo ở cuối, phân biệt hoa thường. | [SAML SSO](https://docs.cloudthinker.io/vi/guide/security/sso-saml.md#khắc-phục-sự-cố) |
| "Redirect URI mismatch", Issuer Match hoặc Discovery Reachable thất bại | Sao chép `issuer` trực tiếp từ discovery document. Issuer phải truy cập được từ internet công cộng. | [OIDC SSO](https://docs.cloudthinker.io/vi/guide/security/sso-oidc.md#khắc-phục-sự-cố) |
| Người dùng không được cấp phát, hoặc người đã rời đi vẫn đăng nhập được | Tìm mục `FAILED` trong **View sync logs**. Hủy gán người rời đi ngay trên app, không chỉ trên group. | [SCIM](https://docs.cloudthinker.io/vi/guide/security/scim.md#khắc-phục-sự-cố) |
| Nút mời hiển thị Seats full, hoặc bạn không thể xóa thành viên | Lời mời đang chờ cũng chiếm seat. Admin không thể xóa Admin khác hoặc Owner. | [Organization](https://docs.cloudthinker.io/vi/guide/organization.md#khắc-phục-sự-cố) |
| Đồng nghiệp không thấy một workspace | Developer và Viewer chỉ thấy các workspace mà họ được thêm vào. | [Workspace](https://docs.cloudthinker.io/vi/guide/workspaces.md#khắc-phục-sự-cố) |
| Người đó không có trong danh sách Add Member | Có thể họ chưa thuộc organization, hoặc họ là Owner hay Admin của organization và đã có quyền truy cập. | [Thành viên workspace](https://docs.cloudthinker.io/vi/guide/workspace-users.md#khắc-phục-sự-cố) |
| Viewer không thể nhập trong chat | Viewer chỉ có quyền đọc. Đổi **Workspace Role** của họ thành **Developer**. | [Thành viên workspace](https://docs.cloudthinker.io/vi/guide/workspace-users.md#khắc-phục-sự-cố) |

## Kết nối, chat và lệnh

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Kết nối không xác minh được, hoặc hiển thị **Error** | Mở kết nối: bảng chi tiết hiển thị lỗi. Khắc phục nguyên nhân tại provider, rồi nhấn **Retry** hoặc **Replace credentials**. | [Khi kết nối bị lỗi](https://docs.cloudthinker.io/vi/guide/connections/overview.md#khi-kết-nối-bị-hỏng), rồi đến provider của bạn: [AWS](https://docs.cloudthinker.io/vi/guide/connections/aws.md#khắc-phục-sự-cố), [Azure](https://docs.cloudthinker.io/vi/guide/connections/azure.md#khắc-phục-sự-cố), [GCP](https://docs.cloudthinker.io/vi/guide/connections/gcp.md#khắc-phục-sự-cố), [Kubernetes](https://docs.cloudthinker.io/vi/guide/connections/kubernetes.md#khắc-phục-sự-cố), [GitHub](https://docs.cloudthinker.io/vi/guide/connections/github.md#khắc-phục-sự-cố) |
| Lệnh không mở rộng, hoặc menu `/` hiển thị Nothing matches | Skill cùng tên sẽ được ưu tiên dùng slug đó. Kiểm tra chính tả của slug trên **More → Workspace settings → Commands**. | [Lệnh](https://docs.cloudthinker.io/vi/guide/commands.md#khắc-phục-sự-cố) |
| Tên credential bị từ chối, hoặc bạn không thấy bộ chọn `$` | Key chỉ nhận chữ in hoa, chữ số và dấu gạch dưới. Bộ chọn `$` cần vai trò Admin của workspace. | [Credential](https://docs.cloudthinker.io/vi/guide/credentials.md#khắc-phục-sự-cố) |
| Bot Slack không trả lời, hoặc trả lời bằng tài khoản sai | Bot đã ở trong kênh chưa (`/invite @CloudThinker`), và bạn đã mention bot trong một tin nhắn mới chưa? | [Slack](https://docs.cloudthinker.io/vi/guide/slack-integration.md#khắc-phục-sự-cố) |
| Bot Teams không trả lời, hoặc một team chưa được liên kết với workspace | Cài đặt admin Teams của bạn có thể đang chặn custom app. | [Microsoft Teams](https://docs.cloudthinker.io/vi/guide/teams-integration.md#khắc-phục-sự-cố) |

## Phê duyệt và automation

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Thao tác ghi vẫn hỏi bạn dù đã có Rule cho phép | Lượt chạy dùng **Manual**, chế độ này hỏi trước mọi thao tác ghi. | [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md#khắc-phục-sự-cố) |
| Bạn không thấy nút Approve | Viewer không thể phê duyệt, và một Rule có thể gửi yêu cầu hỏi đến một group mà bạn không thuộc. Thẻ cho biết ai có thể phê duyệt. | [Người phê duyệt](https://docs.cloudthinker.io/vi/guide/approvals/approvers.md#khắc-phục-sự-cố) |
| Automation từ chối thao tác ghi thay vì hỏi | Automations mặc định dùng **Auto · Rules + AI · Refuse**. Hãy chọn một lựa chọn **Ask me**, lựa chọn này dùng được ngay hiện nay. Allow Rule cho thao tác ghi đó chỉ có tác dụng khi [Rule enforcement](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) được bật cho workspace của bạn. | [FAQ về Approval mode](https://docs.cloudthinker.io/vi/guide/approvals/approval-mode.md#câu-hỏi-thường-gặp) |
| Lượt chạy nằm ở Required Approval, hoặc automation tự tắt | Mở cuộc hội thoại của lượt chạy từ **Runs**. Mười lượt chạy thất bại liên tiếp sẽ tắt automation. | [Vận hành tự động](https://docs.cloudthinker.io/vi/guide/automation/autonomous-agents.md#khắc-phục-sự-cố) |
| Lượt chạy thành công nhưng không có gì được đăng lên Slack | Đọc cuộc hội thoại của lượt chạy trước. Sau đó kiểm tra Slack đã bật cho **Agent alerts** trong **Notifications**. | [Automation quickstart](https://docs.cloudthinker.io/vi/guide/automation/quickstart.md#khắc-phục-sự-cố) |

## Sản phẩm

**Resolve** xử lý sự cố production. Lớp tiếp nhận của Resolve, [Pulse](https://docs.cloudthinker.io/vi/guide/pulse/overview.md), nhận cảnh báo từ các công cụ của bạn và nhóm chúng thành cluster. **Review** review pull request. **Optimize** phụ trách chi phí cloud. **Cyber** kiểm thử ứng dụng của bạn để tìm lỗ hổng bảo mật. **Memory** là những gì CloudThinker ghi nhớ về workspace của bạn giữa các cuộc chat.

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Resolve: Pulse hiển thị No signals yet | Kiểm tra nhật ký gửi của công cụ giám sát, rồi dán lại webhook URL và kích hoạt một cảnh báo test. | [Cảnh báo không đến](https://docs.cloudthinker.io/vi/guide/incident/troubleshooting.md#cảnh-báo-không-đến) |
| Resolve: mỗi cảnh báo mở một cluster riêng | Cảnh báo lặp lại chỉ gia nhập cluster đang mở khi nguồn, loại cảnh báo và resource ID đều khớp. | [Cluster không hình thành](https://docs.cloudthinker.io/vi/guide/incident/troubleshooting.md#cluster-không-hình-thành) |
| Resolve: sự cố chờ ở Not started | **On duty** đang tạm dừng. Kiểm tra header của **Resolve → Investigation**. | [Điều tra không bắt đầu](https://docs.cloudthinker.io/vi/guide/incident/troubleshooting.md#cuộc-điều-tra-không-khởi-động) |
| Resolve: phân tích thất bại, hoặc cuộc điều tra có vẻ bị kẹt | Nhấn **Watch live** trên sự cố. Nếu timeline vẫn đang chạy, cuộc điều tra không bị kẹt. | [Điều tra bị kẹt](https://docs.cloudthinker.io/vi/guide/incident/troubleshooting.md#cuộc-điều-tra-bị-kẹt) |
| Resolve: một lệnh runbook chờ phê duyệt hoặc bị chặn | Lệnh từ Confluence, GitHub và GitLab luôn cần phê duyệt. | [Runbook không chạy](https://docs.cloudthinker.io/vi/guide/incident/troubleshooting.md#runbook-không-chạy) |
| Review không đăng gì trên pull request | PR nháp không được review. Kiểm tra công tắc **Review** của repository trong **Review → Settings → Repositories**. | [Không có bình luận trên PR mới](https://docs.cloudthinker.io/vi/guide/code-review/troubleshooting.md#không-có-bình-luận-trên-pr-mới) |
| Review hiển thị **Reconnect your Git provider** | Nhấn nút trên cảnh báo và kết nối lại, hoặc dán token mới với cùng scope. | [Lỗi xác thực provider](https://docs.cloudthinker.io/vi/guide/code-review/troubleshooting.md#lỗi-xác-thực-provider) |
| Optimize: một đợt tăng đột biến bạn thấy trong cloud console không được liệt kê | So sánh ngày với **Billing data through**. Tài khoản mới cần 14 ngày đã chốt trước. | [Anomalies](https://docs.cloudthinker.io/vi/guide/cost-optimization/anomalies.md#khắc-phục-sự-cố) |
| Optimize: tổng phát hiện là \$0 hoặc không khớp với Overview | Bộ lọc **Service** trên **Findings** làm thay đổi tổng. Hãy xóa bộ lọc đó. | [Savings](https://docs.cloudthinker.io/vi/guide/cost-optimization/savings.md#khắc-phục-sự-cố) |
| Cyber: quyền sở hữu mục tiêu vẫn ở Needs proof, hoặc các trang được bảo vệ không được kiểm thử | Một số nhà cung cấp DNS tự thêm tên zone, nên tên miền xuất hiện hai lần trong tên bản ghi TXT. | [Cyber quickstart](https://docs.cloudthinker.io/vi/guide/security/cyber-quickstart.md#khắc-phục-sự-cố) |
| Cyber: phát hiện đã sửa xuất hiện lại, hoặc Awaiting retest không bao giờ biến mất | Một lần quét sau đã chứng minh lại vấn đề. Mở liên kết **Runs** của ứng dụng để xem lượt chạy nào. | [Cyber findings](https://docs.cloudthinker.io/vi/guide/security/cyber-findings.md#khắc-phục-sự-cố) |
| Memory hiển thị Not ready yet, hoặc một chỉnh sửa báo mục đã thay đổi | Nhấn **Retry** sau vài giây, hoặc **Reload** và chỉnh sửa lại. | [Memory](https://docs.cloudthinker.io/vi/guide/memory.md#khắc-phục-sự-cố) |

## Worker và CLI

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Worker hiển thị Offline, hoặc xác minh thất bại | Chạy `cloudthinker worker status --outpost <name>`, hoặc `cloudthinker worker doctor` trong thư mục. | [Worker](https://docs.cloudthinker.io/vi/guide/workers.md#khắc-phục-sự-cố) |
| Đồng nghiệp nhận `EXECUTOR_TARGET_PRIVATE` | Họ đã thử dùng Worker cá nhân của bạn. Hãy tạo một Worker dùng chung. | [Worker](https://docs.cloudthinker.io/vi/guide/workers.md#khắc-phục-sự-cố) |
| `cloudthinker: command not found` | Shell đã khởi động trước khi `~/.local/bin` được thêm vào `PATH`. Mở một shell mới. | [Tổng quan CLI](https://docs.cloudthinker.io/vi/guide/cli/overview.md#khắc-phục-sự-cố) |
| Lệnh báo bạn chưa đăng nhập (exit code 3) | Thông tin xác thực bị thiếu hoặc đã hết hạn. Chạy `cloudthinker login`, rồi `cloudthinker whoami`. | [Xác thực CLI](https://docs.cloudthinker.io/vi/guide/cli/authentication.md#khắc-phục-sự-cố) |
| Lượt chạy headless thoát với mã 5 | Lượt chạy đã tạm dừng để chờ phê duyệt. Mở `web_url` của lượt chạy và đưa ra quyết định. | [Headless chat](https://docs.cloudthinker.io/vi/guide/cli/headless-chat.md#khắc-phục-sự-cố) |
| Prompt headless bị từ chối vì quá dài | Prompt cộng với đầu vào được pipe vượt quá 50.000 ký tự. | [Headless chat](https://docs.cloudthinker.io/vi/guide/cli/headless-chat.md#khắc-phục-sự-cố) |

Mọi exit code của CLI (0 đến 5, và 130) và cách xử lý có trong [Exit code](https://docs.cloudthinker.io/vi/guide/cli/headless-chat.md#mã-thoát).

## Quản trị và billing

| Triệu chứng | Kiểm tra nhanh | Khắc phục đầy đủ |
| - | - | - |
| Bạn không thấy Audit Logs, hoặc bản export có ít hàng hơn dự kiến | Audit Logs cần vai trò Admin của organization. Sự kiện cũ hơn 90 ngày bị xóa. | [Audit log](https://docs.cloudthinker.io/vi/guide/security/audit-logs.md#khắc-phục-sự-cố) |
| Mẫu guardrail không lưu được, hoặc Guardrails không có trong Admin Settings | Lỗi nêu tên kiểm tra đã thất bại. Muốn lưu cần vai trò Admin của workspace, và **Admin Settings** chỉ có trong menu cho Owner và Admin của organization. Admin của workspace không thuộc hai vai trò đó mở **Guardrails** từ một liên kết trực tiếp. | [Guardrail tùy chỉnh](https://docs.cloudthinker.io/vi/guide/security/custom-guardrails.md#khắc-phục-sự-cố) |
| Bạn không thể thay đổi cài đặt BYOK của workspace | Bạn không phải Admin của workspace, hoặc Owner bắt buộc dùng key của organization ở mọi nơi. Trang cho biết là trường hợp nào. | [BYOK](https://docs.cloudthinker.io/vi/guide/byok.md#khắc-phục-sự-cố) |
| Workspace tiếp tục chi tiêu vượt giới hạn credit | Điều đó là bình thường với **Notify only**, chế độ không bao giờ chặn. Chuyển workspace sang **Throttle** để dừng chi tiêu trả phí tại giới hạn. | [Cách thực thi hoạt động](https://docs.cloudthinker.io/vi/guide/billing/credit-limits.md#cách-áp-dụng-giới-hạn) |
| Workspace ngừng chạy agent nhưng chat vẫn hoạt động | Workspace đang ở **Throttle** và đã chạm giới hạn, nên chỉ còn credit miễn phí hằng ngày. | [Giới hạn credit](https://docs.cloudthinker.io/vi/guide/billing/credit-limits.md#khắc-phục-sự-cố) |

## Thu thập thông tin chẩn đoán

Kiểm tra những mục sau trước khi nhờ hỗ trợ. Chúng thường tự cho thấy nguyên nhân.

* **Lượt chạy automation:** mở lượt chạy từ **Runs** và đọc cuộc hội thoại để tìm lỗi.
* **Sự cố:** nhấn **Watch live** để xem từng bước kiểm tra ngay khi chạy.
* **Kết nối:** mở kết nối. Bảng chi tiết hiển thị lỗi gần nhất.
* **Ai đã thay đổi gì:** **Admin Settings → Audit Logs** (vai trò Admin của organization, gói Scale trở lên).
* **CLI:** `cloudthinker whoami` và `cloudthinker auth status` cho biết bạn đang đăng nhập với tư cách ai và các workspace đã lưu. Với lượt chạy headless, `cloudthinker chat status <run_id>` hiển thị trạng thái của lượt chạy.
* **Worker:** `cloudthinker worker doctor` trong thư mục của Worker in ra những gì đã thất bại và cách khắc phục.

## Vẫn chưa giải quyết được?

Hỏi trong [CloudThinker Discord](https://discord.com/invite/sRBWRWtaNR) hoặc [liên hệ với chúng tôi](https://cloudthinker.io/contact). Kèm theo:

* Tên workspace của bạn
* Điều bạn mong đợi, và điều đã xảy ra thay vào đó
* Những gì bạn đã nhấn, hoặc lệnh bạn đã chạy
* Nội dung lỗi chính xác, và run ID nếu có
* Thời điểm xảy ra, kèm múi giờ của bạn

## Liên quan

> **[Thuật ngữ](https://docs.cloudthinker.io/vi/guide/glossary.md)**
>
> Tra cứu bất kỳ thuật ngữ CloudThinker nào.

> **[FAQ](https://docs.cloudthinker.io/vi/learn/faq.md)**
>
> Câu trả lời cho các câu hỏi thường gặp về gói, dữ liệu và quyền truy cập.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.