本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon Q Developer 中檢視特定使用者的活動
<a name="q-admin-user-telemetry"></a>

您可以設定讓 Amazon Q 收集組織中個別 Amazon Q Developer 訂閱用戶的使用者活動遙測，並在報告中顯示該資訊。報告為您提供了深入了解特定使用者如何使用 Amazon Q 的資訊。

Amazon Q 會在每天午夜 (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,000 位使用者與 Amazon Q 互動，則 Amazon Q 會將資料拆分成數個 CSV 檔案，每個檔案包含 1,000 位使用者，且檔案會加上尾碼 `part_1`、`part_2`，以此類推。

**注意**  
當您啟用使用者活動報告時，Amazon Q 就會收集遙測，而不受開發人員在其 IDE 中的**讓 Amazon Q 將用量資料傳送至 AWS**設定影響。該設定會控制 *AWS 公司*是否可使用遙測，而非您的組織。如需有關此設定的詳細資訊，請參閱 [選擇退出共用用戶端遙測](opt-out-IDE.md#opt-out-IDE-telemetry)。

使用下列指示來啟用使用者活動報告。

**必要條件**

建立 Amazon S3 儲存貯體以保留使用者活動報告 CSV 檔案。儲存貯體必須：
+ 位於安裝 Amazon Q Developer 設定檔 AWS 的區域。此設定檔是在您第一次向 Amazon Q Developer 專業方案訂閱 IAM Identity Center 員工使用者時安裝。如需此設定檔及支援該設定檔之區域的詳細資訊，請參閱 [什麼是 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/`