> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 監査ログ

> 会社の主要な業務レコードを誰が作成・変更・削除したかを記録し、その履歴をレコード単位または会社全体で確認し、30 日より古いアーカイブをダウンロードします。

監査ログは、Alforse の主要な業務レコードに対する作成・更新・削除の会社ごとの履歴で、各変更を行った人と、変更されたフィールドを記録します。管理者がオンにすると、設定を閲覧する権限のある人なら誰でも、周囲に聞き回らなくても「これを誰がいつ変更したか」に答えられます。

## 監査ログのしくみ

ログ記録は**既定でオフ**で、会社ごとに別々に保持されます。オンにすると、Alforse は監査対象のエンティティに対するそれ以降のすべての変更を記録します。有効にする前やオフの間に行われた変更は、記録されません。

エントリは、変更されたデータベースの行ではなく、人が扱う業務エンティティごとにまとめられます。たとえばアイテムの原価を編集すると、基になる `itemCost` 行ではなく**アイテム**のエントリが作成されます。

### エントリの内容

| 項目 | 保持する内容 |
| - | - |
| 操作 | `INSERT`、`UPDATE`、`DELETE`。アプリでは作成、更新、削除と表示されます |
| 実行者 | 変更を行ったユーザー。システムまたはサービスロールによる変更は *System* と表示されます |
| 変更 | 古い値と新しい値のフィールド単位の差分 |
| メタデータ | リクエストの IP アドレス、ユーザーエージェント、オリジン |
| タイムスタンプ | 変更が行われた日時 |

差分では `updatedAt`、`updatedBy`、内部の埋め込みなどの管理用フィールドは除外されるため、エントリには人が気にする変更だけが表示されます。

## 監査対象のエンティティ

監査されるのは、以下のエンティティだけです。それ以外の変更は、ログ記録がオンかどうかにかかわらず記録されません。

| 販売と得意先 | 購買と仕入先 | 生産と在庫 | 財務と管理 |
| - | - | - | - |
| 得意先 | 仕入先 | アイテム | 会計期間 |
| 見積 | 仕入先見積 | アイテムの保存期限 | 仕訳行 |
| 受注 | 発注書 | ジョブ | 支払い |
| 売上請求書 | 仕入先請求書 | 作業区 | メモ |
| 出荷 | 入荷 | 棚卸 | 払戻 |
| 価格設定ルール | | ピッキングリスト | 固定資産 |
| 価格の上書き | | 倉庫移動 | 減価償却実行 |
| 価格上書きのブレーク | | 在庫移動 | 売上高認識実行 |
| レンタル契約 | | 保全スケジュール | 従業員 |
| | | 保全指示 | 招待 |
| | | 不適合 | ITAR 認定 |
| | | 変更通知 | |
| | | 測定器 | |

## ログ記録のオンとオフ

**設定 → 監査ログ**の**監査ログ**カードには、トグルが 1 つあります。

### 設定ページを開く

**設定 → 監査ログ**に移動します。

### トグルをオンにする

**監査ログ**カードで、トグルをオンにします。Alforse は会社のログ保管領域を作成し、`auditLogEnabled` を設定し、監査対象のテーブルを変更パイプラインに登録します。

### 状態を確認する

カードに *"Audit logging is enabled — All changes to auditable entities are being recorded."*（監査ログは有効です。監査対象エンティティへのすべての変更が記録されています）と表示されます。ログ記録がオフの場合は *"Audit logging is disabled — Enable to start tracking changes to your data."*（監査ログは無効です。有効にすると、データへの変更の追跡が始まります）と表示されます。

トグルをオフにすると新しいエントリは記録されなくなりますが、既存の履歴は残ります。再びオンにするとその時点から記録が再開され、オフだった間の空白は空のままです。

## 変更の確認

同じデータを、2 つの範囲で利用できます。

### 1 つのレコードの履歴

得意先、受注、ジョブ、出荷など多くの詳細ページで、**履歴**アクションを選ぶと、そのレコードのタイムラインがドロワーで開きます。各変更には、操作、実行者、時刻、変更されたフィールドの展開可能な一覧が表示されます。

ログ記録がオフの場合、ドロワーには *"Audit logging is not enabled"*（監査ログは有効ではありません）と表示されます。設定を更新できるユーザーには有効にするためのショートカットが表示され、それ以外のユーザーには管理者に連絡するよう案内されます。

