Azure SQL Edge 使用量和診斷資料組態設定

發行項
04/23/2024

重要

Azure SQL Edge 不再支援 ARM64 平台。

Azure SQL Edge 預設會收集客戶如何使用應用程式的相關資訊。具體來說，Azure SQL Edge 會收集部署體驗、使用方式和效能的相關資訊。這些資訊可協助 Microsoft 改善產品，以進一步滿足客戶需求。例如，Microsoft 會收集客戶遇到何種錯誤碼的相關資訊，以便修正相關的 BUG、改進 Azure SQL Edge 用法的相關文件，以及決定是否應新增產品的功能以更滿足客戶的需求。

具體來說，Microsoft 不會透過此機制傳送下列類型的資訊：

使用者資料表內的任何值。
任何登入認證或其他驗證資訊。
任何個人或客戶資料。

下列範例案例包含可協助改善產品的功能使用方式資訊。

如下提供用於使用方式和診斷資料收集的查詢範例。此查詢識別 Azure SQL Edge 中使用的各種串流資料來源的計數和類型。此資料協助 Microsoft 識別常用的串流資料來源，讓 Microsoft 可以改善與這些資料來源相關聯的效能和使用者體驗。

SELECT count(*) AS [count],
    sum(inputs) AS inputs,
    sum(outputs) AS outputs,
    sum(linked_to_job) AS linked_to_job,
    data_source_type
FROM (
    SELECT ISNULL(value, 'unknown') AS data_source_type,
        inputs,
        outputs,
        linked_to_job
    FROM (
        SELECT convert(SYSNAME, LOWER(SUBSTRING(ds.location, 0, CHARINDEX('://', ds.location))), 1) AS data_source_type,
            ISNULL(inputs, 0) AS inputs,
            ISNULL(outputs, 0) AS outputs,
            ISNULL(js.stream_id / js.stream_id, 0) AS linked_to_job
        FROM sys.external_streams es
        INNER JOIN sys.external_data_sources ds
            ON es.data_source_id = ds.data_source_id
        LEFT JOIN (
            SELECT stream_id,
                MAX(CAST(is_input AS INT)) inputs,
                MAX(CAST(is_output AS INT)) outputs
            FROM sys.external_job_streams
            GROUP BY stream_id
            ) js
            ON js.stream_id = es.object_id
        ) ds
    LEFT JOIN (
        SELECT value
        FROM string_split('edgehub,sqlserver,kafka', ',')
        ) AS known_ep
        ON data_source_type = value
    ) known_ds
GROUP BY data_source_type;

停用使用方式和診斷資料收集

您可以使用下列任一方法在 Azure SQL Edge 上停用使用方式和診斷資料收集。

注意

開發人員版本無法停用使用方式和診斷資料。

使用環境變數停用使用方式和診斷

若要在 Azure SQL Edge 上停用使用方式和診斷資料收集，請新增下列環境變數，並將值設定為 *False*。如需有關使用環境變數設定 Azure SQL Edge 的詳細資訊，請參閱使用環境變數進行設定。

MSSQL_TELEMETRY_ENABLED = TRUE | FALSE

TRUE - 啟用使用方式和診斷資料收集。這是預設設定。
FALSE - 停用使用方式和診斷資料收集。

使用 mssql.conf 檔案停用使用方式和診斷

若要在 Azure SQL Edge 上停用使用方式和診斷資料收集，請在對應至 SQL Edge 模組中的 /var/opt/mssql/ 資料夾的永續性儲存體磁碟機上，在 mssql.conf 檔案中新增下列幾行。如需有關使用 mssql.conf 檔案設定 Azure SQL Edge 的詳細資訊，請參閱使用 mssql.conf 檔案進行設定。

[telemetry]
customerfeedback = false

使用方式和診斷資料收集的本機稽核

Azure SQL Edge 使用方式和診斷資料收集的本機稽核元件，可以將服務收集的資料寫入指定的資料夾，代表會傳送給 Microsoft 的資料 (記錄)。本機稽核的目的是要讓客戶看到 Microsoft 以此功能收集的所有資料，以用於相容性、法規或隱私權驗證的理由。

啟用使用方式和診斷資料的本機稽核

在 Azure SQL Edge 上啟用本機稽核使用方式和診斷資料：

為新的本機稽核記錄儲存體建立目標目錄。此目標目錄可以位於主機上或容器內。在下列範例中，建立目標目錄的掛接磁碟區同樣對應至 SQL Edge 上的 /var/opt/mssql/ 路徑。
```
sudo mkdir <host mount path>/audit
```
使用環境變數或 mssql.conf 檔案來設定使用方式和診斷資料的稽核。
- 使用環境變數：
  - 將下列環境變數新增至 SQL Edge 部署，並指定稽核檔案的目標目錄。
    
    *MSSQL_TELEMETRY_DIR = <host mount path>/audit*
- 使用 mssql.conf 檔案：
  - 在 mssql.conf 檔案中新增下列幾行，並指定稽核檔案的目標目錄。
```
[telemetry]
userrequestedlocalauditdirectory  = <host mount path>/audit
```

Share via