

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

# 設定遙測
<a name="telemetrics-configuration-option"></a>

為了啟用更佳的支援，根據預設，Microsoft Windows 用 Amazon Kinesis 代理程式會收集代理程式操作的相關統計資料，並傳送至 AWS。此資訊並未包含任何個人識別資訊。它不會包含任何您收集或串流至 AWS 服務的資料。我們會每 60 分鐘收集約 1—2 KB 的這項指標資料。

您可以退出收集及傳輸這些統計資料。若要執行此作業，請將以下鍵/值對新增至與來源、接收和管道相同層級的 `appsettings.json` 組態檔案：

```
"Telemetrics": 
    { "off": "true" }
```

例如，以下組態檔案會設定來源、接收和管道，同時停用遙測：

```
{
  "Sources": [
    {
      "Id": "ApplicationLogSource",
      "SourceType": "DirectorySource",
      "Directory": "C:\\LogSource\\",
      "FileNameFilter": "*.log",
      "RecordParser": "SingleLine"
    }
  ],
  "Sinks": [
    {
       "Id": "ApplicationLogKinesisFirehoseSink",
       "SinkType": "KinesisFirehose",
       "StreamName": "ApplicationLogFirehoseDeliveryStream",
       "Region": "us-east-1"
    }  
    ],
  "Pipes": [
    {
      "Id": "ApplicationLogSourceToApplicationLogKinesisFirehoseSink",
      "SourceRef": "ApplicationLogSource",
      "SinkRef": "ApplicationLogKinesisFirehoseSink"
    }
  ],
  "Telemetrics":
    {
      "off": "true"
    }
}
```

我們會在啟用遙測時收集下列指標：

`ClientId`  
安裝軟體時自動指派的唯一 ID。

`ClientTimestamp`  
收集遙測的日期和時間。

`OSDescription`  
作業系統的描述。

`DotnetFramework`  
目前的 dotnet 框架版本。

`MemoryUsage`  
Kinesis 代理程式使用的記憶體量 (MB)。

`CPUUsage`  
Windows CPU 用量百分比 (小數)。例如，0.01 表示 1%。

`InstanceId`  
如果 Windows 適用的 Kinesis 代理程式正在 Amazon EC2 執行個體上執行，則為 Amazon EC2 執行個體識別碼。

`InstanceType (string)`  
如果 Windows 適用的 Kinesis 代理程式正在 Amazon EC2 執行個體上執行，則為 Amazon EC2 執行個體類型。

此外，我們還會收集[適用於視窗度量的 Kinesis 代理程式清單](source-object-declarations.md#kinesis-agent-metric-list)中所列的指標。