Configuration des données d’utilisation et de diagnostic Azure SQL Edge

Par défaut, Azure SQL Edge collecte des informations sur la façon dont ses clients utilisent l’application. Plus précisément, Azure SQL Edge recueille des données sur l’expérience d’installation, l’utilisation et les performances. Elles aident Microsoft à améliorer le produit pour mieux répondre aux besoins des clients. Par exemple, Microsoft collecte des informations sur les types de codes d’erreur rencontrés par les utilisateurs afin que nous puissions corriger les bogues associés, améliorer notre documentation sur l’utilisation d’Azure SQL Server et déterminer s’il faudrait ajouter des fonctionnalités au produit pour mieux servir des clients.

En particulier, Microsoft n’envoie par ce mécanisme aucune information de ces types :

• Toute valeur des tables utilisateur.
• Tout identifiant de connexion ou autres informations d’authentification.
• Toute donnée personnelle ou cliente.

L’exemple de scénario suivant comprend des informations sur l’utilisation des fonctionnalités, qui permettent d’améliorer le produit.

Vous trouverez ci-après un exemple de requête tiré des requêtes utilisées pour la collecte des données d’utilisation et de diagnostic. La requête identifie le nombre et les types de sources de données de streaming différentes utilisées dans Azure SQL Edge. Ces données aident Microsoft à identifier les sources de données de diffusion en continu couramment utilisées, de telle sorte que Microsoft peut améliorer les performances et l’expérience utilisateur associées à ces sources de données.

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;

Désactiver la collecte des données d’utilisation et de diagnostic

La collecte des données d’utilisation et de diagnostic sur Azure SQL Edge peut être désactivée à l’aide de l’une des méthodes ci-dessous.

Désactiver l’utilisation et les diagnostics à l’aide de variables d’environnement

Pour désactiver la collecte des données d’utilisation et de diagnostic sur Azure SQL Edge, ajoutez la variable d’environnement suivante et affectez-lui la valeur *False*. Pour plus d’informations sur la configuration d’Azure SQL Edge à l’aide de variables d’environnement, consultez Configurer à l’aide de variables d’environnement.

MSSQL_TELEMETRY_ENABLED = TRUE | FALSE

• TRUE : active la collecte des données d’utilisation et de diagnostic. Il s’agit de la configuration par défaut.
• FALSE : désactive la collecte des données d’utilisation et de diagnostic.

Désactiver l’utilisation et les diagnostics à l’aide de dossiers mssql.conf

Pour désactiver la collecte des données d’utilisation et de diagnostic sur Azure SQL Edge, ajoutez les lignes suivantes dans le fichier mssql.conf sur le lecteur de stockage persistant qui est mappé au dossier /var/opt/mssql/ dans le module SQL Edge. Pour plus d’informations sur la configuration d’Azure SQL Edge à l’aide du fichier mssql.conf, consultez Configurer à l’aide du fichier mssql.conf.

[telemetry]
customerfeedback = false

Audit local pour l’utilisation et collecte des données de diagnostic

Le composant d’audit local de la collecte de données d’utilisation et de diagnostic d’Azure SQL Edge peut écrire les données collectées par le service dans un dossier désigné, afin de représenter les données (journaux) qui sont envoyées à Microsoft. L’objectif de l’audit local est d’autoriser les clients à visualiser toutes les données collectées par Microsoft avec cette fonctionnalité, pour des raisons de conformité, de réglementation ou de validation de la confidentialité.

Activer l’audit local pour l’utilisation et collecte des données de diagnostic

Pour activer les données d’utilisation et de diagnostic de l’audit local sur Azure SQL Edge :

1. Créez un répertoire cible pour le stockage des nouveaux journaux d’audit local. Ce répertoire cible peut être sur l’ordinateur hôte ou dans le conteneur. Dans l’exemple suivant, le répertoire cible est créé dans le même volume de montage qui est mappé sur le chemin /var/opt/mssql/ dans SQL Edge.

   sudo mkdir <host mount path>/audit
   

2. Configurez l’audit des données d’utilisation et de diagnostics à l’aide de variables d’environnement ou d’un fichier mssql.conf.

   • Utilisation des variables d'environnement :

     • Ajoutez la variable d’environnement suivante à votre déploiement SQL Edge et spécifiez le répertoire cible pour les fichiers d’audit.

       *MSSQL_TELEMETRY_DIR = <host mount path>/audit*

   • Utilisation du fichier mssql.conf :

     • Ajoutez les lignes suivantes au fichier mssql.conf et spécifiez le répertoire cible pour les fichiers d’audit.

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

Contenu connexe

• Se connecter à Azure SQL Edge
• Générer une solution IoT de bout en bout avec SQL Edge