# ログと監査

**何がどの記録に残り、どこから取り出せるか**を扱います。取り出す先は、管理コンソールの画面・CSV・SIEM・システム連携 API の 4 つです。

## 記録と取り出す先

名前は画面の表示に合わせています。SIEM の列のかっこは、SIEM 連携設定で使う識別子です。

| 記録                   | 何の記録か                                                           | 管理コンソールの画面                                          | CSV                                     | SIEM                                                                            | システム連携 API                                                                                        |
| -------------------- | --------------------------------------------------------------- | --------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **監査ログ**             | 管理コンソールで行われた操作                                                  | 「記録と監査」＞「操作の記録」＞「監査ログ」のタブ                           | 上限なし                                    | 監査ログ（`audit_logs`）                                                              | `/v1/admin/audit-logs`                                                                            |
| **操作監査ログ**           | Agent のツールの呼び出し・実行ルールでの許可/拒否・承認など、利用者・Agent・システムが実行したこと。本文は残らない | 「記録と監査」＞「操作の記録」＞「操作監査ログ」のタブ                         | —                                       | 操作監査ログ（`agent_action_audit`）                                                    | `/v1/admin/action-audit-logs`                                                                     |
| **利用者の操作の監査**        | 利用者がチャット画面で行った操作。本文は記録せず、IP アドレスと UA は伏せた値。見られるのはシステム管理者と監査役    | 「記録と監査」＞「操作の記録」＞「利用者の操作の監査」のタブ                      | 5,000 件まで                               | 利用者の操作の監査（`user_action_audit`）。**既定では送らない**                                     | `/v1/admin/user-action-logs`                                                                      |
| **AIエージェントの LLM 利用** | Agent が AI に考えさせた中身（依頼の受け取り方・ガードレールの判定・結果の要約）。個人情報は伏せて残る        | 「記録と監査」＞「AIエージェントの LLM 利用」                          | 1,000 件まで                               | —                                                                               | `/v1/admin/llm-logs`                                                                              |
| **ガードレールアラート**       | ガードレールが検知した事象。本文は残らず、利用者を特定する情報は画面にも API にも出ない                  | 「記録と監査」＞「ガードレールアラート」                                | —                                       | ガードレールアラート（`guardrail_alerts`）                                                  | `/v1/admin/guardrail-alerts`                                                                      |
| **利用者の評価**           | 利用者が AI の回答から「問題を報告」で送った報告。理由（6 種類）・利用者・会話・メッセージが残る             | 「記録と監査」＞「利用者の評価」                                    | 上限なし                                    | —                                                                               | —                                                                                                 |
| **外部への通信の記録**        | 外への通信を許可・遮断した記録                                                 | 「記録と監査」＞「外部への通信の記録」                                 | 5,000 件まで                               | 外部への通信の記録（`egress_access`）。**既定では送らない**                                         | `/v1/admin/access-logs`                                                                           |
| **認証イベント**           | ログインなどの認証の出来事                                                   | —                                                   | —                                       | 認証イベント（`event_entity`）                                                          | —                                                                                                 |
| **外部からの接続の記録**       | テナントへの接続の記録                                                     | —                                                   | —                                       | 外部からの接続の記録（`ingress_access`）                                                    | —                                                                                                 |
| **LLM Gateway の記録**  | LLM Gateway の呼び出しと、LLM Gateway 経由で実行された操作                       | 「LLM Gateway 管理」＞「LLM Gatewayログ」・「LLM Gateway 操作監査」 | 1,000 件まで                               | LLM Gatewayログ（`llm_gateway_audit`）・LLM Gateway 操作監査（`llm_gateway_action_audit`） | `/v1/admin/llm-gateway-logs`（LLM Gatewayログ）・`/v1/admin/llm-gateway-action-logs`（LLM Gateway 操作監査） |
| **会話の書き出し**          | 会話の本文・添付の一覧・メタ情報（プロジェクトの実行の会話は含まない）                             | 「記録の保持と送り先」＞「会話の書き出しと保全」＞「会話の書き出し」のタブ               | JSON で 1 回 1,000 件まで。期間を指定しないときは直近 30 日 | —                                                                               | —                                                                                                 |

