共用方式為

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

  • 發行項

重要

Azure SQL Edge 將於 2025 年 9 月 30 日淘汰。 如需詳細資訊和移轉選項，請參閱淘汰通知。

注意

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 上啟用本機稽核使用方式和診斷資料：

  1. 為新的本機稽核記錄儲存體建立目標目錄。 此目標目錄可以位於主機上或容器內。 在下列範例中，建立目標目錄的掛接磁碟區同樣對應至 SQL Edge 上的 /var/opt/mssql/ 路徑。

    sudo mkdir <host mount path>/audit

  2. 使用環境變數或 mssql.conf 檔案來設定使用方式和診斷資料的稽核。

    • 使用環境變數：

      • 將下列環境變數新增至 SQL Edge 部署，並指定稽核檔案的目標目錄。

        *MSSQL_TELEMETRY_DIR = <host mount path>/audit*

    • 使用 mssql.conf 檔案：

      • 在 mssql.conf 檔案中新增下列幾行，並指定稽核檔案的目標目錄。

        [telemetry]
userrequestedlocalauditdirectory  = <host mount path>/audit

相關內容