What are audit logs?
メモ
Webhook は、特定のユース ケースの監査ログまたは API ポーリングの代替策として適している場合があります。 Webhook は、リポジトリ、Organization、または Enterprise で特定のイベントが発生したときに GitHub がサーバーに通知する方法です。 Enterprise、Organization、またはリポジトリで特定のイベントが発生したときに学習してログを記録するだけの場合、API や監査ログの検索と比較して、Webhook がより効率的である可能性があります。 「Webhook ドキュメント」をご覧ください。
監査ログには、Enterprise に影響するアクティビティによってトリガーされるイベントの一覧が表示されます (過去 180 日以内)。 監査ログには、Git イベントが 7 日間保持されます。
既定では、過去 3 か月のイベントのみが表示されます。 古いイベントを表示するには、created パラメーターを使って日付範囲を指定します。 「検索構文を理解する」をご覧ください。
各監査ログ エントリの名前は、イベントのカテゴリと、それに続く操作タイプで構成されます。 たとえば、repo.create エントリは repo カテゴリに対する create 操作を意味します。
各 Audit log エントリには、次のようなイベントに関する適切な情報が表示されます:
- アクションが実行された エンタープライズまたは組織
- アクションを実行したユーザー (アクター)
- アクションによって影響を受けたユーザー
- アクションの対象となったリポジトリ
- 実行されたアクションです
- アクションが実行された国
- アクションが発生した日時
- アクションを実行したユーザー (アクター) の SAML SSO および SCIM ID
- Web UI 以外のアクションの場合、ユーザー (アクター) が認証した方法
- 必要に応じて、アクションを実行したユーザー (アクター) の送信元 IP アドレス
In addition to viewing your audit log, you can monitor activity in your enterprise in other ways, such as managing global webhooks. For more information, see 企業でのユーザー アクティビティの調査. You can also use the audit log, and other tools, to monitor the actions taken in response to security alerts. For more information, see セキュリティ アラートの監査.
How to use audit logs
As an enterprise owner, you can interact with the audit log data for your enterprise in several ways:
- You can view the audit log for your enterprise. For more information, see 企業の監査ログにアクセスする.
- You can search the audit log for specific events and export audit log data. For more information, see エンタープライズの監査ログの検索 and Enterprise の監査ログ アクティビティのエクスポート.
- You can identify all events that were performed by a specific access token. For more information, see アクセス トークンによって実行される監査ログ イベントの識別.
- You can display the IP address associated with events in the audit log. For more information, see Enterprise の監査ログに IP アドレスを表示する.
- You can stream audit and Git events data from GitHub to an external data management system. For more information, see Enterprise の監査ログのストリーミング.
- You can use the Audit log API to view actions performed in your enterprise. For more information, see エンタープライズの監査ログ API を使う.
For a full list of audit log actions that may appear in your enterprise audit log, see エンタープライズの監査ログ イベント.