Configuración de datos de diagnóstico y uso de Azure SQL Edge

Artículo
09/22/2023

Importante

Azure SQL Edge ya no admite la plataforma ARM64.

De manera predeterminada, Azure SQL Edge recopila información sobre cómo sus clientes usan la aplicación. En concreto, Azure SQL Edge recopila información sobre la experiencia de implementación, el uso y el rendimiento. Esta información ayuda a Microsoft a mejorar el producto para satisfacer mejor las necesidades del cliente. Por ejemplo, Microsoft recopila información sobre los tipos de códigos de error que encuentran los clientes para que podamos corregir errores relacionados, mejorar nuestra documentación sobre cómo usar Azure SQL Edge y determinar si deben agregarse características al producto para ofrecer un mejor servicio a los clientes.

En concreto, Microsoft no envía ninguno de los siguientes tipos de información a través de este mecanismo:

Valores de dentro de las tablas de usuario.
Cualquier credencial de inicio de sesión u otra información de autenticación.
Datos personales o de clientes.

En el escenario de ejemplo siguiente se incluye información de uso de características que ayuda a mejorar el producto.

Se proporciona una consulta de ejemplo de las consultas usadas para la recopilación de datos de uso y diagnóstico, como se indica a continuación. La consulta identifica el recuento y los tipos de distintos orígenes de datos de streaming que se usan en Azure SQL Edge. Estos datos ayudan a Microsoft a identificar qué orígenes de datos de streaming se usan con frecuencia, por lo que Microsoft puede mejorar el rendimiento y la experiencia del usuario asociados con estos orígenes de datos.

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;

Deshabilitación de la recopilación de datos de uso y diagnóstico

La recopilación de datos de uso y diagnóstico en Azure SQL Edge se puede deshabilitar mediante cualquiera de los métodos siguientes.

Nota:

Los datos de uso y diagnóstico no se pueden deshabilitar para la versión del desarrollador.

Deshabilitación del uso y los diagnósticos mediante variables de entorno

Para deshabilitar la recopilación de datos de uso y diagnóstico en Azure SQL Edge, agregue la siguiente variable de entorno y establezca su valor *False*en . Para más información sobre cómo configurar Azure SQL Edge mediante variables de entorno, consulte Configuración mediante variables de entorno.

MSSQL_TELEMETRY_ENABLED = TRUE | FALSO

TRUE - Habilita la recopilación de datos de uso y diagnóstico. Esta es la configuración predeterminada.
FALSE - Deshabilita la recopilación de datos de uso y diagnóstico.

Deshabilitación del uso y los diagnósticos mediante un archivo mssql.conf

Para deshabilitar la recopilación de datos de uso y diagnóstico en Azure SQL Edge, agregue las siguientes líneas en el archivo mssql.conf en la unidad de almacenamiento persistente que se asigna a la carpeta /var/opt/mssql/ en el módulo de SQL Edge. Para más información sobre cómo configurar Azure SQL Edge mediante el archivo mssql.conf, consulte Configuración mediante el archivo mssql.conf.

[telemetry]
customerfeedback = false

Auditoría local de la recopilación de datos de uso y diagnóstico

El componente Auditoría local de la recopilación de datos de diagnóstico y uso de Azure SQL Edge puede escribir datos recopilados por el servicio en una carpeta designada, que representa los datos (registros) que se envían a Microsoft. El propósito de la Auditoría local es permitir que los clientes vean todos los datos que Microsoft recopila con esta característica, por motivos de cumplimiento, reglamentarios o por validación de privacidad.

Habilitación de auditoría local de la recopilación de datos de uso y diagnóstico

Para habilitar los datos de uso y diagnóstico de auditoría local en Azure SQL Edge:

Cree un directorio de destino para el nuevo almacenamiento de registros de Auditoría local. Este directorio de destino puede estar en el host o en el contenedor. En el ejemplo siguiente, el directorio de destino se crea en el mismo volumen de montaje asignado a la ruta de acceso /var/opt/mssql/ en SQL Edge.
```
sudo mkdir <host mount path>/audit
```
Configure la auditoría de datos de uso y diagnóstico mediante variables de entorno o el archivo mssql.conf.
- Uso de variables de entorno:
  - Agregue la siguiente variable de entorno a la implementación de SQL Edge y especifique el directorio de destino para los archivos de auditoría.
    
    *MSSQL_TELEMETRY_DIR = <host mount path>/audit*
- Uso del mssql.conf archivo:
  - Agregue las líneas siguientes en el archivo mssql.conf y especifique el directorio de destino para los archivos de auditoría.
```
[telemetry]
userrequestedlocalauditdirectory  = <host mount path>/audit
```

Compartir vía