サポート手順

まず問題を切り分け、十分な診断情報を提出

初回接続からビルド・性能診断まで、決められた順序で確認できます。まずローカルネットワーク、接続先、認証情報、ノード状態を確認し、その後ツールチェーンやリソース指標を調べることで、試行錯誤を減らし、サポート側でも問題を再現しやすくなります。

diagnostic-path
01 ローカルネットワークを確認 基本層
02 接続先と認証を確認 接続層
03 ノード状態を確認 管理層
04 タスクとリソース指標を収集 タスク層

経路を検索

症状から対応手順を検索

エラー内容、接続方法、システムタスク、ノード状態を入力してください。検索対象はこのページの表示文書のみで、入力内容はアップロードされません。

7件の対応手順を表示

初回利用

初回接続前に確認すること

ノードが準備完了か、認証情報の入手元が正しいか、ローカルネットワークから到達できるかを確認し、キーボード配列とタイムゾーンを合わせます。

確認の目安:3~5分
接続トラブル

接続タイムアウトまたは認証失敗

ローカルネットワーク、接続先、認証情報、ノード状態、クライアント設定を順番に切り分けます。

5層のチェックを順番に実行
ビルドタスク

Xcode、署名、依存関係の異常

まずツールのバージョンを固定し、署名素材、依存関係キャッシュ、ディスク容量、タスクログを確認します。

コマンド全文とタイムスタンプを保存
性能診断

ビルドの遅延または応答の揺らぎ

異常発生時にCPU、メモリ、ディスク、ネットワークを同時に記録し、一瞬のスクリーンショットだけを提出しないでください。

5~10分間の連続サンプリングを推奨
問い合わせ

どの種類の問い合わせを選ぶべきか

アカウント、ノード到達不能、ハードウェア異常、データ関連の依頼に分類し、それぞれに必要な最小限の証拠を添付します。

既存の注文にはコンソール問い合わせが適しています
状態の判定

リージョンの揺らぎか、単一ノードの障害か

同一リージョンとの比較、異なるネットワークでのテスト、コンソールの状態を使い、影響範囲を明確にします。

影響範囲を確認してから問い合わせる
証拠の準備

どの情報を提出すると効果的か

ノード識別子、時間範囲、エラー原文、再現手順、マスキング済みログを整理し、追加確認の往復を減らします。

パスワード、秘密鍵、プロジェクトソースの提出は禁止

初回セッション

初回利用チェックリスト:再現可能な接続基準を作る

複数の接続パラメータを同時に変更しないでください。各手順の結果を記録しておけば、失敗時に原因がローカル、ネットワーク、認証、ノードのどこにあるか判断できます。

  1. 01

    ノード状態を確認

    コンソールで対象ノードが準備完了と表示されているか確認し、ノード識別子、リージョン、選択したモデルを照合します。ノードが準備中の場合、クライアントのエラーだけで接続障害と判断しないでください。

    完了基準:ノード識別子が注文と一致し、接続可能な状態であること。
  2. 02

    ログイン情報をコピー

    コンソールの現在のノード詳細からアドレス、ポート、ユーザー名をコピーし、古い問い合わせ、スクリーンショット、別ノードの記録は使わないでください。パスワードを貼り付ける際は前後の空白と全角文字に注意します。

    完了基準:アドレス、ポート、ユーザー名が同じノード詳細に由来すること。
  3. 03

    ローカルネットワークを検証

    まず通常のHTTPSアクセスが正常か確認し、オフィスネットワークと信頼できる予備ネットワークをそれぞれテストします。企業の出口、ファイアウォール、プロキシが特定ポートだけを遮断する場合があるため、ウェブページが開けてもリモート接続できるとは限りません。

    完了基準:使用ネットワーク、出口の種類、失敗時刻を記録すること。
  4. 04

    キーボード配列を調整

    macOSのグラフィカルインターフェースに入ったら、文字、数字、記号、Command、Optionのマッピングを確認します。記号の位置が合わない場合は、ローカルとリモートで選択したキーボード配列も記録します。

    完了基準:ターミナルでコマンド中の引用符、スラッシュ、ハイフンを正確に入力できること。
  5. 05

    タイムゾーンと時刻を統一

    タスクログ、CI記録、問い合わせの時刻には同じタイムゾーンを明記します。断続的なエラーを調べる際、「14:20」だけではノードのイベントと照合できません。タイムゾーン付きの完全な日時を使用してください。

    完了基準:ローカル、ノード、自動化ログの時刻を相互に換算できること。
初回接続に成功したら、機密認証情報を含まない基準記録を保存することをおすすめします。ノード識別子、リージョン、接続方法、クライアントバージョン、キーボード配列、タイムゾーン、成功した接続時刻を記録してください。以後の異常をこの基準と直接比較できます。

