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

# DynamoDB 本機版中的遙測功能
<a name="DynamoDBLocalTelemetry"></a>

 在 AWS，我們根據我們從與客戶互動中學到的內容來開發和啟動服務，並使用客戶意見回饋來迭代產品。遙測功能這項額外的資訊能幫助我們進一步了解客戶的需求、診斷問題，並且提供各項功能來改善客戶體驗。

 DynamoDB 本機版會收集遙測資訊，例如一般使用指標、系統和環境資訊以及錯誤。如需所收集遙測類型的詳細資訊，請參閱 [收集的資訊類型](#DynamoDBLocalTelemetry.TypesOfInformationCollected)。

 DynamoDB 本機版不會收集個人資訊，例如使用者姓名或電子郵件地址。同時也不會擷取敏感的專案層級資訊。

 身為客戶，您可以全權掌控是否開啟遙測功能，並且可以隨時變更您的設定。如果遙測功能保持開啟，DynamoDB 本機版會在背景傳送遙測資料，不需任何額外的客戶互動。

## 使用命令列選項關閉遙測功能
<a name="DynamoDBLocalTelemetry.cli"></a>

 您可以在使用選項 `-disableTelemetry` 啟動 DynamoDB 本機版時，使用命令列選項關閉遙測功能。如需詳細資訊，請參閱[命令列選項](DynamoDBLocal.UsageNotes.md#DynamoDBLocal.CommandLineOptions)。

## 關閉單一工作階段的遙測功能
<a name="DynamoDBLocalTelemetry.TurnOffTelemetrySingleSession"></a>

 在 macOS 和 Linux 作業系統中，您可以關閉單一工作階段的遙測功能。若要關閉目前工作階段的遙測功能，請執行下列命令，將環境變數 `DDB_LOCAL_TELEMETRY` 設定為 `false`。針對每個新的終端或工作階段重複此命令。

```
export DDB_LOCAL_TELEMETRY=0
```

## 在所有工作階段中關閉您的設定檔的遙測功能
<a name="DynamoDBLocalTelemetry.TurnOffTelemetryForAllSessions"></a>

 當您在作業系統上執行 DynamoDB 本機版時，執行下列命令即可關閉所有工作階段的遙測功能。

**關閉 Linux 中的遙測功能**

1.  執行：

   ```
   echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile
   ```

1.  執行：

   ```
   source ~/.profile
   ```

**關閉 macOS 中的遙測功能**

1.  執行：

   ```
   echo "export DDB_LOCAL_TELEMETRY=0" >>~/.profile
   ```

1.  執行：

   ```
   source ~/.profile
   ```

**關閉 Windows 中的遙測功能**

1.  執行：

   ```
   setx DDB_LOCAL_TELEMETRY 0
   ```

1.  執行：

   ```
   refreshenv
   ```

## 使用 Maven 專案嵌入的 DynamoDB 本機版關閉遙測功能
<a name="DynamoDBLocalTelemetry.maven"></a>

 您可以使用 Maven 專案嵌入的 DynamoDB 本機版來關閉遙測功能。

```
boolean disableTelemetry = true;
// AWS SDK v1
 AmazonDynamoDB amazonDynamoDB = DynamoDBEmbedded.create(disableTelemetry).amazonDynamoDB();

// AWS SDK v2
DynamoDbClient ddbClientSDKv2Local = DynamoDBEmbedded.create(disableTelemetry).dynamoDbClient();
```

## 收集的資訊類型
<a name="DynamoDBLocalTelemetry.TypesOfInformationCollected"></a>
+  **使用情形資訊**：一般遙測，例如伺服器啟動/停止，以及呼叫的 API 或操作。
+  **系統和環境資訊**：Java 版本、作業系統 (Windows、Linux 或 macOS)、DynamoDB 本機版執行所在的環境 (例如，單機版 JAR、Docker 容器或作為 Maven 依存項目)，以及用量屬性的雜湊值。

## 進一步了解
<a name="DynamoDBLocalTelemetry.LearnMore"></a>

 DynamoDB local 收集的遙測資料遵循 AWS 資料隱私權政策。如需詳細資訊，請參閱下列內容：
+  [AWS 服務條款](https://aws.amazon.com/service-terms/) 
+  [資料隱私權常見問答集](https://aws.amazon.com/compliance/data-privacy-faq/)