Skip to main content

Enterprise の監査ログ アクティビティのエクスポート

オフラインで分析するために、監査と Git のイベント データをファイルにエクスポートすることができます。

この機能を使用できるユーザーについて

Enterprise owners can export the audit log.

監査ログと Git イベント データのエクスポートについて

監査ログをエクスポートするには、GitHub Enterprise Cloud で Enterprise から JSON ファイルまたは CSV ファイルをダウンロードします。 監査ログ イベントをエクスポートするときに、サポートされている修飾子の 1 つ以上でクエリを実行して、エクスポートする特定のログ イベントをフィルター処理できます。 検索修飾子の詳細については、「エンタープライズの監査ログの検索」を参照してください。

監査ログには、過去 180 日以内に Enterprise に影響を及ぼすアクティビティによってトリガーされたイベントがリストされます。 監査ログには、Git イベントが 7 日間保持されます。

Enterprise 監査ログから JSON ファイルをダウンロードすると、Git イベント データをエクスポートできます。 監査ログ データとは異なり、監査ログ ユーザー インターフェイスでフィルター処理とエクスポートを行うために特定の Git イベントにクエリを実行することはできません。

注: Git イベントをエクスポートする場合、Web ブラウザー、REST API、または GraphQL API から開始されたイベントは含まれません。 たとえば、ユーザーが Web ブラウザーで pull request をマージすると、変更はベース ブランチにプッシュされますが、そのプッシュの Git イベントはエクスポートに含まれません。

エクスポートされたログの出力ファイルには、以下のキーと値があります。

Key値の例
actionteam.create
actoroctocat
usercodertocat
actor_location.country_codeUS
orgocto-org
repoocto-org/documentation
created_at1429548104000 (タイムスタンプは Epoch からの経過時間をミリ秒で示します。)
data.emailoctocat@nowhere.com
data.hook_id245
data.events["issues", "issue_comment", "pull_request", "pull_request_review_comment"]
data.events_were["push", "pull_request", "issues"]
data.target_loginoctocat
data.old_userhubot
data.teamocto-org/engineering

ログ イベントをエクスポートする代わりに、API を使用して監査ログ イベントを取得したり、イベントがログされる際に監査データをストリーム配信するように GitHub Enterprise Cloud を設定したりすることができます。 詳細については、「エンタープライズの監査ログ API を使う」および「Enterprise の監査ログのストリーミング」を参照してください。

監査ログ データのエクスポート

  1. GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。

  2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。

  3. Enterprise アカウントのサイドバーで、 [設定] をクリックします。

  4. [ 設定] で、 [監査ログ] をクリックします。

  5. 必要に応じて、フィルター処理された結果のみをエクスポートするには、1 つ以上のサポートされている修飾子またはログ フィルターで検索します。

  6. [エクスポート] ドロップダウン メニューを選んで、ファイル形式をクリックします。

Git イベント データのエクスポート

日付範囲ごとに Git イベント データをエクスポートすることもできます。

  1. GitHub.com の右上の自分のプロファイル写真をクリックし、 [自分の Enterprise] をクリックします。

  2. Enterpriseのリストで、表示したいEnterpriseをクリックしてください。

  3. Enterprise アカウントのサイドバーで、 [設定] をクリックします。

  4. [ 設定] で、 [監査ログ] をクリックします。

  5. [Git イベントのエクスポート] ドロップダウン メニューを選んで、ログ イベントをエクスポートする日付範囲を選びます。

  6. [ダウンロードの結果] をクリックします。

  7. データは圧縮された JSON ファイルとしてエクスポートされます。 JSON データを抽出するには、アーカイブ ユーティリティ クライアントかコマンドを使用してファイルを圧縮解除します。 次に例を示します。

    gunzip export-avocado-corp-1642896556.json.gz