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

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 での使用状況と診断データの収集は、次のいずれかの方法を使用して無効にできます。

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

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 でローカル監査の使用状況と診断データを有効にするには:

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
       

関連するコンテンツ

• Azure SQL Edge に接続する
• SQL Edge を使用してエンドツーエンドの IoT ソリューションを構築する