監査ログ

利用できるユーザー： 会社の管理者
対象プラン： Enterprise プラン
対応プラットフォーム： ブラウザー

監査ログにより、関連する権限を持つ組織の管理者は、Miro 組織内のユーザーのアクティビティーを追跡することができます。ログは、問題を調査したり、重要なイベント（例えば、グローバル セキュリティー設定の変更、新規ユーザーの招待、新規ボードの作成など）の詳細なレポートを取得する際に非常に便利です。

✏️ 現在、イベントは Enterprise サブスクリプションの作成時点から記録され、デフォルトで 180 日間保存されます:
a) 別プランから Enterprise サブスクリプションにアップグレードした場合、イベントはアップグレードした時点から記録されます.
b) チームを Enterprise サブスクリプションに移行した場合、そのデータはチームがサブスクリプションの一部になったときにのみ記録されます.

監査ログへのアクセス

監査ログへアクセスするには、以下を実行してください：

1. 会社の設定に移動します。
2. 左側のパネルで、セキュリティ > 監査ログをクリックします。
3. 監査ログは、日付範囲、1 つ以上の実行者（アプリやユーザーに代わって動作する AI エージェントを含む）、1 つ以上のイベントカテゴリ、1 つ以上の特定のイベント、および 1 つ以上の対象オブジェクトを選択して絞り込めます。

[イベントを表示] ボタンをクリックして、絞り込み条件に一致するイベントをプレビューします。時刻は ISO 8601 形式、現地時間で表示されます。特定のイベントの詳細は、詳細欄の三点リーダーをクリックすると確認できます。

✏️ 組織の監査ログ保持期間（最大 365 日）までさかのぼってイベントをプレビューできます。

監査ログのエクスポート

CSV ファイル形式でログをエクスポートできます。

CSV Export ファイルでは、イベントの日付と時刻は ISO 8601 形式、UTC タイムゾーンで提供されます。一度にエクスポートするレコード数に制限はありませんが、エクスポートするデータが多いほど、ファイルの準備に時間がかかります。また、テーブル操作に使われる一般的なアプリケーションには開けるデータ量の制限がある点にもご注意ください。エクスポートされたファイルには、対象オブジェクトを含め、適用したフィルターが反映されます。

ログをエクスポートするには、CSV にエクスポートするボタンをクリックします。

エクスポートファイルの詳細を示すバーが下に表示されます。ファイルの準備ができたら、「CSV をダウンロード」ボタンをクリックしてダウンロードできます。ファイルは 24 時間ダウンロード可能です。

✏️ 現在、一度にダウンロードできるエクスポートファイルは、組織につき 1 件のみです。CSV にエクスポート ボタンをクリックすると、現在のエクスポートファイルが置き換わります。

API は UI と同じフィルターに対応しており、監査ログに API でアクセスできます

管理者は、監査ログ API またはサポートされている SIEM インテグレーション を使用して、監査ログデータにプログラム的にアクセスし、収集できます。

API は UI と同じフィルター（アクター、イベントカテゴリ、イベント、影響を受けたオブジェクト）に対応しており、それぞれ複数の値を指定できます。API を通じて、組織の監査ログの全履歴を取得できます。

Audit Logs API v1 の廃止

Audit Logs API v1 は廃止されました。v1 (GET /v1/audit/logs) をベースにしたカスタム インテグレーションがある場合は、v2 (GET /v2/audit/logs) に移行してください。認証と時間範囲のパラメーターは変更ありませんが、ページネーション、レスポンス形式、および一部のフィールド名が異なります。詳細は API リファレンスを参照してください。Miro 提供のアプリやマーケットプレイスのコネクタ（例: Splunk 向け Miro アプリや Microsoft Sentinel）を使用している場合は、v2 を既にサポートしている最新版にアップデートしてください。

v2 のレスポンスの主な変更点：

• ページネーションはオフセットベースではなくカーソルベース（不透明なカーソル値）で、総レコード数は返されません。
• createdBy.id は文字列で返されます（以前は数値でした）。
• 各イベントにはトップレベルの category フィールドが含まれます。
• イベント ID は UUID 文字列です（以前は数値のサフィックスでした）。不透明な値として取り扱ってください。
• createdAt はアクションが発生した正確な時刻ではなく、イベントが保存された時刻を示します（通常は数秒の遅延があります）。
• details フィールドは camelCase を使用します（例: organizationId）。大きな数値は文字列としてシリアライズされ、タイムスタンプは ISO 8601 を使用し、null 値のキーは省略されます。
• アプリ、インテグレーション、または AI エージェントがユーザーに代わって実行した操作については、actor オブジェクトにそのユーザーを識別する onBehalfOf フィールドが含まれます。
• サインアウトしたビジターのアクター名は現在 "Visitor"（以前は "Guest"）です。
• ボード関連のイベントは内部の数値 ID の代わりに、ボードの公開boardKeyを参照します。
• 「project」を参照していたイベントタイプとカテゴリは、現在「space」を使用します（例：project_created は現在 space_created）。この変更は v2 を通じて取得される過去のイベントにも遡及して適用されます。

監査ログの削除

管理者は監査ログの保持ポリシーを設定できます。30 日、90 日、180 日、365 日から選択可能です。

⚠️ 監査ログは一度削除されると、復元できなくなります。

✏️ 監査ログの無期限保存は廃止されました。

削除期間を設定する方法は以下のとおりです。

1. 会社の設定 に移動します。
2. 左側のパネルで、セキュリティ > 監査ログ をクリックします。
3. 監査ログの下で、設定タブをクリックします。
4. ドロップダウンリストからオプションを選択します。選択を確定するよう求められます。

監査ログに記録されるイベント

監査ログには、以下のカテゴリーのイベントに関する記録が含まれます：

よくある質問