> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/org/activity-log.md).

# アクティビティログ

組織内で誰がいつどのデータを追加、更新、削除したかや、メンバーのログイン記録を確認し、監査用に Excel へエクスポートして保存できます。

<mark style="color:blue;">アクティビティログ</mark>には、組織内のデータの追加、更新、削除、およびメンバーのログインがすべて記録されます。各記録には、操作日時、操作したメンバー、送信元 IP アドレス、変更内容が含まれます。組織管理者は「誰がいつこの AI アシスタントの設定を変更したか」を調べられます。情報セキュリティの監査担当者は、期間を指定して Excel にエクスポートし、監査用に保存できます。

{% hint style="info" %}
ページ上部には「アクティビティログは定期同期を行い、データは 10 分ごとに更新されます」と表示されます。完了したばかりの操作が一覧やエクスポートファイルに表示されるまで、最大で約 10 分かかります。
{% endhint %}

## 利用できるユーザー <a href="#who-can-use" id="who-can-use"></a>

* <mark style="color:blue;">組織設定</mark>に<mark style="color:blue;">アクティビティログ</mark>を表示するには、ロールに<mark style="color:blue;">組織権限</mark>配下の<mark style="color:blue;">アクティビティログ権限</mark>が必要です。エクスポートと<mark style="color:blue;">エクスポート履歴</mark>にも同じ権限を使用します。
* 上位の<mark style="color:blue;">組織権限</mark>を持つロールには、<mark style="color:blue;">アクティビティログ権限</mark>も付与されます。
* 組織のオーナーは、デフォルトでこの権限を持っています。

権限の設定方法については、[ロールと権限の管理](/maiagent-user-guide/ja/org/roles/role-permission.md)をご覧ください。

## アクセス方法 <a href="#how-to-access" id="how-to-access"></a>

左側のメニューで<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">アクティビティログ</mark>をクリックします。

## 記録されるイベント <a href="#what-is-recorded" id="what-is-recorded"></a>

各記録には「操作タイプ」と「リソースタイプ」が表示されます。例えば、操作タイプが「更新」、リソースタイプが「AI アシスタント」の場合、メンバーが AI アシスタントの設定を変更したことを示します。

### 操作タイプ <a href="#operation-types" id="operation-types"></a>

| 操作タイプ                                 | 記録されるタイミング                                           |
| ------------------------------------- | ---------------------------------------------------- |
| <mark style="color:blue;">追加</mark>   | AI アシスタント、ナレッジベース、ロールなどのデータを作成したときです                 |
| <mark style="color:blue;">更新</mark>   | 既存データの内容や設定を変更したときです                                 |
| <mark style="color:blue;">削除</mark>   | データを削除したときです                                         |
| <mark style="color:blue;">ログイン</mark> | メンバーが管理画面にログインしてこの組織にアクセスしたとき、または管理画面でこの組織に切り替えたときです |

アクティビティログには、データを変更する操作とログインのみが記録されます。ページを開いたり、データを閲覧したりするだけでは記録されません。

### リソースタイプ <a href="#resource-types" id="resource-types"></a>

リソースタイプは、操作対象のデータの種類を示します。フィルターのドロップダウンには、この組織で実際に記録されたリソースタイプのみが表示されます。主な種類は次のとおりです。

| カテゴリ      | リソースタイプ                                                                              |
| --------- | ------------------------------------------------------------------------------------ |
| AI アシスタント | AI アシスタント、AI アシスタントツール、AI アシスタントコネクタ、AI アシスタントスキル、AI アシスタントナレッジベース                   |
| ナレッジベース   | ナレッジベース、ナレッジベースファイル、ナレッジベースファイルタグ、FAQ、FAQ タグ                                         |
| 会話と連絡先    | 会話プラットフォーム、連絡先、連絡先の会話プラットフォーム                                                        |
| 組織とメンバー   | 組織、メンバー、メンバーの休暇時間帯、ログイン記録                                                            |
| ロール       | ロール、ロールメンバー、ロール権限、ロールの AI アシスタント、ロールのナレッジベース、ロールの会話プラットフォーム、ロールのデータベース、ロールで利用可能な LLM |
| ツールとデータ   | ツール、コネクタ、スキル、SQL データベース、サービスアカウント                                                    |

## 記録の表示と絞り込み <a href="#view-and-filter" id="view-and-filter"></a>

一覧は新しい順に表示されます。各列の説明は次のとおりです。

| 列                                        | 説明                                                                                          |
| ---------------------------------------- | ------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">操作日時</mark>    | イベントの発生日時です。ブラウザのタイムゾーンで表示されます                                                              |
| <mark style="color:blue;">ユーザー</mark>    | 操作したメンバーの名前と Email です。対応するメンバーがいないシステムイベントでは空欄になります                                         |
| <mark style="color:blue;">リソースタイプ</mark> | 操作対象のデータの種類です                                                                               |
| <mark style="color:blue;">操作タイプ</mark>   | 追加、更新、削除、ログインが、それぞれ異なる色で表示されます                                                              |
| <mark style="color:blue;">詳細情報</mark>    | 「更新」イベントでは、変更内容が「フィールド: 新しい値」の形式で表示されます（最大 300 文字。カーソルを合わせると全文を確認できます）。その他のイベントでは「-」が表示されます |
| <mark style="color:blue;">IP アドレス</mark> | 操作の送信元 IP アドレスです                                                                            |

