Configurazione dei dati di diagnostica e utilizzo di SQL Edge di Azure

Per impostazione predefinita, SQL Edge di Azure raccoglie informazioni su come i clienti usano l'applicazione. In particolare, SQL Edge di Azure raccoglie informazioni sull'esperienza di distribuzione, utilizzo e prestazioni. Queste informazioni consentono a Microsoft di migliorare il prodotto per meglio soddisfare le esigenze dei clienti. Ad esempio, Microsoft raccoglie informazioni sui tipi di codici di errore riscontrati dai clienti in modo da poter correggere i bug correlati, migliorare la documentazione su come usare SQL Edge di Azure e determinare se occorre aggiungere funzionalità al prodotto per offrire un'esperienza migliore ai clienti.

In particolare, Microsoft non invia alcuna informazione dei tipi seguenti tramite questo meccanismo:

• Valori all'interno delle tabelle utente.
• Credenziali di accesso o altre informazioni di autenticazione.
• Dati personali o dei clienti.

Lo scenario di esempio seguente include informazioni sull'utilizzo di funzionalità che consentono di migliorare il prodotto.

Di seguito viene fornita una query di esempio delle query usate per la raccolta dei dati di utilizzo e diagnostica. La query identifica il numero e i tipi di origini dati di streaming diverse usate in SQL Edge di Azure. Questi dati consentono a Microsoft di identificare quali origini dati di streaming vengono usate comunemente in modo che Microsoft possa migliorare le prestazioni e l'esperienza utente associate a queste origini dati.

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;

Disabilitare la raccolta di dati di diagnostica e utilizzo

La raccolta dei dati di diagnostica e utilizzo in SQL Edge di Azure può essere disabilitata usando uno dei metodi seguenti.

Disabilitare l'utilizzo e la diagnostica tramite variabili di ambiente

Per disabilitare la raccolta dei dati di utilizzo e diagnostica in SQL Edge di Azure, aggiungere la variabile di ambiente seguente e impostarne il valore su *False*. Per altre informazioni sulla configurazione delle variabili di ambiente di SQL Edge di Azure, vedere Configurare tramite variabili di ambiente.

MSSQL_TELEMETRY_ENABLED = TRUE | FALSE

• TRUE: abilita la raccolta dei dati di utilizzo e diagnostica. Questa è la configurazione predefinita.
• FALSE: disabilita la raccolta dei dati di utilizzo e diagnostica.

Disabilitare l'utilizzo e la diagnostica tramite il file mssql.conf

Per disabilitare la raccolta dei dati di utilizzo e diagnostica in SQL Edge di Azure, aggiungere le righe seguenti nel file mssql.conf nell'unità di archiviazione persistente mappata alla cartella /var/opt/mssql/ nel modulo SQL Edge. Per altre informazioni sulla configurazione di SQL Edge di Azure tramite il file mssql.conf, vedere Configurare tramite il file mssql.conf.

[telemetry]
customerfeedback = false

Controllo locale della raccolta dei dati di utilizzo e diagnostica

Il componente per il controllo locale della raccolta dei dati di utilizzo e diagnostica di SQL Edge di Azure può scrivere i dati raccolti dal servizio in una cartella specifica, che rappresenta i dati (log) inviati a Microsoft. Lo scopo del controllo locale è quello di consentire ai clienti di visualizzare tutti i dati che Microsoft raccoglie con questa funzionalità, per motivi di conformità alle normative o rispetto della privacy.

Abilitare il controllo locale della raccolta dei dati di utilizzo e diagnostica

Per abilitare il controllo locale dei dati di utilizzo e diagnostica in SQL Edge di Azure:

1. Creare una directory di destinazione per l'archiviazione del nuovo log di controllo locale. Questa directory di destinazione può trovarsi nell'host o all'interno del contenitore. Nell'esempio seguente, la directory di destinazione viene creata nello stesso volume di montaggio mappato al percorso /var/opt/mssql/ in SQL Edge.

   sudo mkdir <host mount path>/audit
   

2. Configurare il controllo dei dati di utilizzo e diagnostica tramite variabili di ambiente o il file mssql.conf.

   • Tramite variabili di ambiente:

     • Aggiungere la variabile di ambiente seguente alla distribuzione di SQL Edge e specificare la directory di destinazione per i file di controllo.

       *MSSQL_TELEMETRY_DIR = <host mount path>/audit*

   • Tramite il file mssql.conf:

     • Aggiungere le righe seguenti nel file mssql.conf e specificare la directory di destinazione per i file di controllo.

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

Contenuto correlato

• Connettersi a SQL Edge di Azure
• Creare una soluzione IoT end-to-end con SQL Edge