--- articleId: 788f0c03-6bb6-49f6-ba09-016191b4a474 slug: about-audit-log title: 監査ログ機能 parentCategoryId: ff1902b8-011f-4004-a396-dd745552ff47 languageCode: ja --- 監査ログ機能についてのDocsです。 ## 概要 監査ログとは、「誰が」「いつ」「どのような」行動をシステム上で行ったかを記録した、ログデータです。 主にシステム監査を行う際に利用されます。 TROCCOの監査ログ機能は、TROCCOユーザーの行動を記録し、記録した監査ログをCSVファイルで提供します。 :::(Warning) (プラン上の制約) 監査ログは、**Advanced**プラン以上の契約アカウントでのみ、ご利用いただけます。 ::: ## 注意事項 :::(Warning) (監査ログの保存期間、および監査ログ取得開始日) - 監査ログ機能では、**過去1年間**の監査ログを確認できます。 - 過去1年よりも前に記録された監査ログのデータは、順次削除されるため、確認できません。 - 監査ログ機能は、監査ログ機能をご契約された日から、監査ログの記録を開始します。 - 監査ログ機能をご契約されていない間に行われたユーザーの監査ログは、記録されていないため、確認できません。 ::: ## 監査ログファイルの仕様 監査ログはCSVファイルでダウンロードできます。 以下は、ダウンロードされるCSVファイルの仕様です。 ### CSVファイルのカラム一覧 監査ログのCSVファイルは、以下のカラムで構成されます。 | カラム名 | 値の説明 | | --- | --- | | `User ID` | アクションを行ったユーザーのIDです。
**ユーザーごとに一意な値であることが保証されます。**
ユーザーがTROCCOに招待されたときに自動で設定され、以降その値が変更されることはありません。 | | `Email` | アクションを行ったユーザーのメールアドレスです。
**メールアドレスは変更される可能性があります。** | | `IP Address` | アクションを行ったユーザーのIPアドレスです。 | | `User Agent` | アクションを行ったユーザーの使用OSや使用ブラウザ、およびそのバージョンです。| | `Role` | アクションを行ったユーザーの、TROCCOアカウント上の権限です。以下のいずれかの値となります。
詳しくは[各ユーザー権限でできること](/docs/account-roles)を参照ください。 | | `Available Features` | アクションを行ったユーザーが利用できる、TROCCOの機能です。
該当ユーザーが利用できる機能に応じて、以下の値を含みます。
詳しくは、[機能について](/docs/user-settings#機能について)を参照ください。 | | `Restricted Features` | アクションを行ったユーザーが利用を禁止されている、TROCCOの機能です。
該当ユーザーが禁止されている機能に応じて、以下の値を含みます。
詳しくは、[機能について](/docs/user-settings#機能について)を参照ください。 | | `Category` | アクションの対象となったTROCCOの機能名です。
詳しくは、後述の[カテゴリー](/docs/about-audit-log#カテゴリー)を参照ください。 | | `Action` | アクションの概要です。
詳しくは、後述の[アクション](/docs/about-audit-log#アクション)を参照ください。 | | `Action Details` | アクションに関する補足事項です。 | | `Date and Time (TIMEZONE)` | ユーザーがアクションを行った日時です。
[監査ログファイルのダウンロード](/docs/about-audit-log#監査ログファイルのダウンロード)時に選択したタイムゾーンがカラム名に含まれます。
なお、タイムゾーンに`Asia/Tokyo`を選択した場合、UTCの`12:00:00`に行われたアクションは、`21:00:00`に変換されて出力されます。 | :::(Warning) (識別子) ユーザーを特定するための識別子としては、`User ID`を参照ください。 `Email`は、途中で変更されることがあるため、識別子として参照できません。 ::: ### カテゴリー カテゴリー(Category)では、アクションの対象となったTROCCOの機能名を値として持ちます。 カテゴリーに含まれる値は、以下のとおりです。 :::(Warning) (カテゴリー一覧に含まれない機能) 以下のカテゴリー一覧に含まれない機能に対するアクションのログは、取得されません。 ::: |カテゴリー名|内容| |:----|:----| |`ETLConfiguration`|転送設定| |`ETLJob`|転送ジョブ| |`ManagedETLConfiguration`|マネージド転送設定| |`CDCJobDefinition`|CDCデータ転送設定| |`DataMartDefinition`|データマート定義| |`DataMartJob`|データマートジョブ| |`DbtGitRepository`|dbt Gitリポジトリ| |`DbtJobConfiguration`|dbtジョブ設定| |`DbtJob`|dbtジョブ| |`Team`|チーム| |`ResourceGroup`|リソースグループ| |`ResourceGroupRole`|リソースグループに対するロール(権限設定)| |`WorkflowDefinition`|ワークフロー定義| |`WorkflowJob`|ワークフロージョブ| |`CustomConnector`|カスタムコネクタ| |`ConnectionConfiguration`|接続情報| |`Notification`|通知先| |`EnvironmentGroup`|環境グループ| |`Environment`|環境| |`EnvironmentAttachment`|環境への紐付け| |`SelfHostedRunnerCluster`|Self-Hosted RunnerのCluster| |`SelfHostedRunnerRegistrationToken`|Self-Hosted RunnerのRegistrationToken| |`Label`|ラベル| |`Account`|TROCCOアカウント
\* TROCCOアカウントに所属する全ユーザーに影響のあるアクションです。| |`TimeoutSetting`|タイムアウト設定| |`ProcessingTimeNotification`|処理時間通知| |`PaymentsProfile`|クレジットカード契約情報| |`PaymentsSubscription`|クレジットカード契約| |`User`|TROCCOユーザー
\* TROCCOの各ユーザー自身にのみ影響のあるアクションです。| |`APIKey`|TROCCO API| |`AuditLog`|監査ログ| |`Page`|TROCCOへのアクセス
\* TROCCO上のページにアクセスするごとに、ログを取得します。| ### アクション アクション(Action)では、アクション名を値として持ちます。 各アクションは、プレフィックスとしてカテゴリ名を含みます。 アクションの一覧およびその詳細は、以下のcsvファイルを参照ください。 @(Embed)(https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/audit_log_action_list.csv) ## 監査ログの利用手順 ### 初期設定 監査ログを利用するためには、事前にユーザーの権限を設定する必要があります。 詳しくは、[ユーザーの権限設定](/docs/user-settings)を参照ください。 ## 監査ログファイルのダウンロード 1. 左サイドバーの**監査ログ出力**をクリック 2. 取得対象期間およびタイムゾーンを選択し、**出力**をクリック ![005-p.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/about-audit-log-2024-08-29-1-54-0.png) ダウンロードの準備が開始されます。しばらくお待ちください。 3. **ダウンロード**をクリック ![006-p.png](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/about-audit-log-2024-08-29-1-54-1.png) ZIPファイルがダウンロードされます。 ZIPファイルには、月単位で区切られたCSVファイルが格納されています。 :::(Info) (監査ログのダウンロードに関する補足) - 監査ログは、**出力後24時間以内**にダウンロードしてください。 - 出力後24時間を経過すると、ダウンロードできなくなります。 - **自身が出力した監査ログ**のみ、ダウンロードできます。 - 他のユーザーが出力した監査ログは、ダウンロードできません。 - 出力履歴>出力日時の列にて表示される日時は、`Asia/Tokyo`(日本標準時)を基準に表示されます。 ::: ## 監査ログ機能の変更履歴 |変更日|変更概要|変更詳細| |-----|-----|-----| |2023/04/10|監査ログ機能のリリース|-| |2023/05/10|監査ログ出力時のタイムゾーンの指定が可能に|監査ログ出力時のタイムゾーンの指定が可能になりました。
詳しくは、[CSVファイルのカラム一覧](/docs/about-audit-log#csvファイルのカラム一覧)の`Date and Time (TIMEZONE)`行を参照ください。| |2023/05/10|[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|**2段階認証**から**2要素認証**への機能名変更に伴い、以下のアクションの説明の表現も合わせて変更しました。| |2023/09/06|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[タイムゾーン設定](/docs/time-zone)の追加に伴い、取得対象のアクションを追加しました。| |2023/09/14|`Role`列の値の変更・追加|TROCCOの権限名の変更および新権限の追加に伴い、`Role`列の値も合わせて変更・追加しました。
詳しくは、[CSVファイルのカラム一覧](/docs/about-audit-log#csvファイルのカラム一覧)の`Role`行を参照ください。| |2023/10/12|`Restricted Features`列の追加|[ユーザーの権限設定 > 禁止する機能](/docs/user-settings#禁止する機能)の追加に伴い、`Restricted Features`列を追加しました。
詳しくは、[CSVファイルのカラム一覧](/docs/about-audit-log#csvファイルのカラム一覧)の`Restricted Features`行を参照ください。| |2023/10/24|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[ユーザーの削除](/docs/user-deletion)機能の追加に伴い、取得対象のアクションを追加しました。| |2023/11/21|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|アカウント特権管理者による、[アカウント内の各ユーザーが設定した2要素認証の無効化](/docs/about-super-admin#アカウント内の各ユーザーが設定した2要素認証の無効化)機能の追加に伴い、取得対象のアクションを追加しました。| |2024/03/05|取得対象アクションの削除
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|取得対象のアクションを削除しました。| |2024/04/02|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[組織名](/docs/organization-name)の変更に対応したことに伴い、取得対象のアクションを追加しました。| |2024/05/20|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してデータマート定義を操作した際のアクションを追加しました。| |2024/09/25|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してデータマートジョブを実行した際のアクションを追加しました。| |2024/10/10|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してユーザーを操作した際のアクションを追加しました。| |2024/11/18|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してユーザーを操作した際のアクションを追加しました。| |2024/11/21|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[通知先として登録するメールアドレスを認証](/docs/trocco-tutorial-additional-settings#emailの場合)した際のアクションを追加しました。| |2024/12/16|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してユーザーを操作した際のアクションを追加しました。| |2025/01/09|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|ワークフロー定義一覧画面にて、選択したワークフロー定義に対する一括操作がサポートされました。
上記に伴い、取得対象のアクションを追加しました。| |2025/01/14|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してワークフロー定義を操作した際のアクションを追加しました。| |2025/01/27|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|転送設定一覧画面にて、選択した転送設定に対する一括削除がサポートされました。
上記に伴い、取得対象のアクションを追加しました。| |2025/01/27|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用して転送設定を操作した際のアクションを追加しました。| |2025/01/27|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してラベルを操作した際のアクションを追加しました。| |2025/01/27|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してリソースグループを操作した際のアクションを追加しました。| |2025/04/01|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用して通知先を操作した際のアクションを追加しました。| |2025/04/24|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[Self-Hosted Runner](/docs/self-hosted-runner)がリリースされました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/04/30|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[CDCデータ転送](cdc-job-definition)がサポートされました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/05/07|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|アカウント設定より、[タイムアウト設定](/docs/timeout-settings)がサポートされました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/05/26|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|データマート定義の通知設定にて、ジョブ実行通知の設定変更がサポートされました。
上記に伴い、取得対象のアクションを追加しました。| |2025/06/17|取得対象のカテゴリー・アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|クレジットカードによる支払いが一部サポートされました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/08/04|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|データマート定義の一括操作が可能になりました。
上記に伴い、取得対象のアクションを追加しました。| |2025/08/25|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|転送設定のリソースグループの一括操作が可能になりました。
上記に伴い、取得対象のアクションを追加しました。| |2025/09/08|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|データマート定義・ワークフロー定義のリソースグループの一括操作が可能になりました。
上記に伴い、取得対象のアクションを追加しました。| |2025/11/26|取得対象のカテゴリー・アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[環境管理機能](/docs/environment-management)の監査ログが取得可能になりました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/12/03|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|環境へのデプロイに関する監査ログが取得可能になりました。
上記に伴い、取得対象のアクションを追加しました。| |2025/12/15|取得対象のカテゴリー・アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|カスタムコネクタに関する監査ログが取得可能になりました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2025/03/04|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|転送設定・ワークフロー定義・データマート定義のスケジュールの有効化・無効化に関する監査ログが取得可能になりました。
上記に伴い、取得対象のアクションを追加しました。| |2026/04/21|取得対象のカテゴリー・アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[処理時間機能](/docs/processing-time)の処理時間通知に関する監査ログが取得可能になりました。
上記に伴い、取得対象のカテゴリーとアクションを追加しました。| |2026/05/25|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してdbt Gitリポジトリ設定を操作した際のアクションを追加しました。| |2026/06/11|取得対象アクションの追加
および[audit_log_action_list.csv](/docs/about-audit-log#アクション)の更新|[TROCCO API](/docs/trocco-api)を利用してdbtジョブ設定を操作した際のアクションを追加しました。| :::(Info) (2024/03/05 `ETLConfigurationUpdatedFromPastRevision`アクションの削除) `ETLConfigurationUpdatedFromPastRevision`は、転送設定のリビジョン詳細画面から**復元**がクリックされたときに取得される仕様となっていました。 一方、過去のリビジョンが実際に復元されるのは、**復元**がクリックされた後に表示される転送設定編集画面にて、**保存して適用**されたタイミングとなります。 上記の通り、`ETLConfigurationUpdatedFromPastRevision`が取得されるタイミングと、過去のリビジョンが実際に復元されるタイミングが異なっていることから、本アクションを削除することとしました。 :::