監査ログのしくみ
ログ記録は既定でオフで、会社ごとに別々に保持されます。オンにすると、Alforse は監査対象のエンティティに対するそれ以降のすべての変更を記録します。有効にする前やオフの間に行われた変更は、記録されません。 エントリは、変更されたデータベースの行ではなく、人が扱う業務エンティティごとにまとめられます。たとえばアイテムの原価を編集すると、基になるitemCost 行ではなくアイテムのエントリが作成されます。
エントリの内容
差分では
updatedAt、updatedBy、内部の埋め込みなどの管理用フィールドは除外されるため、エントリには人が気にする変更だけが表示されます。
監査対象のエンティティ
監査されるのは、以下のエンティティだけです。それ以外の変更は、ログ記録がオンかどうかにかかわらず記録されません。ログ記録のオンとオフ
設定 → 監査ログの監査ログカードには、トグルが 1 つあります。 トグルをオフにすると新しいエントリは記録されなくなりますが、既存の履歴は残ります。再びオンにするとその時点から記録が再開され、オフだった間の空白は空のままです。変更の確認
同じデータを、2 つの範囲で利用できます。1 つのレコードの履歴
得意先、受注、ジョブ、出荷など多くの詳細ページで、履歴アクションを選ぶと、そのレコードのタイムラインがドロワーで開きます。各変更には、操作、実行者、時刻、変更されたフィールドの展開可能な一覧が表示されます。 ログ記録がオフの場合、ドロワーには “Audit logging is not enabled”（監査ログは有効ではありません）と表示されます。設定を更新できるユーザーには有効にするためのショートカットが表示され、それ以外のユーザーには管理者に連絡するよう案内されます。会社全体のログ
設定 → 監査ログですべて表示を選択すると、全画面のすべての監査ログテーブルが開きます。検索とページ分割ができ、列はエンティティ、操作、変更者、変更、いつです。
操作は色付きのバッジで表示されます。作成は緑、更新は青、削除は赤です。行を展開するとフィールド単位の差分が表示され、エンティティの値を選択すると、それが指すレコードが開きます。
保持期間とアーカイブ
ライブのログには 30 日分のエントリが保持されます。毎晩、ジョブがそれより古いエントリを圧縮アーカイブに移し、アーカイブの日付範囲、行数、サイズを記録して、ライブのテーブルからそれらのエントリを削除します。 アーカイブは、設定ページのアーカイブ済ログに一覧表示されます。ダウンロードは、圧縮エクスポートへの有効期間の短い署名付きリンクを作成します。リンクは保存せず、毎回新しいものを要求してください。最初のアーカイブができるまでは、30 日より古いログがそこにアーカイブされることがカードで説明されます。権限とプラン
設定モジュールが従業員タイプにどう対応するかは、権限とアクセスを参照してください。
トラブルシューティング
”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 はさかのぼって補完しません）。レコードのエンティティが監査対象のエンティティに含まれていること。そして、管理用フィールド（updatedAt、updatedBy、埋め込み）だけを変更した場合は、フィールド単位の差分が表示されないこと。