# General Translation Platform: Audit Logs URL: https://generaltranslation.com/ja/docs/platform/dashboard/reference/audit-logs.mdx Docs index: https://generaltranslation.com/llms.txt Description: セキュリティ上重要なアクティビティを確認し、イベントレコードをAmazon S3に配信します。DashboardのAudit Logsとエクスポート設定に関するリファレンス。 Audit Logsは、Organizationおよびenterpriseスコープで利用できるEnterprise機能です。エンティティの管理Permissionが必要であり、デフォルトの**Admin**ロールにはこのPermissionが付与されています。 ## 概要 [#overview] | 項目 | 説明 | | -------------------------- | ----------------------------- | | [アクセス](#access) | プラン、権限、イベントスコープの動作。 | | [ダウンロード](#downloads) | 日付範囲の制限とJSON Lines出力。 | | [S3送信先](#destination) | 継続的デリバリーの設定と検証。 | | [送信先のステータス](#statuses) | 送信先が設定済み、有効、一時停止中、エラー状態のいずれか。 | | [配信動作](#delivery-behavior) | オブジェクトキー、バックフィル、再試行、配信履歴。 | | [イベントレコード](#event-records) | 各JSON Linesレコードに書き込まれるフィールド。 | ## アクセスとダウンロード [#access-downloads] ### アクセス Audit Logs を利用するには、Enterprise plan と次のいずれかの permissions が必要です。 * **Organization scope:** `org:manage` * **Enterprise scope:** `enterprise:manage` デフォルトの **Admin** ロールには管理 Permission があります。これを持たないユーザーには、アクセス拒否ページが表示されます。 Organization のエクスポートには、その Organization をスコープとするイベントが含まれます。Enterprise のエクスポートには、管理下の Organizations のイベントを含む、その Enterprise をスコープとするイベントが含まれます。 ### ダウンロード **組織のパス** **Organization > 設定 > Audit Logs** **エンタープライズのパス** **Enterprise > 設定 > Audit Logs** ダッシュボードから、非圧縮の JSON Lines (`.jsonl`) ファイルをダウンロードできます。 * 選択した開始日と終了日を含む期間が対象となり、ブラウザのローカルタイムゾーンが使用されます。将来の日付は選択できません。 * 選択できる期間は最大 366 日間です。 * 各ダウンロードには、その期間内の最も古いイベントから最大 10,000 件が含まれます。 * 該当するイベントがさらにある場合、ダッシュボードでは結果が切り詰められたものとして表示されます。完全な利用可能履歴を取得するには、範囲を狭めるか、S3 配信を使用してください。 * 該当するイベントがない場合、ダッシュボードではファイルはダウンロードされず、空の結果が表示されます。 ログをダウンロードすると、ファイルの内容が選択された後に監査イベントが作成されます。このイベントはダウンロード中のファイルには含まれず、後続のダウンロードおよび S3 配信に表示されます。 ## S3 配信 [#s3-delivery] ### 送信先 各 Organization または Enterprise では、S3 送信先を 1 つ設定できます。General Translation は、送信先の有効期間中にわたって変わらない External ID を使用して指定された IAM ロールを引き受け、設定されたバケットにオブジェクトを直接書き込みます。AWS アクセスキーは保存しません。 | フィールド | 説明 | 型 | 任意 | デフォルト | | --------------------- | --------------------------------------------------------------------------- | -------- | --- | ------------- | | **バケット** | 小文字、数字、ドット、ハイフンを使用した S3 バケット名。3～63 文字で、英字または数字で始まり終わる必要があり、連続するドットは使用できません。 | `string` | いいえ | — | | **バケットリージョン** | `us-east-1` など、バケットが存在する AWS リージョン。 | `string` | いいえ | — | | **プレフィックス** | オブジェクトキーのプレフィックス。空のパスセグメントと前後のスラッシュは削除されます。最大 512 文字です。 | `string` | はい | 空 | | **IAM ロール ARN** | バケットおよびプレフィックスに対する `s3:PutObject` を許可する AWS IAM ロール。 | `string` | いいえ | — | | **KMS キー ARN** | S3 サーバー側暗号化に使用する、Customer 管理の KMS キーまたはエイリアス。バケットと同じリージョンに存在する必要があります。 | `string` | はい | バケットのデフォルト暗号化 | | **External ID** | ロールの信頼ポリシーで必須とする読み取り専用の値。送信先の有効期間中にわたって変わりません。 | `string` | いいえ | 生成済み | | **Trusted principal** | 信頼ポリシーで `sts:AssumeRole` の呼び出しを許可する読み取り専用のロール ARN。 | `string` | いいえ | 環境固有 | 送信先を保存すると、各フィールドが永続化され、直ちに配信テストが実行されます。テストではロールを引き受け、設定されたバケット、プレフィックス、KMS 設定を使用して JSON 検証オブジェクトを書き込みます。テストに失敗しても、保存済みの設定は修正できる状態で保持されます。 検証オブジェクトでは、次のキー形式を使用します。 ```text //verification/gt_audit_export_verification__.json ``` 所有者パーティションは、`org_id=` または `enterprise_id=` です。 (信頼ポリシーのワークフローについては、[監査ログの管理](/docs/platform/dashboard/guides/managing-audit-logs)を参照してください)。 ### ステータス | ステータス | 意味 | | ---------- | -------------------------------------------------------------------------------------- | | `PENDING` | External ID のみが設定された事前プロビジョニング済みの送信先です。初回保存前に IAM 信頼ポリシーを完成させることができます。この状態では何も配信されません。 | | `ACTIVE` | 送信先が有効です。配信が手動で無効化されていない限り、保存または接続テストが成功するとこのステータスに設定されます。 | | `DISABLED` | 配信は一時停止されています。接続テストを実行しても、このステータスは維持されます。 | | `ERROR` | 直近の保存または接続テストで、検証オブジェクトを書き込めませんでした。このステータスの間はイベントは配信されません。 | **有効化**すると、接続をテストせずに `DISABLED` または `ERROR` が `ACTIVE` に変更されます。**削除**すると、以後の配信が停止され、ダッシュボードから送信先とその **最近の配信** 履歴が削除されます。また、別の送信先が設定されると、新しい External ID が生成されます。既存の S3 オブジェクトには影響しません。 ### 配信の動作 アクティブな宛先には、次のキー構造を持つ gzip 圧縮済みの JSON Lines オブジェクトが配信されます。 ```text //year=YYYY/month=MM/day=DD/hour=HH/audit__.jsonl.gz ``` 有効な送信先は3分ごとにチェックされます。各スイープでは直近60秒間のイベントを除外し、オブジェクトごとに最大1,000件のイベントを書き込みます。UTCの日付パーティションとファイル名のタイムスタンプは、イベントの `occurred_at` 値ではなく、送信時刻を反映します。各オブジェクトのコンテンツタイプは `application/jsonl`、コンテンツエンコーディングは `gzip` です。 送信は少なくとも1回保証されます。各試行では新しいオブジェクトキーが使用されます。アップロードが成功してもチェックポイントの更新を確認できない場合は、後続の再試行で重複するイベントを含む別のオブジェクトが生成されることがあります。コンシューマー側でイベントの `id` に基づいて重複を排除してください。 初回の有効化では、スコープ内で利用可能な最も古いイベントから開始されます。送信先のフィールドを編集してもエクスポートのチェックポイントは保持されるため、すでに送信済みのイベントが新しいバケットやプレフィックスにコピーされることはありません。送信先を削除して再作成するとチェックポイントがリセットされ、利用可能な履歴全体が再度送信される可能性があります。 **最近の送信**には、最新の10件の試行が表示されます。 | フィールド | 説明 | | ---------- | -------------------------------- | | **ステータス** | `DELIVERED` または `FAILED`。 | | **イベント** | 試行対象のオブジェクト内のイベント数。 | | **オブジェクト** | S3オブジェクトキー。失敗した試行では送信エラーも表示されます。 | | **作成日時** | 試行が記録された時刻。 | ## イベントレコード [#event-records] 各行は1つのJSONオブジェクトです。値が記録されていない任意のオブジェクトおよびフィールドは省略されます。 | フィールド | 説明 | 型 | | ------------- | ----------------------------------------------------------- | -------- | | `id` | 不変のイベント識別子。S3配信の重複を排除するために使用します。 | `string` | | `occurred_at` | ISO 8601タイムスタンプ形式のイベント発生時刻。 | `string` | | `event_type` | `project.created` や `api_key.deleted` などのドット区切りのアクティビティ識別子。 | `string` | | `result` | イベントの結果: `SUCCESS`、`FAILURE`、または `DENIED`。 | `string` | | `actor` | アクターの `type` と、利用可能な場合は `id`、`email`、`display`。 | `object` | | `source` | 利用可能な場合は、リクエストの `ip`、`user_agent`、`request_id`。 | `object` | | `resource` | 利用可能な場合は、影響を受けたリソースの `type` と `id`。 | `object` | | `scope` | 利用可能な場合は、関連する `org_id` と `enterprise_id`。 | `object` | | `metadata` | イベント固有のコンテキスト。 | JSON | | `changes` | イベント固有の変更後の値。 | JSON | アクターのタイプは `USER`、`API_KEY`、`SYSTEM`、`GT_ADMIN`、`LOCADEX` です。 ### イベントタイプ | カテゴリ | `event_type` の値 | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 認証 | `auth.login.success`, `auth.oauth_consent.approved`, `auth.oauth_consent.denied`, `auth.access.denied`, `auth.access.bypass` | | 管理者アクセス | `admin.super_user.started`, `admin.super_user.stopped` | | ユーザー | `user.created`, `user.updated`, `user.deleted`, `user.joined`, `user.left` | | プロジェクト | `project.created`, `project.updated`, `project.deleted` | | Organization | `organization.created`, `organization.updated`, `organization.deleted`, `organization.member.invited`, `organization.member.invite_removed`, `organization.member.removed`, `organization.member.role_updated`, `organization.billing.details_updated`, `organization.billing.subscription_updated`, `organization.billing.subscription_deleted`, `organization.billing.auto_reload_updated`, `organization.billing.credits_purchased`, `organization.billing.credits_granted`, `organization.billing.recovery_payment_retried` | | Enterprise | `enterprise.created`, `enterprise.updated`, `enterprise.deleted`, `enterprise.member.invited`, `enterprise.member.invite_removed`, `enterprise.member.removed`, `enterprise.member.role_updated`, `enterprise.billing.details_updated`, `enterprise.billing.auto_reload_updated`, `enterprise.billing.credits_purchased`, `enterprise.billing.recovery_payment_retried` | | API キー | `api_key.created`, `api_key.updated`, `api_key.deleted`, `org_api_key.created`, `org_api_key.updated`, `org_api_key.deleted` | | アクセスポリシー | `access_policy.updated` | | Webhooks | `dashboard.webhook.signing_secret.revealed` | | Audit Logs | `audit_log.destination.created`, `audit_log.destination.updated`, `audit_log.destination.deleted`, `audit_log.destination.tested`, `audit_log.downloaded` | | SSO と SCIM | `sso.provider.created`, `sso.provider.updated`, `sso.provider.deleted`, `sso.enforcement.updated`, `sso.sp_signing_key.rotated`, `scim.token.created`, `scim.connection.deleted` | | インテグレーション | `integration.created`, `integration.deleted`, `integration.translation.enqueued`, `account.integration.authorized`, `account.integration.revoked` | | Locadex | `locadex.settings.updated`, `locadex.workflow_settings.updated`, `locadex.secrets.updated`, `locadex.secrets.revealed`, `locadex.repository.disconnected` | OAuth 同意イベントの `metadata` には、`surface`、`authorization_type`、`decision`、`client_id` が含まれます。これらのイベントは、OAuth アプリケーションが要求したスコープをユーザーが承認したか拒否したかを記録します。 ```json title="監査イベント" { "id": "event_id", "occurred_at": "2026-08-13T15:19:02.000Z", "event_type": "project.created", "result": "SUCCESS", "actor": { "type": "USER", "id": "user_id", "email": "admin@example.com", "display": "admin@example.com" }, "source": { "ip": "203.0.113.10", "user_agent": "Mozilla/5.0", "request_id": "request_id" }, "resource": { "type": "PROJECT", "id": "project_id" }, "scope": { "org_id": "org_id", "enterprise_id": "enterprise_id" } } ``` ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.