# General Translation Platform: 監査ログの管理
URL: https://generaltranslation.com/ja/docs/platform/dashboard/guides/managing-audit-logs.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: ダッシュボードから監査イベントをダウンロードし、Amazon S3 に継続的に配信する方法。

Audit Logs には、Organization または enterprise 全体にわたるセキュリティ上重要なアクティビティが記録されます。各イベントには、実行者、ソース、リソース、スコープ、記録された変更内容が含まれます。

## 開始する前に [#before-start]

* Audit Logs を利用するには Enterprise plan が必要です。
* エンティティを管理する Permission が必要です。デフォルトの **Admin** ロールにはこの Permission があります。
* S3 配信 を使用するには、バケットに書き込める AWS Identity and Access Management (IAM) ロールを作成する Permission が必要です。

単一の Organization の場合は **Organization > 設定 > Audit Logs** を使用します。配下の Organizations のイベントを含む Enterprise 全体のイベントについては、**Enterprise > 設定 > Audit Logs** を使用します。

## 監査イベントをダウンロード [#download]

1. Organization または Enterprise スコープで **Audit Logs** を開きます。
2. 日付範囲を選択します。指定できる期間は最大 1 年です。
3. **Download** を選択します。

ダッシュボード により、S3 エクスポートと同じイベント形式の非圧縮 JSON Lines (`.jsonl`) ファイルがダウンロードされます。ダウンロードには、選択した範囲内の最も古いイベントから最大 10,000 件が含まれます。切り詰められた場合は、範囲を狭めるか、利用可能な完全な履歴を取得するには S3 配信 を使用してください。

## S3 への配信を設定する [#configure-s3]

### 1. 信頼情報の値をコピーする

**Audit Logs** を開き、**External ID** と **Trusted principal** をコピーします。ダッシュボード は、送信先 を保存する前に、Organization または Enterprise 用の固定の External ID を生成します。

### 2. IAM ロールを作成する

AWS アカウントで IAM ロールを作成します。信頼ポリシーでは、表示された Trusted principal が、表示された External ID が一致する場合にのみ `sts:AssumeRole` を呼び出せるようにする必要があります。

```json title="Trust policy"
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "<trusted-principal-arn>"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<external-id>"
        }
      }
    }
  ]
}
```

宛先バケットとプレフィックスに対する `s3:PutObject` 権限をロールに付与します。カスタマー管理の AWS Key Management Service (KMS) キーまたはエイリアスを指定する場合は、バケットと同じリージョンに存在する必要があります。ロールとキーポリシーを設定して、そのキーに対する `kms:GenerateDataKey` を許可します。

<Callout type="warn">
  ダッシュボード に表示されている Trusted principal と External ID を使用してください。別の
  Organization、Enterprise、または環境の値を再利用しないでください。
</Callout>

### 3. 送信先を保存する

次の項目を入力します。

* **Bucket** — S3 バケット名
* **Bucket region** — バケットがある AWS リージョン
* **Prefix (optional)** — 配信ファイルのオブジェクトキーに付加するプレフィックス
* **IAM ロール ARN** — General Translation が引き受けるロール
* **KMS key ARN (optional)** — サーバーサイド暗号化用の顧客管理キー

**Save destination** を選択します。保存すると、監査イベントで使用するものと同じロール、バケット、プレフィックス、KMS パスを通じて、検証用オブジェクトも書き込まれます。送信先が無効化されていない場合、テストが成功すると配信が有効になります。送信先が無効化されていない場合、テストが失敗すると **ERROR** が設定されます。テストを実行しても **DISABLED** は維持されます。

## 配信のテストと管理 [#manage-delivery]

* **接続をテスト**すると、新しい検証用オブジェクトがバケットに書き込まれ、送信先のステータスが更新されます。
* **無効化**すると、送信先を削除せずに新規配信を一時停止します。**有効化**すると、接続をテストせずに **ACTIVE** に設定されるため、エラーを修正した後はまず接続をテストしてください。
* **削除**すると、今後の配信が停止され、ダッシュボードから送信先とその **Recent Deliveries** 履歴が削除されます。別の送信先を設定すると新しい External ID が生成されるため、再度保存する前に IAM 信頼ポリシーを更新してください。既存の S3 オブジェクトには影響しません。
* **Recent Deliveries** には、ステータス、イベント数、S3 オブジェクトキー、作成時刻、失敗した試行のエラーを含む最新 10 件の試行が表示されます。

初回の有効化では、スコープ内で利用可能な最も古いイベントから開始されます。送信先のフィールドを編集しても配信チェックポイントは保持されるため、すでに配信されたイベントが新しいバケットやプレフィックスにコピーされることはありません。送信先を削除して再作成するとチェックポイントがリセットされ、利用可能な履歴全体が再度配信される可能性があります。

S3 配信は少なくとも 1 回行われます。不明確な失敗後の再試行により重複するオブジェクトが作成される可能性があるため、イベントは `id` で重複排除してください。 (ステータス、オブジェクトキー、イベントフィールドについては、[Audit Logs reference](/docs/platform/dashboard/reference/audit-logs) を参照してください) 。

## Next steps

- /docs/platform/dashboard/guides/managing-billing
- /docs/platform/dashboard/guides/using-ask-ai
- /docs/platform/dashboard/guides/reviewing-translations
- /docs/platform/dashboard/guides/defining-context-for-translations

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.