> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/ja/troubleshooting/reproduce-file-issues-with-graph-explorer.md).

# Graph Explorer でファイルの問題を再現する

ユーザーがブラウジングの遅延、ファイルのオープン失敗、またはその他のファイル操作エラーを報告し、KONNEKT のデバッグログに Graph API エラーが表示されている場合、Microsoft Graph Explorer を使うと、失敗した要求をブラウザーで直接再現できます。これにより、根本原因が Microsoft 365 のバックエンドにあるのか、KONNEKT にあるのかを切り分けられ、Microsoft サポート チケット用の明確な証拠を作成できます。

{% hint style="info" %}
Microsoft Graph Explorer は、Microsoft が提供する無料のブラウザーベースのツールです。これにより Microsoft Graph API に要求を送信します。これは、KONNEKT、Microsoft OneDrive 同期アプリ、Microsoft Teams、そして Microsoft 365 自体が SharePoint Online と OneDrive のファイルを読み書きするために使用するのと同じインターフェイスです。インストールは不要です。
{% endhint %}

## このガイドを使用するタイミング

次の場合にこの手順を使用します:

* 複数のユーザーが同時に同じ問題を報告している場合（多くはバックエンドの問題の兆候です）。
* KONNEKT のデバッグログに Graph API エラー（HTTP 429、500、503、504、または `UnknownError`).
* 問題がサードパーティ製ソフトウェアによるものではないことを Microsoft サポートに証明する必要がある場合。
* 通常の KONNEKT チェックで問題が否定された後も、断続的な遅さが続く場合。

### デバッグログを収集して確認する

KONNEKT ログをサポートに渡す通常の方法は、 `crashguard.exe` から `C:\Program Files\Konnekt`を実行することです。このフローではログがパッケージ化され、バックグラウンドで静かにアップロードされます。ほとんどの場合、ユーザーも管理者も何が起きているか気づきません。標準のサポート ワークフローについては、 [デバッグログの準備](https://docs.konnekt.io/troubleshooting/debug-log-preparation) を参照してください。

Graph Explorer のワークフローは異なります。失敗した要求の URL と `request-id` を Graph Explorer にコピーするために、ログ ファイルを自分でローカルで開く必要があります。ログ ファイルの場所は次のとおりです:

```
%LOCALAPPDATA%\Konnekt
```

KONNEKT は、約 1 MB の回転ログ ファイルを最大 6 個保持します。更新時刻で並べ替え、最新のファイルから開始します。テキスト エディターで開き、 `error` または調査対象の HTTP ステータス コード（たとえば、 `504`).

