監査ログと Git イベント データのエクスポートについて
監査ログをエクスポートするには、GitHub Enterprise Cloud で Enterprise から JSON ファイルまたは CSV ファイルをダウンロードします。 監査ログ イベントをエクスポートするときに、サポートされている修飾子の 1 つ以上でクエリを実行して、エクスポートする特定のログ イベントをフィルター処理できます。 検索修飾子の詳細については、「実行されたアクションに基づく検索」を参照してください。
Enterprise 監査ログから JSON ファイルをダウンロードすると、Git イベント データをエクスポートできます。 監査ログ データとは異なり、監査ログ ユーザー インターフェイスでフィルター処理とエクスポートを行うために特定の Git イベントにクエリを実行することはできません。
注: Git イベントをエクスポートする場合、Web ブラウザー、REST API、または GraphQL API から開始されたイベントは含まれません。 たとえば、ユーザーが Web ブラウザーで pull request をマージすると、変更はベース ブランチにプッシュされますが、そのプッシュの Git イベントはエクスポートに含まれません。
エクスポートされたログの出力ファイルには、以下のキーと値があります。
Key | 値の例 |
---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | US |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (タイムスタンプは Epoch からの経過時間をミリ秒で示します。) |
data.email | octocat@nowhere.com |
data.hook_id | 245 |
data.events | ["issues", "issue_comment", "pull_request", "pull_request_review_comment"] |
data.events_were | ["push", "pull_request", "issues"] |
data.target_login | octocat |
data.old_user | hubot |
data.team | octo-org/engineering |
ログ イベントをエクスポートする代わりに、API を使用して監査ログ イベントを取得したり、イベントがログされる際に監査データをストリーム配信するように GitHub Enterprise Cloud を設定したりすることができます。 詳細については、「Enterprise の監査ログ API の使用」および「Enterprise の監査ログのストリーミング」を参照してください。
監査ログ データのエクスポート
-
GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。
-
Enterpriseのリストで、表示したいEnterpriseをクリックしてください。
-
Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [設定] で、 [監査ログ] をクリックします。
-
必要に応じて、フィルター処理された結果のみをエクスポートするには、1 つ以上のサポートされている修飾子またはログ フィルターで検索します。
-
[Export] ドロップダウン メニューを選択し、ログ イベントをエクスポートするファイル形式 (JSON または CSV) を選択します。
Git イベント データのエクスポート
日付範囲ごとに Git イベント データをエクスポートすることもできます。
-
GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。
-
Enterpriseのリストで、表示したいEnterpriseをクリックしてください。
-
Enterprise アカウントのサイドバーで、 [設定] をクリックします。 1. [設定] で、 [監査ログ] をクリックします。
-
[Export Git Events] ドロップダウン メニューを選択し、ログ イベントをエクスポートする日付範囲を選びます。
-
[Download Results] をクリックしてファイルをダウンロードします。
-
データは圧縮された JSON ファイルとしてエクスポートされます。 JSON データを抽出するには、アーカイブ ユーティリティ クライアントかコマンドを使用してファイルを圧縮解除します。 次に例を示します。
gunzip export-avocado-corp-1642896556.json.gz