判断フロー

接続トラブルの判断フロー:一度に1層ずつ切り分ける

接続タイムアウトは通常ネットワークまたはアドレス、認証失敗は通常ユーザー名、パスワード、鍵、クライアント設定を示します。まずエラーの種類で分岐し、その後5層のチェックを実行してください。

1

ローカルネットワークは安定しているか

ローカル

経路を変更する一時的なプロキシを停止して再試行し、信頼できる予備ネットワークでも比較テストを行います。オフィスネットワークで失敗し予備ネットワークで成功する場合は、出口ポリシーと影響を受けたポートを記録し、まずローカルネットワーク管理者に確認してください。

継続条件:同じ接続先への接続を、少なくとも1つの信頼できるネットワークで試行済みであること。

2

接続先アドレスとポートは現在のノードのものか

接続先

コンソールに戻り、対象情報を再度コピーしてください。コマンド履歴のアドレスを再利用しないでください。ブラウザのリモートデスクトップはコンソールの入口を使用し、SSHはホスト、ポート、ユーザー名が同じ接続記録にあるか確認します。

停止条件:アドレスが変わった、または別ノードの記録である場合は、更新して再テストすること。

3

認証情報は完全で、入力方式による書き換えがないか

認証

ユーザー名の大文字・小文字、パスワード前後の空白、鍵ファイルの権限、選択したIDファイルを確認します。SSHホストフィンガープリントが初めて表示された場合はコンソール情報と照合してください。予期せず変わった場合は接続を停止し、問い合わせで理由を確認します。

証拠の要件:エラー原文を残しつつ、パスワード、鍵の内容、完全な接続先アドレスを隠すこと。

4

コンソールのノード状態は接続を許可しているか

ノード

ノード詳細を更新し、状態、ノード識別子、最終変更時刻を確認します。状態に異常がある場合、再起動などの操作を繰り返さないでください。操作前の状態、実行済みの操作、各操作の時刻を記録し、障害発生時の情報を上書きしないようにします。

問い合わせ条件:ノード状態に異常がある、または正常でも2つの信頼できるネットワークから到達できないこと。

5

クライアント設定が表示またはセッションの問題を起こしていないか

クライアント

ブラウザ画面が空白の場合は、現行の安定版ブラウザを使い、そのサイトのセッションデータを消去して再試行します。キーボードがずれる場合は配列を1つに絞り、SSHセッションが頻繁に切断される場合はターミナルプラグインを停止して基本コマンドで比較用セッションを確立します。

完了条件:クライアント名、バージョン、接続方法、再現手順を記録すること。

エラーが「タイムアウト」または「到達不能」の場合

ネットワークの種類、失敗時刻、対象リージョン、2つのネットワークの比較結果、コンソール上のノード状態を優先して提出します。時刻とノード識別子のないスクリーンショット1枚だけを送らないでください。

エラーが「認証失敗」の場合

現在のノードのユーザー名、認証方式、クライアントのIDファイルを優先して確認します。問い合わせには認証方式とエラー原文だけを記載し、パスワード、秘密鍵、直接使用できる認証情報は送らないでください。

ビルドパイプライン

ビルドタスクのトラブルシューティング:ツールバージョンから外側へ確認

ビルドエラーは最後の要約行ではなく、最初に発生した明確なエラーから調べます。まずツールチェーンを固定し、次に署名、依存関係、ディスク、自動化プロセスを確認してください。

Xcodeツールチェーン

macOSバージョン、Xcodeバージョン、コマンドラインツールのパス、ビルドコマンドを記録します。グラフィカルインターフェースと自動化タスクが異なるツールパスを呼び出すと、同じノードでも結果が異なる場合があります。

  • タスクが実際に呼び出すXcodeパスを確認
  • ビルドコマンド全文と作業ディレクトリを保存
  • 成功タスクと失敗タスクのバージョン差を比較

証明書と署名

証明書の不足、プロビジョニングプロファイルの不一致、権限範囲の不整合、キーチェーンアクセスの失敗を区別します。診断時は証明書名、有効期限、エラー内容を残し、証明書ファイル、パスワード、プロジェクトの機密識別子を隠してください。

  • 自動化プロセスが必要な署名素材にアクセスできることを確認
  • ターゲット、ビルド設定、署名設定が一致しているか確認
  • アーカイブ、書き出し、アップロードのどの段階でエラーが発生したか記録

依存関係とキャッシュ

まずロックファイルによって失敗を安定して再現できるか判断し、キャッシュは最小限の範囲だけを削除します。すべての依存関係とビルドキャッシュを一度に削除すると変数が増え、元の問題が一時的に消えて特定できなくなる場合があります。

  • 依存関係ロックファイルとパッケージマネージャーのバージョンを保存
  • 失敗したターゲットに直接関係するキャッシュだけを削除
  • 削除前後の初回ビルド時間とエラーの差を記録

