Konfiguration von Nutzungs- und Diagnosedaten in Azure SQL Edge

  • Artikel

Wichtig

Azure SQL Edge unterstützt die ARM64-Plattform nicht mehr.

Azure SQL Edge erfasst standardmäßig Informationen darüber, wie Kunden die Anwendung verwenden. Dies bedeutet, dass Azure SQL Edge Informationen zur Bereitstellung, Nutzung und Leistung sammelt. Mit diesen Informationen kann Microsoft besser an die Bedürfnisse der Kunden anpassen. Microsoft erfasst z. B. Informationen zu Fehlercodes von Kunden, sodass damit verknüpfte Probleme behoben werden können, die Dokumentation zu Azure SQL Edge verbessert und bestimmt werden kann, ob dem Produkt weitere Features hinzugefügt werden müssen, um die Nutzung weiter zu optimieren.

Insbesondere sendet Microsoft keine der folgenden Arten von Informationen über diesen Mechanismus:

  • Werte aus Benutzertabellen
  • Anmeldeinformationen oder andere Authentifizierungsinformationen.
  • persönliche Daten oder Kundendaten

Die folgenden Beispielszenarios beinhalten Informationen zur Nutzung von Funktionen, die zur Verbesserung des Produkts beitragen.

Eine Beispielabfrage aus den Abfragen, die für die Verwendung und Diagnose Datensammlung verwendet werden, wird wie folgt bereitgestellt. Die Abfrage identifiziert die Anzahl und die Typen verschiedener Streamingdatenquellen, die in Azure SQL Edge verwendet werden. Diese Daten helfen Microsoft dabei, zu ermitteln, welche Streamingdatenquellen häufig verwendet werden, damit Microsoft die Leistung und Nutzung der Datenquellen verbessern kann.

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;

Deaktivieren der Nutzungs- und Diagnosedatensammlung

Die Nutzungs- und Diagnosedatensammlung in Azure SQL Edge kann mit einer der folgenden Methoden deaktiviert werden.

Hinweis

Verwendungs- und Diagnosedaten können für die Entwicklerversion nicht deaktiviert werden.

Deaktivieren der Nutzungs- und Diagnosedatensammlung mithilfe von Umgebungsvariablen

Um die Verwendung zu deaktivieren und Diagnose Datensammlung in Azure SQL Edge zu deaktivieren, fügen Sie die folgende Umgebungsvariable hinzu, und legen Sie den Wert auf *False*. Weitere Informationen zum Konfigurieren von Azure SQL Edge mithilfe von Umgebungsvariablen finden Sie unter Konfigurieren von Umgebungsvariablen.

MSSQL_TELEMETRY_ENABLED = WAHR | FALSE

  • TRUE– Ermöglicht die Erfassung von Nutzungs- und Diagnose Daten. Dies ist die Standardkonfiguration.
  • FALSE– Deaktiviert die Sammlung von Nutzungs- und Diagnose Daten.

Deaktivieren der Nutzungs- und Diagnosedatensammlung mithilfe der mssql.conf-Datei

Um die Verwendung und Diagnose Datensammlung in Azure SQL Edge zu deaktivieren, fügen Sie die folgenden Zeilen in der Datei "mssql.conf" auf dem persistenten Speicherlaufwerk hinzu, das dem Ordner "/var/opt/mssql/" im SQL Edge-Modul zugeordnet ist. Weitere Informationen zum Konfigurieren von Azure SQL Edge mit der Datei "mssql.conf" finden Sie in der Datei "Configure using mssql.conf".

[telemetry]
customerfeedback = false

Komponente „Lokale Überwachung“ der Nutzungs- und -Diagnosedatensammlung

Die Lokale Überwachungskomponente der Azure SQL Edge Usage and Diagnostic Data Collection kann Daten schreiben, die vom Dienst in einen bestimmten Ordner gesammelt werden, der die Daten (Protokolle) darstellt, die an Microsoft gesendet werden. Der Zweck der lokalen Überwachung besteht darin, dass es Benutzern gestattet wird, alle Daten hinsichtlich Zustimmung, behördlicher Bestimmungen oder aus Datenschutzgründen anzuzeigen, die Microsoft mithilfe dieses Features erfasst.

Aktivieren der lokalen Überwachung der Nutzungs- und Diagnosedaten

So aktivieren Sie die Verwendung der lokalen Überwachung und Diagnose Daten in Azure SQL Edge:

  1. Erstellen Sie ein Zielverzeichnis für den neuen Speicher für lokale Überwachungsprotokolle. Dieses Zielverzeichnis kann sich entweder auf dem Host oder innerhalb des Containers befinden. Im folgenden Beispiel wird das Zielverzeichnis im gleichen Bereitstellungsvolume erstellt, das /var/opt/mssql/path in SQL Edge zugeordnet ist.

    sudo mkdir <host mount path>/audit

  2. Konfigurieren Sie die Überwachung von Nutzungs- und Diagnosedaten mithilfe von Umgebungsvariablen oder der Datei „mssql.conf“.

    • Verwenden von Umgebungsvariablen:

      • Fügen Sie der SQL Edge-Bereitstellung die folgende Umgebungsvariable hinzu, und geben Sie das Zielverzeichnis für die Überwachungsdateien an.

        *MSSQL_TELEMETRY_DIR = <host mount path>/audit*

    • Verwenden der mssql.conf Datei:

      • Fügen Sie die folgenden Zeilen in der Datei "mssql.conf" hinzu, und geben Sie das Zielverzeichnis für die Überwachungsdateien an.

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

Nächste Schritte