翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Q Developer での特定のユーザーのアクティビティの表示
<a name="q-admin-user-telemetry"></a>

組織内の個々の Amazon Q Developer サブスクライバーのユーザーアクティビティテレメトリを収集し、その情報をレポートに表示するように Amazon Q を設定できます。このレポートでは、特定のユーザーが Amazon Q をどのように使用しているかを把握できます。

Amazon Q は、毎日午前 0 時 (00:00) 協定世界時 (UTC) にレポートを生成し、次のパスの CSV ファイルに保存します。

`s3://{{bucketName}}/{{prefix}}/AWSLogs/{{accountId}}/QDeveloperLogs/by_user_analytic/{{region}}/{{year}}/{{month}}/{{day}}/00/{{accountId}}_by_user_analytic_{{timestamp}}.csv`

CSV ファイルは次のようになります。
+ 各行には、その日に Amazon Q とやり取りしたユーザーが表示されます。
+ 各列には、「[ユーザーアクティビティレポートのメトリクス](user-activity-metrics.md)」で説明されているメトリクスが表示されます。メトリクスは、その日に収集されたユーザーテレメトリに基づいて計算されます。

1 日に 1,000 人を超えるユーザーが Amazon Q とやり取りする場合、Amazon Q は、それぞれ 1,000 人のユーザーを含む複数の CSV ファイルにデータを分割し、`part_1`、`part_2` などのサフィックスを付与します。

**注記**  
ユーザーアクティビティレポートを有効にすると、**Amazon Q が使用状況データを AWSに送信できるか**について管理者がどのように設定したかにかかわらず、Amazon Q はテレメトリを収集します。この設定は、ユーザーの組織ではなく *AWS corporation* がテレメトリを使用できるかどうかを制御します。この設定の詳細については、[クライアント側のテレメトリの共有からオプトアウトする](opt-out-IDE.md#opt-out-IDE-telemetry) を参照してください。

次の手順を使用して、ユーザーアクティビティレポートを有効にします。

**前提条件**

ユーザーアクティビティレポート CSV ファイルを保持する Amazon S3 バケットを作成します。バケットは、次の条件を満たす必要があります。
+ Amazon Q Developer プロファイルがインストールされている AWS リージョンにいる。このプロファイルは、IAM アイデンティティセンターのワークフォースユーザーを Amazon Q Developer Pro に初めてサブスクライブしたときにインストールされます。このプロファイルとサポートされているリージョンの詳細については、「[Amazon Q Developer プロファイルとは](subscribe-understanding-profile.md)」および「[Q Developer コンソールと Q Developer プロファイルでサポートされているリージョン](q-admin-setup-subscribe-regions.md#qdev-console-and-profile-regions)」を参照してください。
+ ユーザーがサブスクライブされている AWS アカウントにいる。ユーザーが複数の AWS アカウントにサブスクライブしている場合は、それらの各アカウントにバケットを作成する必要があります。クロスアカウントバケットはサポートされていません。
+ (オプションですが推奨) [プロンプトログ](q-admin-prompt-logging.md)に使用するバケットとは異なる場所にある。
+ Amazon Q が CSV ファイルを保存するサブフォルダとも呼ばれるプレフィックスが含まれている。CSV ファイルをバケットのルートに保存することはできません。
+ 次のようなバケットポリシーが適用されていること。{{bucketName}}、{{region}}、{{accountId}}、{{prefix}} はお客様の情報で置き換えてください。

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Sid": "QDeveloperLogsWrite",
              "Effect": "Allow",
              "Principal": {
                  "Service": "q.amazonaws.com"
              },
              "Action": [
                  "s3:PutObject"
              ],
              "Resource": [
                  "arn:aws:s3:::{{bucketName}}/{{prefix}}/*"
              ],
              "Condition": {
                  "StringEquals": {
                      "aws:SourceAccount": "{{111122223333}}"
                  },
                  "ArnLike": {
                      "aws:SourceArn": "arn:aws:codewhisperer:{{us-east-1}}:{{111122223333}}:*"
                  }
              }
          }
      ]
  }
  ```

------

  (オプション) バケットで SSE-KMS を設定する場合は、以下のポリシーを KMS キーに追加します。

  ```
  {
      "Effect": "Allow",
      "Principal": {
          "Service": "q.amazonaws.com"
      },
      "Action": "kms:GenerateDataKey",
      "Resource": "*",
      "Condition": {
          "StringEquals": {
            "aws:SourceAccount": "{{accountId}}" 
          },
          "ArnLike": {
             "aws:SourceArn": "arn:aws:codewhisperer:{{region}}:{{accountId}}:*"
          }
      }
  }
  ```

  Amazon S3 バケット内のデータの保護については、「*Amazon Simple Storage Service ユーザーガイド*」の「[暗号化によるデータの保護](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html)」を参照してください。

**ユーザーアクティビティレポートを有効にするには**

1. Amazon Q Developer コンソールを開きます。

   Amazon Q Developer コンソールを使用するには、「[管理者に Amazon Q Developer コンソールの使用を許可する](id-based-policy-examples-admins.md#q-admin-setup-admin-users)」で定義されたアクセス許可が必要です。

1. **[設定]** を選択します。

1. **[Q Developer ユーザーアクティビティレポート]** で、**[編集]** を選択します。

1. **[ユーザーごとに詳細なメトリクスを収集する]** を切り替えます。

1. **[S3 ロケーション]** で、CSV レポートを保持する Amazon S3 URI を入力します。例: `s3://amzn-s3-demo-bucket/user-activity-reports/`