ディスクと自動化ログ

アーカイブ、依存関係の展開、一時生成物には追加容量が必要です。プロジェクトディレクトリのサイズを見るだけでは不十分で、空き容量、一時ディレクトリ、ビルドキャッシュ、自動化プロセスがリソース不足で終了していないかも確認します。

  • 失敗の前後で空きディスク容量を記録
  • タスクの開始時刻、終了時刻、終了コードを保存
  • 最初のエラーの前後を少なくとも50行ログで取得

パフォーマンスサンプル

性能診断:同じ時間帯の4種類の指標を記録

CPUのスクリーンショット1枚だけでは、ディスク待ち、メモリ圧迫、ネットワークの揺らぎは説明できません。問題の前後5~10分間、連続してサンプリングし、タスクの開始時刻と失敗時刻を記録してください。

指標 最低限の記録 注目すべき現象 タスクとの比較
CPU 全体使用率、主要プロセス、サンプリング時刻 単一プロセスの継続的な高負荷、負荷の急増、タスク終了後も使用率が戻らない コンパイル、リンク、テスト、推論の開始時刻を記録
メモリ 使用量、メモリプレッシャー、スワップ領域 プレッシャーの継続的な上昇、頻繁なスワップ、システムによるプロセス終了 並列タスク数と入力規模を記録
ディスク 空き容量、読み書きスループット、I/O待ち時間 容量が枯渇に近い、展開やアーカイブで待ち時間が目立つ 依存関係のダウンロード、ビルドキャッシュ、生成物の書き込みを区別
ネットワーク ローカルネットワークの種類、往復遅延、パケットロス 特定の出口だけ異常、操作は重いがノード内のタスクは正常 リモート画面、依存関係のダウンロード、コード取得を区別
サンプル

異常の前後をカバーしてサンプリング

タスク開始前から基準値を記録し、異常後少なくとも1分間続けます。異常の瞬間だけのデータでは、リソースが原因か結果か判断できません。

比較

正常なタスクを1回比較用に保存

同じプロジェクト、依存関係、並列度で正常なタスクを1回記録し、総時間だけでなく各段階の所要時間とリソース曲線を比較します。

境界

操作の遅さと計算の遅さをまず区別

リモート画面は途切れるがノード内タスクの所要時間が安定している場合、まずネットワークを確認します。タスク自体の時間が増えている場合はCPU、メモリ、ディスクを確認します。

最小限の証拠

最小限の診断情報:問題を再現可能にする

サポート依頼でプロジェクト全体をアップロードする必要はありません。以下の項目で通常は初回判断が可能です。不足がある場合は追加情報をお願いします。

  1. 01

    ノードと環境

    ノード識別子、ノードリージョン、macOSバージョン、Xcodeまたはクライアントのバージョン。パスワード、秘密鍵、完全な認証情報は入力しないでください。

  2. 02

    正確な時間範囲

    「日付+時分秒+タイムゾーン」を使い、初回発生、最終発生、直近の再現時刻を明記します。

  3. 03

    エラー原文と終了コード

    検索可能なテキストをコピーし、スクリーンショットだけにしないでください。エラーコード、失敗段階、最初のエラー前後のログコンテキストを残します。

  4. 04

    最短の再現手順

    既知の正常な状態から開始し、操作、コマンド、期待結果、実際の結果を順番に記載し、再現頻度も説明します。

  5. 05

    実施済みの操作

    ネットワークの切り替え、アドレスの更新、キャッシュの削除、タスクの再起動を行った時刻と結果を記載し、同じ操作の繰り返しで現場情報を上書きしないようにします。

問い合わせルール

問い合わせルール:影響対象で分類

1件の問い合わせには1つの主な問題だけを記載します。アカウントアクセスとノード障害が同時に発生した場合は、処理状況が互いに上書きされないよう別々に記録してください。

分類 対象となる状況 推奨する証拠 優先チャネル
アカウントの問題 コンソールに入れない、アカウント情報またはアクセス認証に異常がある 登録メールアドレス、発生時刻、画面のエラー原文、ブラウザバージョン サポートメール
ノードに到達できない ノードは接続可能と表示されるが、ブラウザのリモートデスクトップとSSHのどちらもセッションを確立できない ノード識別子、リージョン、2つのネットワークのテスト結果、エラー時刻と原文 コンソール問い合わせ
ハードウェア異常 異常な再起動、ストレージエラー、単一タスクでは説明できないリソース異常が継続して発生する ノード識別子、システムログの時間範囲、異常前のタスク、再現頻度 コンソール問い合わせ
データ関連の依頼 ノードの解放、データエクスポート手順、プライバシー権利に関する依頼 注文識別子、依頼範囲、希望する対応、必要な本人確認情報 コンソール問い合わせ
影響レベルA

