トラブルシューティング

展開を変更する前に証拠を集める。

厳密なサービス名、ポート、ログパス、実行コマンド、修復手順はリリース依存です。本ガイドは安全な切り分け手順とエスカレーション資料を示します。是正コマンドは現行の公式文書に従ってください。

インストール公式文書 ↗

修復を試みる前に失敗の状態を保存する。

バックアップとロールバックの計画なしに、データ削除、認証情報のリセット、リモートインストーラーの再実行、複数変数の同時変更を行わないでください。

01 範囲と時刻を記録：影響を受けたユーザー、プロジェクト、タスク、ホスト、初回発生、最後の正常状態、最近の変更。
02 バージョンと構成を記録：MonkeyCode のリリースと commit、展開方式、OS、ホスト役割、リソース、エンドポイント、secret を含まない設定変更。
03 証拠を保全：関連するエラー、時刻、要求 ID、リソース指標、ディスク状態、ネットワーク結果、マスク済みログ。
04 境界を 1 つに絞る：コンソール、環境ホスト、Git、モデル、package アクセス、DNS/TLS、ストレージを個別に試します。
05 承認済みの復旧を使う：現行文書に従い、戻せる変更を 1 つだけ行い、結果を確認して記録します。

インシデントを正しい境界に振り分ける。

これらの確認は分類のためのものであり、文書化されていない製品の修復コマンドではありません。

インストーラーまたはコンソールが利用不可：現行の公式コマンド、DNS/TLS、ホスト資源、ディスク容量、インストーラーの出所、時刻、文書化された前提条件を再確認します。
環境が起動しない：独立した開発ホスト、容量、ストレージ、ネットワーク経路、最近変更した image と package、並行需要を確認します。
リポジトリアクセスが失敗：URL、認証情報の範囲、有効期限、取消、ブランチ権限、DNS/TLS、プロバイダーの可用性を確認します。
モデル要求が失敗：厳密なモデル ID、エンドポイント、認証情報、割り当て、地域、ネットワーク経路、timeout、プロバイダー状態を確認します。
ビルドまたは preview が失敗：環境内でコマンドを再現し、依存関係、ポート、ディスク、メモリ、成果物、アプリケーションログを調べます。
アップグレードまたは復旧が失敗：破壊的な変更を止め、状態を保全し、対応バージョンを比較し、復元を別途試し、証拠を添えてエスカレーションします。

issue を再現可能で安全に共有できる形にする。

token、ソースコード、社内 URL、顧客データ、プロンプト、マスクされていないログを公開しないでください。

概要：期待した結果、実際の結果、影響、時刻、再現性。
環境：バージョン、展開モード、OS、ホスト役割と資源、ネットワーク構成。
手順：機密でないデータを使った最小の番号付き再現手順。
証拠：マスク済みのエラー、ログ、スクリーンショット、指標、要求 ID。
試した変更：1 回に 1 変更、結果、ロールバック状況。

公開 issue の証拠

最近の報告から、どこでより良い診断情報を集めるべきかが分かります。

これらは個別の GitHub ユーザー報告であり、発生率のデータでも、確定した根本原因でも、サポートの約束でも、すべての展開が影響を受ける証明でもありません。issue の状態は確認日以降に変わることがあります。

モデル要求: issue #870

モデル呼び出しの失敗が繰り返し発生し、コンテキスト上限やリソースに関する明確な案内を求める報告がありました。

この報告を見る (オープン) →

環境起動: issue #872

カスタム image の繰り返し取得が遅く、時折取得に失敗するという報告がありました。

この報告を見る (オープン) →

タスク復旧: issue #828

API の失敗後にタスク UI が実行中のまま残り、コンテキスト圧縮も繰り返し失敗するという報告がありました。

この報告を見る (オープン) →

リポジトリ ID: issue #819

国際版ホスト型サービスで GitHub のサイト ID を連携する際に 404 になるという報告がありました。

この報告を見る (オープン) →

プレビュー: issue #842

PHP サイトのプレビューが不安定だという報告がありました。

この報告を見る (オープン) →

影響を受けるバージョン、バックアップ、アクセス承認、現在のメンテナー guidance を確認せずに、issue の破壊的または特権的な回避策をそのまま使わないでください。症状を比べる前に、自分側のマスク済み証拠を集めてください。

公開 issue レポート

マスク済みで再現可能な報告として安全に共有する。

Issue #870 ↗Issue #872 ↗Issue #828 ↗Issue #819 ↗Issue #842 ↗

容量の妥当性確認

公開された 2 つのインフラ下限を確認する。

この下限を満たしても、本番容量が十分である証明にはなりません。

構成要素	CPU	メモリ	ストレージ
MonkeyCode コンソール	2 cores	4 GB	40 GB
開発環境ホスト	8 cores	16 GB	100 GB

MonkeyCode プロジェクトによる公開値。2026-08-05 に確認。並行実行、ビルド、イメージキャッシュ、リポジトリ、ログ、保持成果物の余裕を追加してください。

よくある質問

よくある質問と回答

MonkeyCode がインストールできない、またはコンソールが使えない場合は何を確認しますか？

現行の公式インストールコマンド、DNS と TLS、ホスト資源、ディスク容量、インストーラーの出所、システム時刻、文書化された前提条件を再確認します。一度に 1 つだけ戻せる変更を行い、是正コマンドは現行文書に従ってください。

開発環境が起動しない場合はどこを見ますか？

独立した開発環境ホストを確認します。容量、ストレージ、ネットワーク経路、最近変更した image や package、並行需要です。コンソールと環境ホストは別の役割で、失敗の理由も異なります。

モデル要求が失敗する場合、どう診断しますか？

厳密なモデル ID、エンドポイント、認証情報、割り当て、地域、ネットワーク経路、timeout、プロバイダー状態を確認します。原因が明確でないモデル呼び出し失敗を報告した公開 issue があるため、設定を変える前に要求 ID とプロバイダーの応答を保存してください。

リポジトリアクセスや Git 連携が失敗する原因は？

リポジトリ URL、認証情報の範囲、有効期限と取消、ブランチ権限、DNS/TLS、プロバイダーの可用性を確認します。国際版ホスト型サービスで GitHub 身份を連携する際に 404 になるという公開 issue があるため、実際のプロバイダーとホスティングの組み合わせを検証してください。

MonkeyCode の問題はどう安全に報告しますか？

マスク済みで再現可能な報告を用意します。概要、環境、最小手順、証拠、試した変更です。token、ソースコード、社内 URL、顧客データ、プロンプト、マスクされていないログは決して公開しないでください。

証拠に関する注記

Issueは症状の証拠であり、普遍性や公式修正を保証しません。

MONKEYCODE

展開を変更する前に証拠を集める。

MONKEYCODE 日本語製品概要セルフホストセキュリティインストールモデルガイド