Configuratie van gebruiks- en diagnostische gegevens in Azure SQL Edge

Artikel
10/24/2023

Belangrijk

Azure SQL Edge biedt geen ondersteuning meer voor het ARM64-platform.

Standaard verzamelt Azure SQL Edge informatie over de wijze waarop klanten de toepassing gebruiken. Azure SQL Edge verzamelt met name informatie over de implementatie-ervaring, het gebruik en de prestaties. Deze informatie helpt Microsoft het product te verbeteren om beter te voldoen aan de behoeften van klanten. Microsoft verzamelt bijvoorbeeld informatie over de soorten foutcodes die klanten tegenkomen, zodat we gerelateerde fouten kunnen oplossen, onze documentatie over het gebruik van Azure SQL Edge kunnen verbeteren en bepalen of functies aan het product moeten worden toegevoegd om klanten beter te bedienen.

Microsoft verzendt met name geen van de volgende typen informatie via dit mechanisme:

Waarden uit gebruikerstabellen.
Aanmeldingsreferenties of andere verificatiegegevens.
Persoonlijke of klantgegevens.

Het volgende voorbeeldscenario bevat informatie over het gebruik van functies waarmee het product kan worden verbeterd.

Er wordt als volgt een voorbeeldquery gegeven van de query's die worden gebruikt voor het verzamelen van gebruiks- en diagnostische gegevens. De query identificeert het aantal en de typen verschillende streaminggegevensbronnen die worden gebruikt in Azure SQL Edge. Met deze gegevens kan Microsoft bepalen welke streaminggegevensbronnen vaak worden gebruikt, zodat Microsoft de prestaties en gebruikerservaring die aan deze gegevensbronnen is gekoppeld, kan verbeteren.

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;

Verzameling van gebruiks- en diagnostische gegevens uitschakelen

Het verzamelen van gebruiks- en diagnostische gegevens in Azure SQL Edge kan worden uitgeschakeld met behulp van een van de onderstaande methoden.

Notitie

Gebruiks- en diagnostische gegevens kunnen niet worden uitgeschakeld voor de ontwikkelaarsversie.

Gebruik en diagnostische gegevens uitschakelen met behulp van omgevingsvariabelen

Als u het verzamelen van gebruiks- en diagnostische gegevens in Azure SQL Edge wilt uitschakelen, voegt u de volgende omgevingsvariabele toe en stelt u de waarde ervan in op *False*. Zie Configureren met behulp van omgevingsvariabelen voor meer informatie over het configureren van Azure SQL Edge met behulp van omgevingsvariabelen.

MSSQL_TELEMETRY_ENABLED = WAAR | VALSE

TRUE - Hiermee schakelt u het verzamelen van gebruiks- en diagnostische gegevens in. Dit is de standaard configuratie.
FALSE - Hiermee schakelt u het verzamelen van gebruiks- en diagnostische gegevens uit.

Gebruik en diagnostische gegevens uitschakelen met mssql.conf-bestand

Als u het verzamelen van gebruiks- en diagnostische gegevens in Azure SQL Edge wilt uitschakelen, voegt u de volgende regels toe in het bestand mssql.conf op het permanente opslagstation dat is toegewezen aan de map /var/opt/mssql/ in de SQL Edge-module. Zie Configureren met mssql.conf-bestand voor meer informatie over het configureren van Azure SQL Edge met behulp van het bestand mssql.conf.

[telemetry]
customerfeedback = false

Lokale controle van het verzamelen van gebruiks- en diagnostische gegevens

Het onderdeel Lokale controle van azure SQL Edge-gebruik en diagnostische gegevensverzameling kan gegevens schrijven die door de service worden verzameld naar een aangewezen map, die de gegevens (logboeken) vertegenwoordigt die naar Microsoft worden verzonden. Het doel van de lokale controle is om klanten toe te staan alle gegevens te zien die Microsoft met deze functie verzamelt, om redenen van naleving, regelgeving of privacyvalidatie.

Lokale controle van gebruiks- en diagnostische gegevens inschakelen

Gebruiks- en diagnostische gegevens voor lokale controle inschakelen in Azure SQL Edge:

Maak een doelmap voor nieuwe opslag voor lokaal auditlogboek. Deze doelmap kan zich op de host of in de container bevinden. In het volgende voorbeeld wordt de doelmap gemaakt in hetzelfde koppelvolume dat is toegewezen aan /var/opt/mssql/path in SQL Edge.
```
sudo mkdir <host mount path>/audit
```
Configureer de controle van gebruiks- en diagnostische gegevens met behulp van omgevingsvariabelen of mssql.conf-bestand.
- Omgevingsvariabelen gebruiken:
  - Voeg de volgende omgevingsvariabele toe aan uw SQL Edge-implementatie en geef de doelmap voor de auditbestanden op.
    
    *MSSQL_TELEMETRY_DIR = <host mount path>/audit*
- Bestand gebruiken mssql.conf :
  - Voeg de volgende regels toe in het bestand mssql.conf en geef de doelmap voor de auditbestanden op.
```
[telemetry]
userrequestedlocalauditdirectory  = <host mount path>/audit
```

Delen via