# ログ

POS には 2 つのログインターフェースがあります。**アプリ内のログ画面**（POS アプリケーション内）と **WP Admin のログページ**（WordPress 内）です。これらを組み合わせることで、デバッグと監査のための POS アクティビティの全体像を把握できます。

<!-- -->

## POS アプリケーションのログ[​](#pos-application-logs "POS アプリケーションのログへの直接リンク")

### ログへのアクセス[​](#accessing-logs "ログへのアクセスへの直接リンク")

左側のナビゲーションドロワー（ハートビートアイコン）からログ画面を開きます。

### インターフェースの概要[​](#interface-overview "インターフェースの概要への直接リンク")

#### 検索とフィルター[​](#search--filter "検索とフィルターへの直接リンク")

* **ログを検索** - メッセージの内容によって特定のログエントリを見つける
* **ログレベルフィルター** - ログレベル（情報、警告、エラー）でフィルタリング
* **表示設定** - 表示される列を設定

#### ログテーブル[​](#log-table "ログテーブルへの直接リンク")

各ログエントリは以下の情報を示します：

| 列               | 説明                                                  |
| ---------------- | ----------------------------------------------------- |
| **時間**         | イベントが発生した時間                                |
| **レベル**       | 重大度: info（グレー）、warn（オレンジ）、error（赤） |
| **メッセージ**   | イベントの人間が読める説明                            |
| **コンテキスト** | 追加の詳細を含む展開可能な JSON                       |
| **コード**       | エラーコード（ドキュメントへのリンク）                |

### ログレベル[​](#log-levels "ログレベルへの直接リンク")

#### Info（グレー）[​](#info-grey "Info（グレー）への直接リンク")

通常の操作と成功したイベント：

* 「製品の全 ID を取得しました」
* 「新しい顧客を同期しました」
* 「税金の全 ID を取得しました」

#### Warning（オレンジ）[​](#warning-orange "Warning（オレンジ）への直接リンク")

注意が必要な非クリティカルな問題：

* 「セッションを更新できません」
* 「同期のための再試行」

#### Error（赤）[​](#error-red "Error（赤）への直接リンク")

対処が必要な問題：

* 「申し訳ありませんが、リソースを一覧表示することはできません」（権限の問題）
* 「API リクエストが失敗しました」
* 「データベース同期エラー」

#### Audit（青）[​](#audit-blue "Audit（青）への直接リンク")

監査ログレベルは、POS によって行われたデータベースの変更を記録し、各変更の前後の完全な状態をキャプチャします。これは、たとえば注文作成、在庫調整、顧客更新の際に、何がいつ変更されたかを正確に追跡するのに役立ちます。

監査エントリには次の情報が含まれます：

* **エンティティタイプ** - 変更されたリソース（例：注文、商品、顧客）
* **アクション** - 変更の種類（作成、更新、削除）
* **変更前の状態** - 変更前の以前の値
* **変更後の状態** - 変更後の新しい値

### コンテキストデータ[​](#context-data "コンテキストデータへの直接リンク")

任意のログエントリの展開矢印をクリックして、詳細な JSON コンテキストを表示します：

```
{

  "total": "6",

  "execution_time": "54.79 ms",

  "server_load": "[10.51, 10.42, 9.98]"

}
```

このデータには以下が含まれます：

* **アイテム数** - 影響を受けたレコードの数
* **実行時間** - 操作にかかった時間
* **サーバーロード** - サーバーのパフォーマンスメトリック
* **リクエスト／レスポンスの詳細** - API の問題をデバッグするため

### エラーコード[​](#error-codes "エラーコードへの直接リンク")

多くのログエントリには**エラーコード**（例：`API02004`、`DB01001`）が含まれています。これらのコードは [エラーコード](/ja/error-codes/.md)ドキュメントに直接リンクしており、以下を提供します：

* エラーの詳細な説明
* 一般的な原因
* トラブルシューティング手順

### 一般的なログエントリ[​](#common-log-entries "一般的なログエントリへの直接リンク")

#### 同期操作[​](#sync-operations "同期操作への直接リンク")

```
[info] Fetched all IDs for products    {...} 3 items

[info] Synced new customers            {...} 1 item

[info] Fetched all IDs for taxes       {...} 3 items
```

