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

# 中的遙測 AWS SAM CLI
<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
```

若要在 Command Prompt 或 PowerShell 中永久設定環境變數，請使用下列命令：

```
setx SAM_CLI_TELEMETRY 0
```

**注意**  
在終端機關閉並重新開啟之前，變更不會生效。

## 收集的資訊類型
<a name="serverless-sam-telemtry-data-collected"></a>
+ **用量資訊** – 客戶執行的一般命令和子命令。
+ **錯誤和診斷資訊** – 客戶執行的命令狀態和持續時間，包括結束代碼、內部例外名稱，以及連線至 Docker 時失敗。
+ **系統和環境資訊** – Python 版本、作業系統 (Windows、Linux 或 macOS)、執行環境 AWS SAM CLI（例如 AWS CodeBuild IDE AWS 工具組或終端機），以及用量屬性的雜湊值。

## 進一步了解
<a name="serverless-sam-telemtry-learn-more"></a>

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