本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS SAMCLI 中的遥测功能
<a name="serverless-sam-telemetry"></a>

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

 AWS SAM 命令行界面 (CLI) 收集遥测数据，例如一般使用指标、系统和环境信息以及错误。有关收集的遥测类型的详细信息，请参阅[收集的信息类型](#serverless-sam-telemtry-data-collected)。

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

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

## 关闭会话的遥测功能
<a name="serverless-sam-telemtry-opt-out"></a>

在 macOS 和 Linux 操作系统中，您可以关闭单个会话的遥测功能。要关闭当前会话的遥测功能，请运行以下命令将环境变量 `SAM_CLI_TELEMETRY` 设置为 `false`。对每个新终端或会话重复此命令。

```
export SAM_CLI_TELEMETRY=0
```

## 在所有会话中关闭配置文件的遥测功能
<a name="serverless-sam-telemtry-opt-out-profile"></a>

当您在操作系统上运行 AWS SAM CLI 时，运行以下命令关闭所有会话的遥测功能。

### 在 Linux 中关闭遥测功能
<a name="w2aac28c19c16c15b5"></a>

1. 运行：

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

1. 运行：

   ```
   source ~/.profile
   ```

### 在 macOS 中关闭遥测功能
<a name="w2aac28c19c16c15b7"></a>

1. 运行：

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

1. 运行：

   ```
   source ~/.profile
   ```

### 在 Windows 中关闭遥测功能
<a name="w2aac28c19c16c15b9"></a>

您可以使用以下命令，在终端窗口的生命周期内临时设置环境变量：

如果使用命令提示符：

```
set SAM_CLI_TELEMETRY=0
```

如果使用 PowerShell：

```
$env:SAM_CLI_TELEMETRY=0
```

要在命令提示符或中永久设置环境变量 PowerShell，请使用以下命令：

```
setx SAM_CLI_TELEMETRY 0
```

**注意**  
在终端关闭并重新打开后，更改才会生效。

## 收集的信息类型
<a name="serverless-sam-telemtry-data-collected"></a>
+ **使用情况信息** - 客户运行的通用命令和子命令。
+ **错误和诊断信息** - 客户运行的命令的状态和持续时间，包括退出代码、内部异常名称和 Docker 连接故障。
+ **系统和环境信息** — Python 版本、操作系统（Windows、Linux 或 macOS）、 AWS SAMCLI运行环境（例如， AWS CodeBuild AWS IDE 工具包或终端）以及使用情况属性的哈希值。

## 了解详情
<a name="serverless-sam-telemtry-learn-more"></a>

 AWS SAMCLI收集的遥测数据符合 AWS 数据隐私政策。有关更多信息，请参阅下列内容：
+ [AWS 服务条款](https://aws.amazon.com/service-terms/)
+ [数据隐私常见问题解答](https://aws.amazon.com/compliance/data-privacy-faq/)