### フィルター条件 <a href="#filters" id="filters"></a>

一覧の上部には 4 つのフィルターがあります。いずれかの条件を変更すると、一覧がすぐに更新されます。

* <mark style="color:blue;">開始日</mark>／<mark style="color:blue;">終了日</mark>：開始日と終了日当日の記録も含まれます。
* <mark style="color:blue;">ユーザーを選択</mark>：組織メンバーの名前と Email が表示されます。キーワードを入力して検索できます。
* <mark style="color:blue;">リソースタイプを選択</mark>：「ロール」など、特定の種類のデータの変更のみを表示します。
* <mark style="color:blue;">操作タイプを選択</mark>：追加、更新、削除、ログインから選択します。

<mark style="color:blue;">フィルターをリセット</mark>をクリックすると、すべての条件を一度に解除できます。

### 個別イベントの詳細を確認する <a href="#event-detail" id="event-detail"></a>

一覧の右端にある<mark style="color:blue;">操作</mark>列の目のアイコンをクリックすると、<mark style="color:blue;">アクティビティログの詳細</mark>が開きます。

| セクション                                     | 内容                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">基本情報</mark>     | <mark style="color:blue;">操作日時</mark>、<mark style="color:blue;">操作タイプ</mark>（`UPDATE` などの英語のコードで表示）、<mark style="color:blue;">オブジェクトモデル</mark>、<mark style="color:blue;">オブジェクト ID</mark>が表示されます                                                                                                                                                                                                                                |
| <mark style="color:blue;">コンテキスト情報</mark> | <mark style="color:blue;">ユーザー</mark>、<mark style="color:blue;">組織</mark>、<mark style="color:blue;">IP アドレス</mark>、<mark style="color:blue;">リクエストメソッド</mark>、<mark style="color:blue;">API パス</mark>が表示されます。ログインイベントでは、<mark style="color:blue;">ユーザー</mark>、<mark style="color:blue;">組織</mark>、<mark style="color:blue;">IP アドレス</mark>、<mark style="color:blue;">ログイン方式</mark>（`maiagent`、`saml` など、アカウントの認証元を示すコード）が表示されます |
| <mark style="color:blue;">変更の詳細</mark>    | 「更新」イベントのみで表示されます。変更されたフィールド（フィールドコードで表示）と、その<mark style="color:blue;">変更前の値</mark>および<mark style="color:blue;">変更後の値</mark>が個別に表示されます                                                                                                                                                                                                                                                                                          |

## アクティビティログのエクスポート <a href="#export" id="export"></a>

エクスポートはバックグラウンドで処理されます。作成後は他のページで操作を続けられます。処理が完了したら、<mark style="color:blue;">エクスポート履歴</mark>から Excel ファイルをダウンロードできます。

{% stepper %}
{% step %}

### エクスポート範囲を設定する <a href="#export-step-filter" id="export-step-filter"></a>

エクスポートには、画面上の現在のフィルター条件（日付、ユーザー、リソースタイプ、操作タイプ）が適用されます。条件を設定していない場合は、すべての記録がエクスポートされます。
{% endstep %}

{% step %}

### エクスポートを作成する <a href="#export-step-create" id="export-step-create"></a>

右上の<mark style="color:blue;">エクスポート</mark>をクリックします（ボタンにカーソルを合わせると「1 回のエクスポート上限は 50,000 件です」と表示されます）。作成に成功すると、「エクスポートタスクを作成しました」と表示されます。
{% endstep %}

{% step %}

### ファイルをダウンロードする <a href="#export-step-download" id="export-step-download"></a>

<mark style="color:blue;">エクスポート履歴</mark>をクリックしてエクスポート一覧を開きます。<mark style="color:blue;">ステータス</mark>が<mark style="color:blue;">完了</mark>になったら、その行の<mark style="color:blue;">ダウンロード</mark>アイコンをクリックしてファイルを取得します。
{% endstep %}
{% endstepper %}

### エクスポートのステータス <a href="#export-status" id="export-status"></a>

<mark style="color:blue;">エクスポート履歴</mark>には、各エクスポートの<mark style="color:blue;">ステータス</mark>、<mark style="color:blue;">記録件数</mark>、<mark style="color:blue;">ファイルサイズ</mark>、<mark style="color:blue;">処理時間</mark>、<mark style="color:blue;">作成日時</mark>、<mark style="color:blue;">完了日時</mark>が表示されます。右上の更新アイコン（<mark style="color:blue;">更新</mark>）で一覧を更新できます。

