Compartilhar via

Configuração de dados de diagnóstico e uso do SQL do Azure no Edge

  • Artigo

Importante

O SQL do Azure no Edge será desativado em 30 de setembro de 2025. Para obter mais informações e opções de migração, veja o Aviso de aposentadoria.

Observação

O SQL do Azure no Edge encerrou o suporte à plataforma ARM64.

Por padrão, o SQL do Azure no Edge coleta informações sobre como os clientes estão usando o aplicativo. Especificamente, o SQL do Azure no 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 melhor atender às necessidades do cliente. Por exemplo, a Microsoft coleta informações sobre quais tipos de códigos de erro os clientes costumam encontrar, para que possamos corrigir erros relacionados, melhorar nossa documentação sobre como usar o SQL do Azure no Edge e determinar quais recursos deveriam ser adicionados ao produto para melhor atender aos clientes.

Especificamente, a Microsoft não envia nenhum dos seguintes tipos de informações por meio desse mecanismo:

  • Qualquer valor das tabelas de usuário.
  • Quaisquer credenciais de entrada ou outras informações de autenticação.
  • Quaisquer dados pessoais ou de clientes.

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

Uma consulta de exemplo das consultas usadas para a coleta de dados de uso e diagnóstico é fornecida da seguinte maneira. A consulta identifica a contagem e os tipos de diferentes fontes de dados de streaming que estão sendo usadas no SQL do Azure no Edge. Esses dados ajudam a Microsoft a identificar quais fontes de dados de streaming estão sendo usadas normalmente, de modo que a Microsoft possa melhorar o desempenho e a experiência do usuário associadas 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;

Desabilitar a coleta de dados de diagnóstico e de uso

A coleta de dados de diagnóstico e uso no SQL do Azure no Edge pode ser desabilitada usando qualquer um dos métodos abaixo.

Observação

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 do Azure no Edge, adicione a variável de ambiente a seguir e defina o seu valor como *False*. Para obter mais informações sobre como configurar o SQL do Azure no Edge usando variáveis de ambiente, confira Configurar usando variáveis de ambiente.

MSSQL_TELEMETRY_ENABLED = TRUE | FALSE

  • TRUE – Habilita a coleta de dados de uso e diagnóstico. Essa é a configuração padrão.
  • FALSE – Desabilita a coleta de dados de uso e diagnóstico.

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

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

[telemetry]
customerfeedback = false

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

O componente Auditoria Local da coleta de dados de diagnóstico e uso do SQL do Azure no Edge pode gravar dados coletados pelo serviço em uma pasta designada, representando os dados (logs) enviados à Microsoft. A finalidade da Auditoria Local é permitir que os clientes vejam todos os dados que a Microsoft coleta com esse recurso, para fins de conformidade, regulatórios ou de validação de privacidade.

Habilitar a auditoria local de dados de diagnóstico e uso

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

  1. 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 no Edge.

    sudo mkdir <host mount path>/audit

  2. Configure a auditoria de dados de diagnóstico e uso utilizando as variáveis de ambiente ou o arquivo mssql.conf.

    • Usando variáveis de ambiente:

      • Adicione a variável de ambiente a seguir à 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 o arquivo mssql.conf:

      • Adicione as linhas a seguir no arquivo mssql.conf e especifique o diretório de destino para os arquivos de auditoria.

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

Conteúdo relacionado