目次 x
    監査ログ機能
      • 印刷
      • PDF
      目次

      監査ログ機能

        • 印刷
        • PDF
        記事の要約

        監査ログ機能についてのDocsです。

        概要

        監査ログとは、「誰が」「いつ」「どのような」行動をシステム上で行ったかを記録した、ログデータです。
        主にシステム監査を行う際に利用されます。
        TROCCOの監査ログ機能は、TROCCOユーザーの行動を記録し、記録した監査ログをCSVファイルで提供します。

        プラン上の制約

        監査ログは、Advancedプラン以上の契約アカウントでのみ、ご利用いただけます。

        注意事項

        監査ログの保存期間、および監査ログ取得開始日
        • 監査ログ機能では、過去1年間の監査ログを確認できます。
          • 過去1年よりも前に記録された監査ログのデータは、順次削除されるため、確認できません。
        • 監査ログ機能は、監査ログ機能をご契約された日から、監査ログの記録を開始します。
          • 監査ログ機能をご契約されていない間に行われたユーザーの監査ログは、記録されていないため、確認できません。

        監査ログファイルの仕様

        監査ログはCSVファイルでダウンロードできます。
        以下は、ダウンロードされるCSVファイルの仕様です。

        CSVファイルのカラム一覧

        監査ログのCSVファイルは、以下のカラムで構成されます。

        カラム名値の説明
        User IDアクションを行ったユーザーのIDです。
        ユーザーごとに一意な値であることが保証されます。
        ユーザーがTROCCOに招待されたときに自動で設定され、以降その値が変更されることはありません。
        Emailアクションを行ったユーザーのメールアドレスです。
        メールアドレスは変更される可能性があります。
        IP Addressアクションを行ったユーザーのIPアドレスです。
        User Agentアクションを行ったユーザーの使用OSや使用ブラウザ、およびそのバージョンです。
        Roleアクションを行ったユーザーの、TROCCOアカウント上の権限です。以下のいずれかの値となります。
        • Account Super Admin
        • Account Admin
        • Account Member

        詳しくは各ユーザー権限でできることを参照ください。
        Available Featuresアクションを行ったユーザーが利用できる、TROCCOの機能です。
        該当ユーザーが利用できる機能に応じて、以下の値を含みます。
        • Basic Features：TROCCOの基本機能
        • Data Catalog：データカタログ
        • Audit Log：監査ログ

        詳しくは、機能についてを参照ください。
        Restricted Featuresアクションを行ったユーザーが利用を禁止されている、TROCCOの機能です。
        該当ユーザーが禁止されている機能に応じて、以下の値を含みます。
        • Connection Modification：接続情報の作成・編集・削除

        詳しくは、機能についてを参照ください。
        Categoryアクションの対象となったTROCCOの機能名です。
        詳しくは、後述のカテゴリーを参照ください。
        Actionアクションの概要です。
        詳しくは、後述のアクションを参照ください。
        Action Detailsアクションに関する補足事項です。
        Date and Time (TIMEZONE)ユーザーがアクションを行った日時です。
        監査ログファイルのダウンロード時に選択したタイムゾーンがカラム名に含まれます。
        なお、タイムゾーンにAsia/Tokyoを選択した場合、UTCの12:00:00に行われたアクションは、21:00:00に変換されて出力されます。
        識別子

        ユーザーを特定するための識別子としては、User IDを参照ください。
        Emailは、途中で変更されることがあるため、識別子として参照できません。

        カテゴリー

        カテゴリー（Category）では、アクションの対象となったTROCCOの機能名を値として持ちます。
        カテゴリーに含まれる値は、以下のとおりです。

        カテゴリー一覧に含まれない機能

        以下のカテゴリー一覧に含まれない機能に対するアクションのログは、取得されません。

        カテゴリー名内容
        ETLConfiguration転送設定
        ETLJob転送ジョブ
        ManagedETLConfigurationマネージド転送設定
        CDCJobDefinitionCDCデータ転送設定
        DataMartDefinitionデータマート定義
        DataMartJobデータマートジョブ
        DbtGitRepositorydbt Gitリポジトリ
        DbtJobConfigurationdbtジョブ設定
        DbtJobdbtジョブ
        Teamチーム
        ResourceGroupリソースグループ
        ResourceGroupRoleリソースグループに対するロール（権限設定）
        WorkflowDefinitionワークフロー定義
        WorkflowJobワークフロージョブ
        ConnectionConfiguration接続情報
        Notification通知先
        SelfHostedRunnerClusterSelf-Hosted RunnerのCluster
        SelfHostedRunnerRegistrationTokenSelf-Hosted RunnerのRegistrationToken
        Labelラベル
        AccountTROCCOアカウント
        * TROCCOアカウントに所属する全ユーザーに影響のあるアクションです。
        TimeoutSettingタイムアウト設定
        PaymentsProfileクレジットカード契約情報
        PaymentsSubscriptionクレジットカード契約
        UserTROCCOユーザー
        * TROCCOの各ユーザー自身にのみ影響のあるアクションです。
        APIKeyTROCCO API
        AuditLog監査ログ
        PageTROCCOへのアクセス
        * TROCCO上のページにアクセスするごとに、ログを取得します。

        アクション

        アクション（Action）では、アクション名を値として持ちます。
        各アクションは、プレフィックスとしてカテゴリ名を含みます。
        アクションの一覧およびその詳細は、以下のcsvファイルを参照ください。

        audit_log_action_list.csv

        監査ログの利用手順

        初期設定

        監査ログを利用するためには、事前にユーザーの権限を設定する必要があります。
        詳しくは、ユーザーの権限設定を参照ください。

        監査ログファイルのダウンロード

        1. 左サイドバーの監査ログ出力をクリック

        2. 取得対象期間およびタイムゾーンを選択し、出力をクリック
          005-p.png
          ダウンロードの準備が開始されます。しばらくお待ちください。

        3. ダウンロードをクリック
          006-p.png
          ZIPファイルがダウンロードされます。
          ZIPファイルには、月単位で区切られたCSVファイルが格納されています。

        監査ログのダウンロードに関する補足
        • 監査ログは、出力後24時間以内にダウンロードしてください。
          • 出力後24時間を経過すると、ダウンロードできなくなります。
        • 自身が出力した監査ログのみ、ダウンロードできます。
          • 他のユーザーが出力した監査ログは、ダウンロードできません。
        • 出力履歴＞出力日時の列にて表示される日時は、Asia/Tokyo（日本標準時）を基準に表示されます。

        監査ログ機能の変更履歴

        変更日変更概要変更詳細
        2023/04/10監査ログ機能のリリース-
        2023/05/10監査ログ出力時のタイムゾーンの指定が可能に監査ログ出力時のタイムゾーンの指定が可能になりました。
        詳しくは、CSVファイルのカラム一覧のDate and Time (TIMEZONE)行を参照ください。
        2023/05/10audit_log_action_list.csvの更新2段階認証から2要素認証への機能名変更に伴い、以下のアクションの説明の表現も合わせて変更しました。
        • UserTwoFactorAuthenticationEnabled,2要素認証の有効化
        • UserTwoFactorAuthenticationDisabled,2要素認証の無効化
        2023/09/06取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		タイムゾーン設定の追加に伴い、取得対象のアクションを追加しました。
        • UserUpdatedForTimeZone,ユーザーの更新（タイムゾーン設定を変更）
        2023/09/14Role列の値の変更・追加TROCCOの権限名の変更および新権限の追加に伴い、Role列の値も合わせて変更・追加しました。
        • Account Super Admin：新権限であるアカウント特権管理者の追加に伴い、値を追加
        • Account Admin：旧adminから変更
        • Account Member：旧memberから変更

        詳しくは、CSVファイルのカラム一覧のRole行を参照ください。
        2023/10/12Restricted Features列の追加ユーザーの権限設定 > 禁止する機能の追加に伴い、Restricted Features列を追加しました。
        詳しくは、CSVファイルのカラム一覧のRestricted Features行を参照ください。
        2023/10/24取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		ユーザーの削除機能の追加に伴い、取得対象のアクションを追加しました。
        • UserDeleted,ユーザーの削除
        2023/11/21取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		アカウント特権管理者による、アカウント内の各ユーザーが設定した2要素認証の無効化機能の追加に伴い、取得対象のアクションを追加しました。
        • UserTwoFactorAuthDisabled,2要素認証の無効化（アカウント特権管理者による無効化）
        2024/03/05取得対象アクションの削除
        およびaudit_log_action_list.csvの更新        		取得対象のアクションを削除しました。
        • ETLConfigurationUpdatedFromPastRevision,転送設定の更新（変更履歴の過去のリビジョンを復元）
        2024/04/02取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		組織名の変更に対応したことに伴い、取得対象のアクションを追加しました。
        • AccountOrganizationNameUpdated,組織名の更新
        2024/05/20取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してデータマート定義を操作した際のアクションを追加しました。
        • DataMartDefinitionCreatedFromAPI,データマート定義の作成（APIを利用）
        • DataMartDefinitionUpdatedFromAPI,データマート定義の更新（APIを利用）
        • DataMartDefinitionDeletedFromAPI,データマート定義の削除（APIを利用）
        2024/09/25取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してデータマートジョブを実行した際のアクションを追加しました。
        • DataMartJobExecutedFromAPI,データマートジョブの実行（APIを利用）
        2024/10/10取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してユーザーを操作した際のアクションを追加しました。
        • AccountUserInvitedFromAPI,ユーザーの招待（APIを利用）
        • UserUpdatedFromAPI,ユーザーの更新（権限・機能を変更）（APIを利用）
        • UserDeletedFromAPI,ユーザーの削除（APIを利用）
        2024/11/18取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してユーザーを操作した際のアクションを追加しました。
        • ConnectionConfigurationCreatedFromAPI,接続情報の作成（APIを利用）
        • ConnectionConfigurationUpdatedFromAPI,接続情報の更新（APIを利用）
        • ConnectionConfigurationDeletedFromAPI,接続情報の削除（APIを利用）
        2024/11/21取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		通知先として登録するメールアドレスを認証した際のアクションを追加しました。
        • NotificationVerified,通知先の確認（確認メールに含まれるリンクをクリックし、メールアドレスの認証が成功）
        2024/12/16取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してユーザーを操作した際のアクションを追加しました。
        • TeamCreatedFromAPI,チームの作成（APIを利用）
        • TeamUpdatedFromAPI,チームの更新（APIを利用）
        • TeamDeletedFromAPI,チームの削除（APIを利用）
        2025/01/09取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		ワークフロー定義一覧画面にて、選択したワークフロー定義に対する一括操作がサポートされました。
        上記に伴い、取得対象のアクションを追加しました。
        • WorkflowDefinitionLabelsAddedInBulk,ワークフロー定義のラベルの一括追加（複数のワークフロー定義にラベルを一括追加）
        • WorkflowDefinitionLabelsRemovedInBulk,ワークフロー定義のラベルの一括削除（複数のワークフロー定義のラベルを一括削除）
        • WorkflowDefinitionSchedulesAddedInBulk,ワークフロー定義のスケジュールの一括追加（複数のワークフロー定義にスケジュールを一括追加）
        • WorkflowDefinitionSchedulesRemovedInBulk,ワークフロー定義のスケジュールの一括削除（複数のワークフロー定義のスケジュールを一括削除）
        2025/01/14取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してワークフロー定義を操作した際のアクションを追加しました。
        • WorkflowDefinitionCreatedFromAPI,ワークフロー定義の作成（APIを利用）
        • WorkflowDefinitionUpdatedFromAPI,ワークフロー定義の更新（APIを利用）
        • WorkflowDefinitionDeletedFromAPI,ワークフロー定義の削除（APIを利用）
        2025/01/27取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		転送設定一覧画面にて、選択した転送設定に対する一括削除がサポートされました。
        上記に伴い、取得対象のアクションを追加しました。
        • ETLConfigurationJobDefinitionsRemovedInBulk,転送設定の一括削除（複数の転送設定を一括削除）
        2025/01/27取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用して転送設定を操作した際のアクションを追加しました。
        • ETLConfigurationCreatedFromAPI,転送設定の作成（APIを利用）
        • ETLConfigurationUpdatedFromAPI,転送設定の更新（APIを利用）
        • ETLConfigurationDeletedFromAPI,転送設定の削除（APIを利用）
        2025/01/27取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してラベルを操作した際のアクションを追加しました。
        • LabelCreatedFromAPI,ラベルの作成（APIを利用）
        • LabelUpdatedFromAPI,ラベルの更新（APIを利用）
        • LabelDeletedFromAPI,ラベルの削除（APIを利用）
        2025/01/27取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用してリソースグループを操作した際のアクションを追加しました。
        • ResourceGroupCreatedFromAPI,リソースグループの作成（APIを利用）
        • ResourceGroupUpdatedFromAPI,リソースグループの更新（APIを利用）
        • ResourceGroupDeletedFromAPI,リソースグループの削除（APIを利用）
        • ResourceGroupRoleCreatedFromAPI,リソースグループの権限設定の作成（チームへロールを追加）（APIを利用）
        • ResourceGroupRoleUpdatedFromAPI,リソースグループの権限設定の更新（チームのロールを更新）（APIを利用）
        • ResourceGroupRoleDeletedFromAPI,リソースグループの権限設定の削除（チームからロールを削除）（APIを利用）
        2025/04/01取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		TROCCO APIを利用して通知先を操作した際のアクションを追加しました。
        • NotificationCreatedFromAPI,通知先の作成（APIを利用）
        • NotificationUpdatedFromAPI,通知先の更新（APIを利用）
        • NotificationDeletedFromAPI,通知先の削除（APIを利用）
        2025/04/24取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		Self-Hosted Runnerがリリースされました。
        上記に伴い、取得対象のカテゴリーとアクションを追加しました。
        • カテゴリー
          • SelfHostedRunnerCluster,Self-Hosted RunnerのCluster
          • SelfHostedRunnerRegistrationToken,Self-Hosted RunnerのRegistrationToken
        • アクション
          • SelfHostedRunnerClusterCreated,Self-Hosted RunnerのClusterの作成
          • SelfHostedRunnerClusterDeleted,Self-Hosted RunnerのClusterの削除
          • SelfHostedRunnerClusterUpdated,Self-Hosted RunnerのClusterの更新
          • SelfHostedRunnerRegistrationTokenCreated,Self-Hosted RunnerのRegistrationTokenの作成
          • SelfHostedRunnerRegistrationTokenDeleted,Self-Hosted RunnerのRegistrationTokenの削除
        2025/04/30取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		CDCデータ転送がサポートされました。
        上記に伴い、取得対象のカテゴリーとアクションを追加しました。
        • カテゴリー
          • CDCJobDefinition,CDCデータ転送設定
        • アクション
          • CDCJobDefinitionCreated,CDCデータ転送設定の作成
          • CDCJobDefinitionUpdated,CDCデータ転送設定の更新
          • CDCJobDefinitionDeleted,CDCデータ転送設定の削除
        2025/05/07取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		アカウント設定より、タイムアウト設定がサポートされました。
        上記に伴い、取得対象のカテゴリーとアクションを追加しました。
        • カテゴリー
          • TimeoutSetting,タイムアウト設定
        • アクション
          • TimeoutSettingUpdated,タイムアウト設定の更新
        2025/05/26取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		データマート定義の通知設定にて、ジョブ実行通知の設定変更がサポートされました。
        上記に伴い、取得対象のアクションを追加しました。
        • DataMartDefinitionNotificationForJobStatusChanged,データマート定義の通知設定（ジョブ実行通知）の変更
        2025/06/17取得対象のカテゴリー・アクションの追加
        およびaudit_log_action_list.csvの更新        		クレジットカードによる支払いが一部サポートされました。
        上記に伴い、取得対象のカテゴリーとアクションを追加しました。
        • カテゴリー
          • PaymentsProfile,クレジットカード契約情報
          • PaymentsSubscription,クレジットカード契約
        • アクション
          • PaymentsProfileUpdated,クレジットカード契約情報の更新
          • PaymentsSubscriptionCreated,クレジットカード契約の開始
        2025/08/04取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		データマート定義の一括操作が可能になりました。
        上記に伴い、取得対象のアクションを追加しました。
        • DataMartDefinitionLabelsAddedInBulk,データマート定義のラベルの一括追加
        • DataMartDefinitionLabelsRemovedInBulk,データマート定義のラベルの一括削除
        • DataMartDefinitionSchedulesAddedInBulk,データマート定義のスケジュールの一括追加
        • DataMartDefinitionSchedulesRemovedInBulk,データマート定義のスケジュールの一括削除
        • DataMartDefinitionDeletedInBulk,データマート定義の一括削除
        2025/08/25取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		転送設定のリソースグループの一括操作が可能になりました。
        上記に伴い、取得対象のアクションを追加しました。
        • ETLConfigurationResourceGroupsAddedInBulk,転送設定のリソースグループの一括追加（複数の転送設定にリソースグループを一括追加）
        • ETLConfigurationResourceGroupsRemovedInBulk,転送設定のリソースグループの一括削除（複数の転送設定のリソースグループを一括削除）
        2025/09/08取得対象アクションの追加
        およびaudit_log_action_list.csvの更新        		データマート定義・ワークフロー定義のリソースグループの一括操作が可能になりました。
        上記に伴い、取得対象のアクションを追加しました。
        • DataMartDefinitionResourceGroupsAddedInBulk,データマート定義のリソースグループの一括追加（複数のデータマート定義にリソースグループを一括追加）
        • DataMartDefinitionResourceGroupsRemovedInBulk,データマート定義のリソースグループの一括削除（複数のデータマート定義のリソースグループを一括削除）
        • WorkflowDefinitionResourceGroupsAddedInBulk,ワークフロー定義のリソースグループの一括追加（複数のワークフロー定義にリソースグループを一括追加）
        • WorkflowDefinitionResourceGroupsRemovedInBulk,ワークフロー定義のリソースグループの一括削除（複数のワークフロー定義のリソースグループを一括削除）
        2024/03/05 ETLConfigurationUpdatedFromPastRevisionアクションの削除

        ETLConfigurationUpdatedFromPastRevisionは、転送設定のリビジョン詳細画面から復元がクリックされたときに取得される仕様となっていました。
        一方、過去のリビジョンが実際に復元されるのは、復元がクリックされた後に表示される転送設定編集画面にて、保存して適用されたタイミングとなります。
        上記の通り、ETLConfigurationUpdatedFromPastRevisionが取得されるタイミングと、過去のリビジョンが実際に復元されるタイミングが異なっていることから、本アクションを削除することとしました。

        この記事は役に立ちましたか?
        What's Next