### 会社全体のログ

**設定 → 監査ログ**で**すべて表示**を選択すると、全画面の**すべての監査ログ**テーブルが開きます。検索とページ分割ができ、列は**エンティティ**、**操作**、**変更者**、**変更**、**いつ**です。

| フィルター | テーブルの絞り込み先 |
| - | - |
| **エンティティ** | 受注やアイテムなど、1 つのエンティティタイプ |
| **操作** | 作成、更新、または削除 |
| **変更者** | 1 人のユーザー（実行者） |

操作は色付きのバッジで表示されます。作成は緑、更新は青、削除は赤です。行を展開するとフィールド単位の差分が表示され、**エンティティ**の値を選択すると、それが指すレコードが開きます。

## 保持期間とアーカイブ

ライブのログには **30 日**分のエントリが保持されます。毎晩、ジョブがそれより古いエントリを圧縮アーカイブに移し、アーカイブの日付範囲、行数、サイズを記録して、ライブのテーブルからそれらのエントリを削除します。

アーカイブは、設定ページの**アーカイブ済ログ**に一覧表示されます。**ダウンロード**は、圧縮エクスポートへの有効期間の短い署名付きリンクを作成します。リンクは保存せず、毎回新しいものを要求してください。最初のアーカイブができるまでは、30 日より古いログがそこにアーカイブされることがカードで説明されます。

## 権限とプラン

| アクション | 要件 |
| - | - |
| ログ記録のオン・オフ | **設定の更新**権限 |
| ログとレコード履歴の閲覧 | **設定の閲覧**権限 |
| 機能そのものの利用 | Business プラン |

設定モジュールが従業員タイプにどう対応するかは、[権限とアクセス](https://docs.alforse.com/ja/docs/reference/permissions.md)を参照してください。

## トラブルシューティング

### "Upgrade to Business to enable audit logging"（監査ログを有効にするには Business にアップグレードしてください）

**原因:** 会社が Business プランではないため、**設定 → 監査ログ**のトグルがブロックされています。
**対処:** プランをアップグレードしてから、ログ記録をオンにします。

### "Upgrade to unlock audit history"（監査履歴を利用するにはアップグレードしてください）

**原因:** 同じプランの制限が、レコードの**履歴**ドロワーに表示されています。
**対処:** Business プランにアップグレードします。この制限は、設定のトグルとドロワーの両方に適用されます。

### "Audit logging is not enabled"（監査ログは有効ではありません）

**原因:** **履歴**ドロワーを開いたものの、会社のログ記録がオフになっています。
**対処:** 設定の更新権限を持つユーザーが**設定 → 監査ログ**でオンにします。その権限がない場合は、管理者に依頼してください。

### "Failed to enable audit logging" または "Failed to disable audit logging"（監査ログの有効化／無効化に失敗しました）

**原因:** 会社のログ保管領域と変更の登録を作成または削除する際に、サーバーエラーが発生しました。
**対処:** もう一度試します。失敗が続く場合は、ログテーブルまたはその登録が食い違っている可能性があります。もう一度切り替えると再同期されます。

### "Failed to generate download URL"（ダウンロード URL を生成できませんでした）

**原因:** アーカイブの保存ファイルがないか、署名リクエストが失敗したため、Alforse が署名付きリンクを作成できませんでした。
**対処:** もう一度試します。リンクはすぐに期限切れになるため、古いリンクは使えません。

### レコードに履歴が表示されない

次の 3 点を確認してください。変更が行われた時にログ記録がオンであったこと（Alforse はさかのぼって補完しません）。レコードのエンティティが[監査対象のエンティティ](#audited-entities)に含まれていること。そして、管理用フィールド（`updatedAt`、`updatedBy`、埋め込み）だけを変更した場合は、フィールド単位の差分が表示されないこと。

### 古い変更がテーブルにない

ライブのログに保持されるのは直近 30 日間だけです。それより古い変更は、**アーカイブ済ログ**のダウンロード可能なエクスポートで探してください。

## 関連

**会社設定**

会社レコードと機能トグル（監査ログを含む）です。

[Open](https://docs.alforse.com/ja/docs/reference/company-settings.md)

**権限とアクセス**

設定の権限が、誰がログを閲覧・管理できるかを決めるしくみです。

[Open](https://docs.alforse.com/ja/docs/reference/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.