Gerenciar Definições

Use as Configurações para armazenar e gerenciar informações de log para seus Suplementos de Planilha.

No menu Oracle Database, clique em Definições para configurar as opções a seguir.

Descrição da ilustração log-settings.png

Embora a maioria das opções esteja disponível para planilhas em geral, algumas opções são específicas apenas para o Microsoft Excel ou Google Sheets.

Mostrar seleção de grupo de consumidores

Esta opção permite definir a prioridade para consultas executadas a partir de uma planilha.

Por padrão, as consultas são executadas com a prioridade LOW. Quando ativado, o add-in fornece uma opção para selecionar a prioridade MEDIUM ou HIGH para a consulta. As consultas que usam a prioridade ALTA consomem mais recursos e podem recuperar resultados mais rapidamente.

Nível de log

Cada mensagem de log é associada a um nível de severidade que indica a importância e a urgência do log.

Um nível de log pode ter valores que variam do impacto mais baixo ao mais alto. A tabela a seguir descreve os níveis de log em ordem decrescente de seu impacto.

Nível de Log	Descrição
PARAR	Registra sem informações. Isso tem o menor impacto.
ERRO	Registra eventos que podem exigir ações corretivas, por exemplo, um componente está indisponível.
ADVERTÊNCIA	Registra problemas que podem levar a um erro ou exigir ações corretivas no futuro. Este é o nível de log padrão.
INFORMAÇÕES	Registros concluídos ou o estado atual de um componente, por exemplo, o componente está sendo inicializado.
VERBO	Exibe informações detalhadas de processamento, incluindo erros, avisos e informações. Isso tem o maior impacto.

Cada nível é cumulativo, ou seja, contém todos os dados gerados pelos níveis inferiores. Por exemplo, um log de Advertência contém todos os dados gerados pelos logs de Erro, incluindo os eventos específicos da categoria Erro.

Formato da Mensagem de Log

As Configurações de Log gravam uma mensagem no arquivo de log especificado. Um arquivo de log contém informações, como módulo, Timestamp, Severidade, Nome do Servidor, Conexão e Mensagem, juntamente com um rastreamento de pilha, se houver. Cada atributo é especificado entre chaves.

Veja a seguir um exemplo de um arquivo de log do servidor.

{
  "module": "ServerHelper",
  "logMessage": "New settings saved",
  "timestamp": 1688901058020,
  "level": 3,
  "payload": {
    "conAlias": "Excel Connection",
    "status": 400
  },
  "id": 161,
  "timeString": "19 Jun 20XX 16:40:58"
},
{
  "module": "ServerHelper",
  "logMessage": "serverRequest - success",
  "timestamp": 1688901059724,
  "level": 3
}

Horas para manter o log

Você pode definir o limite de tempo para armazenar as informações de log em arquivos de log. Os logs anteriores ao valor especificado neste campo serão automaticamente apagados. O valor padrão é 12 horas. Isso significa que os registros com mais de 12 horas são excluídos.

Limpar log

Esta opção exclui todos os logs.

Log de exportação

Você pode exportar o log para salvar as informações em um arquivo no formato JSON. No Windows, a opção de exportação salva o arquivo de log diretamente em uma pasta, por exemplo, Downloads. No Mac, as informações de log são copiadas para a área de transferência. Você pode colá-lo em um arquivo e salvar o log.

Os logs são armazenados localmente no sistema no qual o add-in está sendo executado. Eles não residem em um servidor ou em qualquer local remoto.

Você pode então compartilhar o arquivo de log com a equipe de suporte para diagnosticar e solucionar erros.

Observação:

O arquivo de log JSON pode conter informações pessoais ou dados confidenciais. Certifique-se de proteger qualquer informação confidencial antes de compartilhar o arquivo de log.

URL de Redirecionamento

Você pode usar a opção Copiar PL/SQL e criar uma conexão manualmente. Essa opção está disponível no Excel.