Azure SQL Edge の使用状況と診断データの構成

[アーティクル]
09/22/2023

重要

Azure SQL Edge では、ARM64 プラットフォームがサポートされなくなりました。

Azure SQL Edge では既定で、お客様のアプリケーションの使用状態に関する情報が収集されます。具体的には、Azure SQL Edge により、展開エクスペリエンス、使用状況、パフォーマンスに関する情報が収集されます。この情報は、Microsoft が製品の向上を図り、お客様のニーズをさらに満たすのに役立ちます。たとえば Microsoft では、お客様が受け取るエラーコードの種類に関する情報を収集して、関連するバグの修正、Azure SQL Edge の使用方法に関するドキュメントの改善、より良いサービスのために製品に機能を追加すべきかどうかの判断を行います。

具体的には、Microsoft はこのメカニズムを通じて次の種類の情報を送信しません:

ユーザーテーブル内からのすべての値。
サインイン資格情報またはその他の認証情報。
個人データまたは顧客データ。

次のサンプルシナリオには、製品の向上に役立つ、機能の利用状況の情報が含まれます。

使用状況と診断データの収集に使用されるクエリの例を次に示します。このクエリでは、Azure SQL Edge で使用されているさまざまなストリーミングデータソースの数と種類が明らかになります。このデータは、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 での使用状況と診断データの収集は、次のいずれかの方法を使用して無効にできます。

Note

使用状況と診断データは、開発者バージョンでは無効にすることはできません。

環境変数を使用して使用状況と診断を無効にする

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 に送信されるデータ (ログ) を表す指定されたフォルダーに書き込むことができます。 Local Audit の目的は、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
```