configuração de dados de utilização e diagnóstico do SQL do Azure no Edge

Artigo
10/24/2023

Importante

O Azure SQL Edge não suporta mais a plataforma ARM64.

Por padrão, o Azure SQL Edge coleta informações sobre como seus clientes estão usando o aplicativo. Especificamente, o Azure SQL Edge coleta informações sobre a experiência de implantação, uso e desempenho. Essas informações ajudam a Microsoft a melhorar o produto para atender melhor às necessidades dos clientes. Por exemplo, a Microsoft coleta informações sobre os tipos de códigos de erro que os clientes encontram para que possamos corrigir bugs relacionados, melhorar nossa documentação sobre como usar o Azure SQL Edge e determinar se os recursos devem ser adicionados ao produto para melhor atender os clientes.

Especificamente, a Microsoft não envia nenhum dos seguintes tipos de informações através deste mecanismo:

Quaisquer valores de dentro de tabelas de usuário.
Quaisquer credenciais de início de sessão ou outras informações de autenticação.
Quaisquer dados pessoais ou de clientes.

O cenário de exemplo a seguir inclui informações de uso de recursos que ajudam a melhorar o produto.

Um exemplo de consulta das consultas usadas para a coleta de dados de uso e diagnóstico é fornecido da seguinte maneira. A consulta identifica a contagem e os tipos de diferentes fontes de dados de streaming que estão sendo usadas no Azure SQL Edge. Esses dados ajudam a Microsoft a identificar quais fontes de dados de streaming estão sendo usadas com frequência, para que a Microsoft possa melhorar o desempenho e a experiência do usuário associados a essas fontes de dados.

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;

Desativar o uso e a coleta de dados de diagnóstico

O uso e a coleta de dados de diagnóstico no Azure SQL Edge podem ser desabilitados usando qualquer um dos métodos abaixo.

Nota

Os dados de uso e diagnóstico não podem ser desabilitados para a versão do desenvolvedor.

Desabilitar o uso e o diagnóstico usando variáveis de ambiente

Para desabilitar a coleta de dados de uso e diagnóstico no SQL Edge do Azure, adicione a seguinte variável de ambiente e defina seu valor como *False*. Para obter mais informações sobre como configurar o Azure SQL Edge usando variáveis de ambiente, consulte Configurar usando variáveis de ambiente.

MSSQL_TELEMETRY_ENABLED = VERDADEIRO | FALSO

TRUE - Permite a recolha de dados de utilização e diagnóstico. Esta é a configuração predefinida.
FALSE - Desabilita a coleta de dados de uso e diagnóstico.

Desabilitar o uso e o diagnóstico usando o arquivo mssql.conf

Para desabilitar a coleta de dados de uso e diagnóstico no SQL Edge do Azure, adicione as seguintes linhas no arquivo mssql.conf na unidade de armazenamento persistente mapeada para a pasta /var/opt/mssql/ no módulo SQL Edge. Para obter mais informações sobre como configurar o Azure SQL Edge usando o arquivo mssql.conf, consulte Configurar usando o arquivo mssql.conf.

[telemetry]
customerfeedback = false

Auditoria local de uso e coleta de dados de diagnóstico

O componente Auditoria Local da coleta de Dados de Diagnóstico e Uso da Borda SQL do Azure pode gravar dados coletados pelo serviço em uma pasta designada, representando os dados (logs) enviados à Microsoft. O objetivo da Auditoria Local é permitir que os clientes vejam todos os dados que a Microsoft coleta com esse recurso, por motivos de conformidade, regulamentação ou validação de privacidade.

Habilitar auditoria local de dados de uso e diagnóstico

Para habilitar o uso da Auditoria Local e os dados de diagnóstico no SQL Edge do Azure:

Crie um diretório de destino para o novo armazenamento de log de Auditoria Local. Esse diretório de destino pode estar no host ou dentro do contêiner. No exemplo a seguir, o diretório de destino é criado no mesmo volume de montagem mapeado para o caminho /var/opt/mssql/ no SQL Edge.
```
sudo mkdir <host mount path>/audit
```
Configure a auditoria de dados de uso e diagnóstico usando variáveis de ambiente ou o arquivo mssql.conf.
- Usando variáveis de ambiente:
  - Adicione a seguinte variável de ambiente à sua implantação do SQL Edge e especifique o diretório de destino para os arquivos de auditoria.
    
    *MSSQL_TELEMETRY_DIR = <host mount path>/audit*
- Usando mssql.conf o arquivo:
  - Adicione as seguintes linhas no arquivo mssql.conf e especifique o diretório de destino para os arquivos de auditoria.
```
[telemetry]
userrequestedlocalauditdirectory  = <host mount path>/audit
```

Share via