ノード全体に到達できない

ノードは接続可能な状態ですが、2つの信頼できるネットワークでテストしてもブラウザのリモートデスクトップとSSHの両方に到達できません。ノード識別子、リージョン、最後に成功した接続時刻を提出してください。

影響レベルB

主要タスクが停止

ノードには接続できますが、固定したツールチェーンでビルドまたは自動化タスクが安定して失敗します。最初のエラー、コマンド全文、終了コード、最短の再現手順を提出してください。

影響レベルC

設定・利用に関する相談

ノードは利用可能で、キーボード、解像度、依存関係キャッシュ、ワークフロー最適化に関する問題です。現在の設定、目標、検証済みの方法を説明してください。

サービス継続性

サービス継続性と状態の判定

すべてのノードは年間365日の通常稼働を前提に設計されています。異常が発生した場合は、影響範囲からリージョンネットワークの揺らぎ、単一ノード障害、ローカル接続の問題を区別してください。

リージョン

リージョンネットワークの揺らぎ

同一地域の複数の接続元で、近い時間帯に遅延増加、パケットロス、セッション切断が発生している一方、ノード内のタスクは継続している可能性があります。

  • 接続元の都市、通信事業者、ネットワーク種別を記録
  • 信頼できる予備ネットワークで比較する
  • 開始時刻、継続時間、対象リージョンを提示
ノード

単一ノード障害

ローカルネットワークと同一リージョンの他サービスは正常なのに、対象ノードの状態に異常、繰り返す切断、ユーザータスクでは説明できないシステムエラーがある

  • ノード識別子とコンソール状態を保存
  • 現場を変える可能性のある操作の繰り返しを停止
  • コンソール問い合わせで注文記録と関連付ける
ローカル

ローカルまたはクライアントの問題

対象ノードは予備ネットワークや別クライアントから正常にアクセスできるが、特定のオフィス出口、ブラウザ設定、SSHクライアントだけが失敗する

  • 失敗環境と成功環境の差を比較
  • プロキシ、ファイアウォール、クライアントバージョンを確認
  • ネットワークポリシーの問題をローカル管理者に確認

状態は検証可能な事実で記述

推奨例

「ノード SG-例に2026年8月8日14:20 +0800からSSH接続できません。自宅ネットワークとオフィスネットワークの両方でタイムアウトし、コンソールの状態は接続可能のままです。」

曖昧な説明を避ける

「サーバーが壊れた」「ネットワークが遅い」「たまに切れる」だけでは不十分です。ノード、時刻、ネットワークの接続元、エラー原文がなければ影響範囲を特定できません。

よくある質問

サポート依頼前のよくある質問

ノードに接続できない場合、最初に何をすべきですか?

まずコンソールでノード識別子と状態を確認し、現在のノード詳細からアドレス、ポート、ユーザー名を再コピーします。その後、信頼できる予備ネットワークで比較します。状態を記録する前に、ノード状態を変える操作を複数回続けて実行しないでください。

ビルド失敗では完全なログを提出する必要がありますか?

最初のエラー前後少なくとも50行、ビルドコマンド全文、終了コード、Xcodeバージョン、発生時刻を優先して提出してください。完全なログにプロジェクトパス、リポジトリURL、署名情報が含まれる場合は先にマスキングします。エラーコードとタイムスタンプは削除しないでください。

性能のスクリーンショット1枚だけでは不十分なのはなぜですか?

スクリーンショットは1瞬間しか示さず、リソース変化がタスクの前後どちらで起きたか判断できません。CPU、メモリ、ディスク、ネットワークを5~10分間連続記録し、タスクの開始、異常、終了時刻を示してください。

メールとコンソール問い合わせのどちらを送るべきですか?

既存の注文、ノード、ハードウェア、データ関連の依頼は、注文とノード記録を関連付けやすいコンソール問い合わせを優先してください。コンソールに入れないアカウントの問題は support@macworker.com にメールできます。当サイトの連絡窓口はこの2種類のみです。

問い合わせやメールに入れてはいけない内容は何ですか?

パスワード、秘密鍵、決済情報、完全な接続先アドレス、プロジェクトソースを提出しないでください。ログの機密値は隠して構いませんが、項目名、バージョン、エラーコード、タイムスタンプ、呼び出し順序は残してください。

問い合わせの準備はできましたか?

ノード識別子、時刻、エラー原文は揃っていますか?

コンソール問い合わせで既存の注文と関連付け、最短の再現手順とマスキング済みログを提出してください。まだノードを借りていない場合は、ポータルから専用物理マシンの構成、リージョン、期間を選択できます。