# DynamoDB local 中的遥测
<a name="DynamoDBLocalTelemetry"></a>

 在 AWS，我们根据从与客户互动中学到的知识开发和推出服务，并使用客户反馈来迭代我们的产品。遥测是附加信息，可帮助我们更好地了解客户需求、诊断问题并提供特征，以改善客户体验。

 DynamoDB local 收集遥测数据，例如一般使用指标、系统和环境信息以及错误。有关收集的遥测类型的详细信息，请参阅[收集的信息类型](#DynamoDBLocalTelemetry.TypesOfInformationCollected)。

 DynamoDB local 不收集诸如用户名或电子邮件地址等个人信息。它也不会提取敏感的项目级信息。

 作为客户，您控制着是否开启遥测功能，并且可以随时更改设置。如果遥测保持开启状态，DynamoDB local 将在后台发送遥测数据，无需任何额外的客户互动。

## 使用命令行选项关闭遥测功能
<a name="DynamoDBLocalTelemetry.cli"></a>

 启动 DynamoDB local 时，您可以使用命令行选项 `-disableTelemetry` 关闭遥测功能。有关更多信息，请参阅 [命令行选项](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 local 时，运行以下命令以关闭所有会话的遥测功能。

**在 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 local 关闭遥测
<a name="DynamoDBLocalTelemetry.maven"></a>

 可以使用嵌入 Maven 项目的 DynamoDB local 关闭遥测功能。

```
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 local 运行的环境（例如，独立 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/)