問題を再現する前に、ログ レベルを **デバッグ** に設定して、完全な Graph API 要求 URL と応答が記録されるようにします。 [Logging](https://docs.konnekt.io/configuration/system-settings/logging) を参照して、Preferences UI、レジストリ、または管理ポリシーを通じてログ レベルを変更する方法を確認してください。

### KONNEKT ログ内での Graph API エラーの見え方

典型的なエントリの例:

```
[2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Http request (OneDriveClient::GetItemByPath)
GET: https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504
    error: Unrecognized response(504)
    "{\"error\":{\"code\":\"UnknownError\",\"message\":\"\",\"innerError\":{
      "date":"2026-04-22T12:14:25",
      "request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719",
      "client-request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719"
    }}}"
```

後の手順のために、これらの値を記録しておきます:

* 完全な `GET` URL（HTTP ステータス コードの直前まで、ただしコード自体は含めずにすべてをコピーします）。
* HTTP ステータス コード（この例では 504）。
* 主な `request-id` 値。Microsoft サポートはこの ID を使って失敗した要求を追跡できます。

## 前提条件

* 影響を受けたユーザーの Microsoft 365 アカウントへのアクセス、またはユーザー自身がサインインできる状態。
* 最新の Web ブラウザー（Microsoft Edge、Chrome、Firefox、または Safari）。
* ユーザーが報告した正確なファイル パスとファイル名、またはデバッグログの Graph API URL。
* Microsoft 365 管理センターへのグローバル管理者アクセス（Microsoft サポート チケットを開く予定がある場合のみ）。

{% hint style="warning" %}
管理者ではなく、問題が発生しているユーザーとしてサインインする必要があります。別のアカウントを使用すると、アクセス許可とファイル アクセスが変わり、このテストは無効になります。
{% endhint %}

## 手順 1: Graph Explorer を開く

1. ブラウザーを開き、次に移動します `https://developer.microsoft.com/graph/graph-explorer`.
2. クリックします **サインイン** を左上隅でクリックします。
3. 影響を受けたユーザーの資格情報でサインインします。

## 手順 2: 必要なアクセス許可を付与する

Graph Explorer は委任されたアクセス許可を使用します。ファイル関連のテストでは、次のスコープを付与します:

| スコープ             | 目的                                    |
| ---------------- | ------------------------------------- |
| `User.Read`      | サインインしたユーザーのプロフィールを読み取る               |
| `Files.Read`     | ユーザーの OneDrive ファイルを読み取る              |
| `Files.Read.All` | ユーザーがアクセスできるすべてのファイルを読み取る             |
| `Sites.Read.All` | ユーザーがアクセスできる SharePoint サイトのアイテムを読み取る |

スコープを付与するには:

1. Graph Explorer で、 **アクセス許可の変更** タブをクエリ入力欄の下でクリックします。
2. 一覧で各スコープを見つけます。
3. クリックします **同意** 各スコープの横に
4. 同意プロンプトを受け入れます。

完全なスコープ リファレンスについては、 [Microsoft のアクセス許可リファレンス](https://learn.microsoft.com/graph/permissions-reference).

## 手順 3: テスト クエリを実行する

HTTP メソッドを `GET` に設定し、以下のいずれかのクエリをリクエスト URL フィールドに入力します。中かっこ内のプレースホルダー値を実際の値に置き換えます。

### オプション A: KONNEKT のデバッグログの URL を再利用する

次で始まるログ行から完全な URL をコピーします `GET: https://graph.microsoft.com/...`。HTTP ステータス コードの直前までを Graph Explorer の URL フィールドに貼り付けます。

失敗した要求を正確に再現できるため、これが推奨オプションです。

### オプション B: クエリを手動で作成する

ユーザーの OneDrive ルート フォルダーを一覧表示するには:

```
GET https://graph.microsoft.com/v1.0/me/drive/root/children
```

パスで特定のファイルにアクセスするには:

```
GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf
```

SharePoint サイト上のファイルにアクセスするには、まず site ID を取得します:

```
GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}
```

その site ID を使ってファイルを照会します:

```
GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf
```

クリックします **クエリを実行** し、レスポンス パネルを確認します。

## 手順 4: 結果を解釈する

レスポンス ペインには HTTP ステータス コードと JSON 本文が表示されます。以下の表を使って結果を分類し、次の手順を決めます。

| ステータス コード                                                                     | 意味                                             | 次の手順                                                                                                                        |
| ----------------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `200 OK`                                                                      | Graph API 呼び出しは成功しました。ファイルには API レベルでアクセスできます。 | 問題は KONNEKT 側またはクライアント環境にあります。次の [トラブルシューティング ハブ](https://docs.konnekt.io/troubleshooting).                                 |
| `401 Unauthorized`                                                            | トークンがない、期限切れ、または無効です。                          | Graph Explorer からサインアウトして再度サインインします。エラーが続く場合は、 [アクセス トークンの問題](https://docs.konnekt.io/troubleshooting/access-token-issues). |
| `403 Forbidden`                                                               | サインイン中のユーザーにはこのファイルまたはサイトへの権限がありません。           | KONNEKT や Microsoft のバックエンドの問題ではありません。SharePoint の Web インターフェイスでアクセス許可を確認します。                                               |
| `404 Not Found`                                                               | 指定されたパスにファイルまたはフォルダーが存在しません。                   | パスを確認してください。ファイルは移動、名前変更、または削除された可能性があります。                                                                                  |
| `429 Too Many Requests`                                                       | SharePoint Online のスロットリング。                    | Microsoft 側のレート制限です。 `Retry-After` ヘッダーを確認し、待ってから再試行します。スロットリング防止設定により再発を減らせます。                                             |
| `500 Internal Server Error`, `503 Service Unavailable`, `504 Gateway Timeout` | Microsoft 側のバックエンド エラー。                        | 問題は Microsoft 側にあります。次の手順に進みます。                                                                                             |
| `UnknownError` レスポンス本文内の                                                      | 特定のコードのない Microsoft 側のバックエンド エラー。              | 上記と同じです。以下を取得して `request-id` Microsoft サポート チケットを開きます。                                                                      |

## 手順 5: 証拠を取得する

Graph Explorer を閉じる前に、テスト内容を記録します。十分な証拠があれば、サポート チケットの解決が速くなります。

収集するもの:

* クエリ URL、HTTP ステータス コード、レスポンス本文が表示された Graph Explorer ウィンドウのスクリーンショット。
* タイムゾーンを含むテストの日時。
* サインイン中のユーザーの UPN（たとえば、 `user@contoso.com`).
* テストした正確なファイル パス。
* 主な `request-id` JSON レスポンス本文の値。
* 断続的なエラーの場合は、クエリを数回繰り返し、各結果を記録します。

## 手順 6: Microsoft サポート チケットを開く

Graph Explorer が 500、503、504、または `UnknownError` レスポンス。

1. 移動します `https://admin.microsoft.com` そして、グローバル管理者アカウントでサインインします。
2. 次に移動します **サポート** -> **新しいサービス リクエスト**.
3. 選択します **SharePoint Online** または **OneDrive for Business** を対象サービスとして選択し、失敗したエンドポイントに合わせます。
4. 問題を説明し、前の手順で取得したスクリーンショットを添付します。
5. 次を含めます: `request-id` KONNEKT のデバッグログと Graph Explorer のレスポンスの両方から。これにより Microsoft は失敗した要求を正確に追跡できます。
6. 問題が Microsoft Graph Explorer で再現されたことを明記します。

{% hint style="info" %}
Graph Explorer の証拠を含めることで、サードパーティ製ソフトウェアが原因でないことがすでに確認済みであることを示せます。Microsoft サポートでは通常、これらのチケットをより迅速に振り分けます。
{% endhint %}

## 一般的な Graph API エンドポイント

KONNEKT のデバッグログで最もよく見られるエンドポイントのクイック リファレンス:

| 操作                    | エンドポイント                                          |
| --------------------- | ------------------------------------------------ |
| ユーザー プロファイル           | `GET /me`                                        |
| OneDrive ルート一覧        | `GET /me/drive/root/children`                    |
| パスによるファイル (OneDrive)  | `GET /me/drive/root:/{path}`                     |
| アイテム ID によるファイル       | `GET /drives/{drive-id}/items/{item-id}`         |
| ホスト名とパスによるサイト         | `GET /sites/{hostname}:/{site-path}`             |
| サイト上の SharePoint ドライブ | `GET /sites/{site-id}/drives`                    |
| ファイル コンテンツのダウンロード     | `GET /drives/{drive-id}/items/{item-id}/content` |
| デルタ クエリ               | `GET /drives/{drive-id}/root/delta`              |

完全なリファレンスについては、 [Microsoft Graph Drive API](https://learn.microsoft.com/graph/api/resources/drive).

### 類似の問題

* [サイトが見つからない、またはフォルダーが空](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - SharePoint Search のバックエンド エラーの場合
* [アクセス トークンの問題](https://docs.konnekt.io/troubleshooting/access-token-issues) - 401 Unauthorized 応答の場合
* [エラーへの対処方法](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - 特定のファイルでのエラーの場合
* [デバッグログの準備](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - Graph API の詳細を含むログの収集方法
* [Logging](https://docs.konnekt.io/configuration/system-settings/logging) - ログ レベルの構成


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.konnekt.io/ja/troubleshooting/reproduce-file-issues-with-graph-explorer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.