システム連携 API の使い方は[システム連携 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/admin-api-reference.md#admin-logs)にあります。

## 監査ログの中身

**監査ログには、管理コンソールで行われた操作が 1 件ずつ残ります。** 1 件に残るものは次のとおりです。

| 項目            | 中身                                |
| ------------- | --------------------------------- |
| **実行日時**      | 操作した日時                            |
| **実行した人**     | ユーザー名・メールアドレス・ユーザー ID             |
| **クライアントの情報** | IP アドレス・ユーザーエージェント                |
| **対象**        | リソース（画面の対象の種類）・リソース ID・対象のメールアドレス |
| **アクション**     | 何をしたか（下の表）                        |
| **変わった項目**    | 変える前と後の値                          |

主なアクションは次のとおりです。

| まとまり  | アクション                                                                                                   |
| ----- | ------------------------------------------------------------------------------------------------------- |
| 登録と変更 | 登録・更新・削除・有効化・無効化・インポート・エクスポート                                                                           |
| 利用者   | 承認・承認の取り消し・利用の停止・利用の再開・ロック解除・パスワードリセット                                                                  |
| 権限    | 管理者権限の追加・管理者権限の削除                                                                                       |
| そのほか  | 持ち主の変更・シークレット再生成・ライセンス有効化・ライセンス更新・名簿の停止・名簿の再開・名簿への一括の登録・記録の担当の指名・記録の担当の解除・パスキーの削除・MCP の接続の削除・MCP の道具の警告 |

**「全件エクスポート」は、画面の並び替えと絞り込みを使わず、すべての監査ログを新しい順に CSV にします。** 作った CSV は、画面に出る期限まで取り直せます。

## 知りたいことから、記録を選ぶ

| 知りたいこと                   | 見る記録                    |
| ------------------------ | ----------------------- |
| 管理の設定を、誰がいつ変えたか          | 監査ログ                    |
| 外への通信が止められたか、どこへ出たか      | 外部への通信の記録               |
| AI に渡す内容が止められたか          | ガードレールアラート（誰の依頼かは分からない） |
| AI の回答に、利用者が問題があると言ってきたか | 利用者の評価                  |
| 利用者がチャット画面でどんな操作をしたか     | 利用者の操作の監査（本文は分からない）     |
| Agent が何を操作したか           | 操作監査ログ                  |
| 誰がいつログインしたか・失敗したか        | 認証イベント（SIEM に送って見る）     |

## SIEM に送る

**「記録の保持と送り先」＞「SIEM 連携設定」で、送り先と、送る記録を決めます。**

### 送り先

**「送信方式」で送り先を選び、送り先ごとの項目を入れます。**

| 送信方式                    | 受け口                                          |
| ----------------------- | -------------------------------------------- |
| **HTTP push（汎用）**       | 受信側が用意した取り込み用の URL                           |
| **Microsoft Sentinel**  | Azure Monitor の Logs Ingestion API（データ収集ルール） |
| **Splunk**              | HTTP Event Collector（HEC）                    |
| **AWS CloudWatch Logs** | ロググループ                                       |

**HTTP push（汎用）**

| 項目              | 中身                                                            |
| --------------- | ------------------------------------------------------------- |
| **送信先 URL**     | 受信側が用意した取り込み用の URL                                            |
| **認証トークン**      | 送信先が認証を求めるときに入れます                                             |
| **トークンのヘッダ名**   | 空なら `Authorization` を使います                                     |
| **ヘッダ値の形式**     | `{token}` がトークンに置き換わります（例: `Bearer {token}`）。空ならトークンをそのまま入れます |
| **HMAC シークレット** | 受信側が署名を確かめるときだけ入れます                                           |

**Microsoft Sentinel**

| 項目                                 | 中身                                                                                |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| **エンドポイント**                        | データ収集ルール（DCR）の logsIngestion のエンドポイント                                             |
| **DCR ID**                         | Azure ポータルの、データ収集ルールの概要で確かめられます                                                   |
| **ストリーム名**                         | データ収集ルールで宣言したストリーム名と同じにします                                                        |
| **テナント ID・クライアント ID・クライアントシークレット** | 送信に使う Microsoft Entra ID のアプリケーションのものです。そのアプリケーションには「監視メトリック発行者」ロールが要ります          |
| **Azure クラウド**                     | Azure パブリック／Azure China (21Vianet)／Azure US Government。中国と米国政府向けのクラウドでは、認証先が変わります |

**Splunk**

| 項目           | 中身                                          |
| ------------ | ------------------------------------------- |
| **送信先 URL**  | HTTP Event Collector（HEC）の収集用の URL          |
| **HEC トークン** | HEC のトークン                                   |
| **インデックス**   | 空なら、トークンに割り当てた既定のインデックスに入ります                |
| **ソースタイプ**   | Splunk の側での分類に使われます。検索のときの sourcetype になります |

**AWS CloudWatch Logs**

| 項目                         | 中身                                                 |
| -------------------------- | -------------------------------------------------- |
| **リージョン**                  | ロググループがあるリージョン                                     |
| **ロググループ**                 | 送り先のロググループの名前。無いと送れません                             |
| **ログストリーム**                | 空なら、記録の種類の識別子（`audit_logs` など）がそのままログストリームの名前になります |
| **アクセスキー ID・シークレットアクセスキー** | 送信に使う AWS の認証情報                                    |
| **ロググループとログストリームを自動作成する**  | 通常は無効のままにします。有効にすると、送り先の入力の誤りに気づけなくなります            |

**入れるときの決まり**

- **外部の送り先には `https` を使ってください。** 外部の送り先が `http` だと送りません（監査ログとトークンが暗号化されずに流れるため）
- **シークレットやトークンは、保存した後は表示されません。** 空のまま保存すると、今の値のままです。消すときは、画面の削除の操作をしてから保存します
- 「SIEM 連携」を無効にしても、設定は残ります
- ほかの管理者が先に保存していたときは、その旨が出ます。入れた値を控えてから、最新の設定を読み込み直して、もう一度保存します

### 送る記録

**記録の種類ごとに、送るか送らないかを選びます。** 上の表の SIEM の列の 9 種類です。

- **「利用者の操作の監査」と「外部への通信の記録」は、既定では送りません。** 送るときは、選んで有効にしてください
- **SIEM 連携を始めたとき、それより前の記録を、さかのぼって全部は送りません。** 過去の記録が要るときは、画面の CSV の書き出しやシステム連携 API で取り出します
- 「**送信状況**」で、記録の種類ごとに、最後に送った時刻・直近の件数・累計・直近のエラーを確かめられます

### 送る形と間隔

**1 分ごとに、前の回から増えた記録を送ります。** 記録ができてから届くまでは、おおむね 1〜2 分です。1 回に送るのは記録の種類ごとに 500 件まで（外部からの接続の記録は 2,500 件まで）で、超えた分は次の回に送ります。

**1 件ずつの記録は、ECS（Elastic Common Schema）の形の JSON です。** 時刻は `@timestamp`、操作は `event.action`・`event.outcome`、誰かは `user.id`・`user.email`、接続元は `source.ip` などに入ります。

| 送信先                     | 本文の形                                                                                                                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **HTTP push（汎用）**       | `{"schema_version":"v1","source":"<記録の種類>","rows":[記録…]}` を gzip で圧縮して送ります（`Content-Encoding: gzip`）。HMAC の秘密を設定すると、`X-Timestamp` と `X-Signature`（「`X-Timestamp` の値」と「`.`」と「圧縮後の本文」をつないだものの HMAC-SHA256。16 進）を付けます                                                                   |
| **Microsoft Sentinel**  | 行の JSON 配列です。列は `TimeGenerated`・`SourceName`・`EventId`・`EventKind`・`EventCategory`・`EventType`・`EventAction`・`EventOutcome`・`EventModule`・`EventProvider`・`EventReason`・`UserId`・`UserEmail`・`UserName`・`SourceIp`・`UserAgent`・`Document`（記録そのもの）です。**データ収集ルールのストリームに、この列を宣言してください** |
| **Splunk**              | 1 件ずつ `{"event": 記録, "time": 発生時刻, "sourcetype": …}` にして、改行でつないで送ります。「インデックス」を設定すると `index` も付けます                                                                                                                                                                                    |
| **AWS CloudWatch Logs** | 1 件の記録の JSON を、1 つのログイベントにします。ログイベントの時刻は、記録の発生時刻です                                                                                                                                                                                                                                   |

## 保持

**監査ログ・操作監査ログ・AIエージェントの LLM 利用・外部への通信の記録・LLM Gateway の記録は、24 か月残ります。** それより長く残したいときは、SIEM に送ってお客様の側で残してください。

## 会話の保管と共有

**会話がどこまで外に出るかは「接続先と使える範囲」＞「機能の許可」で、いつ消えるかは「記録の保持と送り先」＞「会話の書き出しと保全」＞「会話の保持と保全」のタブで決めます。**

### 共有リンク

**共有リンクは、機能の許可の画面の 2 か所で止められます。**

| 設定                       | 止まるもの                                                      |
| ------------------------ | ---------------------------------------------------------- |
| **「共有リンク」の「共有リンクを停止する」** | テナントのすべての共有リンク。**作った共有リンクも開けなくなります**。一覧の表示と削除はできます。既定はオフです |
| **機能の「共有」**              | 共有リンクを作る・直すことだけ。「無効」か「指定した組織・職種」で、使える人を絞ります                |

- 保存してから 60 秒以内に効きます
- 共有リンクを構築の設定で無効にしているテナントでは、この画面から使えるようにはできません。画面にその旨が出ます

### アーカイブと保持

| 項目              | 中身                                                             |
| --------------- | -------------------------------------------------------------- |
| **アーカイブまでの日数**  | 古い会話をアーカイブに移すまでの日数。30〜3650 日。空にすると既定（構築の設定）の日数です               |
| **アーカイブ後の保持日数** | アーカイブした会話を残す日数。30〜3650 日。空にすると無期限です。**過ぎた会話は、添付の実体ごと消え、戻せません** |

- 日数の変更は、次のアーカイブの実行から効きます
- 画面の「現在適用されている値」で、アーカイブまでの日数を確かめられます

### 保全（legal hold）

**消されては困る会話とプロジェクトには、「保全（legal hold）」を付けます。** 対象（会話かプロジェクト）を選び、ID を入れて「保全を設定」を押します。ID は、プロジェクトは UUID、会話は 128 文字までです。

- 保全中の会話・プロジェクトは、本人の削除・利用者の削除・アーカイブ・保持の満了で消えません
- アーカイブに移った会話に付けると、その会話は利用者の会話の一覧に戻ります
- 付け外しは押したときに効き、監査ログに残ります