これらは通常の同期活動を示します。コンテキストは、いくつのアイテムが同期されたかを示しています。

#### 権限エラー[​](#permission-errors "権限エラーへの直接リンク")

```
[error] Sorry, you cannot list resources    {...} API02004
```

これは通常、ユーザーがリソースにアクセスする権限を持っていないことを意味します。`WP Admin > POS > Settings > Access` でユーザーロールを確認してください。

#### セッションの問題[​](#session-issues "セッションの問題への直接リンク")

```
[warn] Unable to refresh session    {...} API02007
```

POS は認証セッションを更新できませんでした。ログアウトして再ログインする必要があるかもしれません。

## WP Admin のログページ[​](#wp-admin-logs-page "WP Admin のログページへの直接リンク")

POS プラグインは、WordPress 管理エリアにサーバー側のログページも提供します。このページには、サーバーに記録された POS 固有の警告とエラーが表示され、POS アプリケーション自体には表示されない可能性のある問題の診断に役立ちます。

### WP Admin ログページへのアクセス[​](#accessing-the-wp-admin-logs-page "WP Admin ログページへのアクセスへの直接リンク")

**WP Admin > POS > Settings** に移動し、**Tools** タブを選択して **Logs** をクリックします。

### 未読バッジ[​](#unread-badge "未読バッジへの直接リンク")

Logs メニュー項目には、未読のログエントリを示すバッジが表示されます：

* **赤いバッジ** - 未読のエラーレベルのエントリがあります
* **アンバーのバッジ** - 未読の警告レベルのエントリがあります（ただしエラーはなし）

Logs ページを訪れると未読カウントがリセットされます。カウントはユーザーごとに追跡されるため、各管理者は自分自身の未読ステータスを見ます。

### エントリのフィルタリング[​](#filtering-entries "エントリのフィルタリングへの直接リンク")

レベルフィルターを使用してログエントリを絞り込みます：

* **All** - すべてのログエントリを表示
* **Errors** - エラーレベルのエントリのみを表示
* **Warnings** - 警告レベルのエントリのみを表示

### 展開可能なエントリ[​](#expandable-entries "展開可能なエントリへの直接リンク")

長いログメッセージはおよそ 100 文字で切り詰められます。エントリをクリックして展開すると、追加のコンテキストデータとともに完全なメッセージが表示されます。

### ページネーション[​](#pagination "ページネーションへの直接リンク")

ログエントリはサーバー側でページ分けされます。ページネーションコントロールを使用して、古いエントリをナビゲートします。

### 致命的エラーバナー[​](#fatal-errors-banner "致命的エラーバナーへの直接リンク")

サーバーに `fatal-errors-*.log` ファイルがある場合、Logs ページの上部に警告バナーが表示されます。このバナーは **WooCommerce > Status > Logs** にリンクしており、そこで完全な致命的エラーログを表示できます。致命的エラーは通常、POS API が応答できなくなる PHP レベルのクラッシュです。

## サポートのためのログの使用[​](#using-logs-for-support "サポートのためのログの使用への直接リンク")

サポートをリクエストする際は：

1. **問題を再現する** - 問題を引き起こすアクションを実行する
2. **ログを確認する** - エラー（赤）や警告（オレンジ）を探す
3. **コンテキストを展開する** - 完全な JSON 詳細を取得する
4. **エラーコードをメモする** - これをサポートリクエストに含める
5. **関連エントリをコピーする** - コンテキスト付きでログメッセージを共有する

## パフォーマンスモニタリング[​](#performance-monitoring "パフォーマンスモニタリングへの直接リンク")

ログには実行時間とサーバーロードメトリックが含まれています。以下に注意してください：

* **高い実行時間** - サーバーが過負荷または遅い可能性があります
* **高いサーバーロード値** - サーバーの最適化を検討してください
* **頻繁なタイムアウト** - ネットワーク接続を確認する

## 関連ドキュメント[​](#related-documentation "関連ドキュメントへの直接リンク")

[エラーコードエラーの詳細な説明](/ja/error-codes/.md)

[トラブルシューティング一般的な問題と解決策](/ja/category/troubleshooting.md)

[サポートヘルプを得る](/ja/support/.md)