| ステータス                                | 説明                                                                                                                   |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">待機中</mark> | エクスポートが作成され、処理を待っています                                                                                                |
| <mark style="color:blue;">処理中</mark> | ファイルを生成しています                                                                                                         |
| <mark style="color:blue;">完了</mark>  | ダウンロードできます                                                                                                           |
| <mark style="color:blue;">失敗</mark>  | 処理中にエラーが発生したか（まずシステムが自動で再試行します）、処理開始から 2 時間を超えても完了していません。<mark style="color:blue;">エラーの詳細を表示</mark>をクリックすると原因を確認できます |

<mark style="color:blue;">エクスポート履歴</mark>ページを開いているときに、自分が作成したエクスポートが完了すると、「エクスポートリクエストが完了しました。ファイルをダウンロードできます」と表示され、「エクスポート完了」のブラウザ通知が送信されます（ブラウザ通知の許可が必要です）。失敗した場合は、「エクスポートリクエストに失敗しました。エラーの詳細を確認してください」と表示されます。

{% hint style="warning" %} <mark style="color:blue;">エクスポート履歴</mark>には、自分が作成したものだけでなく、組織全体のアクティビティログのエクスポートが表示されます。<mark style="color:blue;">アクティビティログ権限</mark>を持つすべてのメンバーが閲覧、ダウンロードできます。エクスポートファイルには、メンバーの Email、IP アドレス、データの内容が含まれます。会社の情報セキュリティ規程に従って保管してください。
{% endhint %}

### エクスポートファイルの内容 <a href="#export-file" id="export-file"></a>

* 形式は Excel（`.xlsx`）で、ファイル名は `events_export_<組織 ID>_<日期時間>.xlsx` です。
* 1 行につき 1 件のイベントが、新しい順に並びます。条件に一致する記録が 50,000 件を超える場合は、最新の 50,000 件のみが含まれます。
* 列名は英語です。主な列は次のとおりです。

| 列                | 内容                                              |
| ---------------- | ----------------------------------------------- |
| `ID`             | イベント ID です                                      |
| `Timestamp`      | ISO 8601 形式の UTC のイベント日時です（末尾は `+00:00` です）     |
| `User`           | 操作したメンバーの Email です                              |
| `Resource Type`  | `chatbots.Chatbot` などのリソースタイプのシステムコードです         |
| `Object ID`      | 操作対象データの ID です                                  |
| `Operation`      | 操作タイプのコードです：`create`、`update`、`delete`、`login`  |
| `Diff Preview`   | イベント発生時点の該当データの全内容です（JSON 形式）。ログインイベントでは空欄になります |
| `Request Method` | `POST`、`PATCH` などのリクエストメソッドです                   |
| `Login Method`   | ログインイベントの認証元を示すコードです                            |
| `IP Address`     | 送信元 IP アドレスです                                   |

## データの保存 <a href="#data-retention" id="data-retention"></a>

アクティビティログは蓄積され続けます。管理画面にはアクティビティログを削除、編集する機能がなく、データベース層でも記録の削除がブロックされています。組織のオーナーも記録を削除できません。時間の経過による自動削除も行われません。特定の期間のデータを保存するには、日付で絞り込んでエクスポートしてください。

## よくある質問 <a href="#faq" id="faq"></a>

### 変更したばかりの設定がアクティビティログに表示されないのはなぜですか？ <a href="#faq-not-yet-shown" id="faq-not-yet-shown"></a>

アクティビティログは 10 分ごとに同期されます。しばらく待ってから更新してください。エクスポートファイルも同じデータを使用するため、完了したばかりの操作は同期後にエクスポートファイルへ反映されます。

### エクスポートしたい記録が 50,000 件を超える場合はどうすればよいですか？ <a href="#faq-over-export-limit" id="faq-over-export-limit"></a>

1 回のエクスポートは最大 50,000 件です。上限を超える場合は、最新の 50,000 件のみが含まれます。日付の範囲を狭め（例えば月ごとに）、分けてエクスポートしてください。

### エクスポートファイルの時刻が画面の表示と数時間ずれるのはなぜですか？ <a href="#faq-timezone" id="faq-timezone"></a>

エクスポートファイルの `Timestamp` は UTC ですが、画面ではブラウザのタイムゾーンで表示されます。例えば、台湾時間（UTC+8）の場合、エクスポートファイルの時刻に 8 時間を加えると画面の時刻になります。

### エクスポートが繰り返し失敗する場合はどうすればよいですか？ <a href="#faq-export-failed" id="faq-export-failed"></a>

<mark style="color:blue;">エクスポート履歴</mark>で<mark style="color:blue;">エラーの詳細を表示</mark>をクリックし、原因を確認してください。処理開始から 2 時間を超えても完了していないエクスポートは、<mark style="color:blue;">失敗</mark>と表示されます。その場合は日付の範囲を狭めて再度エクスポートしてください。それでも失敗が続く場合は、エラーの詳細をカスタマーサポートに提供して調査を依頼してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/org/activity-log.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.