What are audit logs?
メモ
Webhook は、特定のユース ケースの監査ログまたは API ポーリングの代替策として適している場合があります。 Webhook は、リポジトリ、Organization、または Enterprise で特定のイベントが発生したときに GitHub がサーバーに通知する方法です。 Enterprise、Organization、またはリポジトリで特定のイベントが発生したときに学習してログを記録するだけの場合、API や監査ログの検索と比較して、Webhook がより効率的である可能性があります。 「Webhook ドキュメント」をご覧ください。
監査ログには、Enterprise に影響するアクティビティによってトリガーされるイベントの一覧が表示されます。 GitHub の監査ログは、Enterprise 所有者が異なる保持期間を構成していない限り、無期限に保持されます。 「エンタープライズの監査ログの構成」をご覧ください。
既定では、過去 3 か月のイベントのみが表示されます。 古いイベントを表示するには、created パラメーターを使って日付範囲を指定します。 「検索構文を理解する」をご覧ください。
各監査ログ エントリの名前は、イベントのカテゴリと、それに続く操作タイプで構成されます。 たとえば、repo.create エントリは repo カテゴリに対する create 操作を意味します。
各 Audit log エントリには、次のようなイベントに関する適切な情報が表示されます:
- アクションが実行された エンタープライズまたは組織
- アクションを実行したユーザー (アクター)
- アクションによって影響を受けたユーザー
- アクションの対象となったリポジトリ
- 実行されたアクションです
- アクションが実行された国
- アクションが発生した日時
- アクションを実行したユーザー (アクター) の SAML SSO および SCIM ID
- Web UI 以外のアクションの場合、ユーザー (アクター) が認証した方法
Site administrators can review the audit log for an instance, which contains a wider range of events including system administrative events. To access the instance-level audit log:
- GitHub Enterprise Server の管理アカウントから、任意のページの右上隅にある をクリックします。
- [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。
- In the left menu, click Audit log.
In addition to viewing your audit log, you can monitor activity in your enterprise in other ways, such as viewing push logs and 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 or site administrator, 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. For more information, see エンタープライズの監査ログの検索.
- You can identify all events that were performed by a specific access token. For more information, see アクセス トークンによって実行される監査ログ イベントの識別.
- You can configure settings, such as the retention period for audit log events and whether Git events are included. For more information, see エンタープライズの監査ログの構成.
- You can stream audit and Git events data from GitHub to an external data management system. For more information, see Enterprise の監査ログのストリーミング.
- You can forward audit and system logs, from your enterprise to an third-party hosted monitoring system. For more information, see ログの転送.
- 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 エンタープライズの監査ログ イベント.