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

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

### 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 サイト上のファイルにアクセスするには、まずサイト ID を取得します:

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

次に、そのサイト 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: 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:

```
GET https://docs.konnekt.io/ja/troubleshooting/graph-explorer-defairunowosuru.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.