Entendendo o log de webui aberto 🪵
O registro é essencial para a depuração, monitoramento e compreensão de como o WebUI aberto está se comportando. Este guia explica como o registro funciona em amboscliente do navegador(front -end) e oservidor de aplicativos/back -end
🖥️ Logging do cliente do navegador (front -end)
Para desenvolvimento de front -end e depuração, o Nullcore utiliza o registro padrão do console do navegador. Isso significa que você pode ver logs diretamente nas ferramentas de desenvolvedor interno do seu navegador da web.
Como acessar logs do navegador:
-
Ferramentas de desenvolvedor aberto:Na maioria dos navegadores, você pode abrir ferramentas de desenvolvedor por:
- Clique com o botão direito do mouseEm qualquer lugar da página Nullcore e selecionando "Inspecione" ou "Inspecione o elemento".
- PressionandoF12(ou cmd+opt+i no macOS).
-
Navegue até a guia "Console":No painel Ferramentas do desenvolvedor, encontre e clique na guia "Console".
Tipos de logs do navegador:
Nullcore usa principalmenteJavaScript console.log()para log do lado do cliente. Você verá vários tipos de mensagens no console, incluindo:
- Mensagens informativas:Fluxo e status de aplicação geral.
- AVISOS:Questões potenciais ou erros não críticos.
- Erros:Problemas que podem estar afetando a funcionalidade.
Ferramentas de desenvolvedor específicas do navegador:
Diferentes navegadores oferecem ferramentas de desenvolvedor ligeiramente diferentes, mas todas fornecem um console para visualizar logs JavaScript. Aqui estão links para documentação para navegadores populares:
- [Blink] Chrome/Chromium (por exemplo, Chrome, Edge): Documentação do Chrome Devtools
- [Gecko] Firefox: Documentação de ferramentas de desenvolvedor do Firefox
- [Webkit] Safari: Documentação de ferramentas de desenvolvedor Safari
⚙️ Servidor de aplicativos/log -end (Python)
O back-end do aberto webui usaloggingmódulo para registrar eventos e informações no lado do servidor. Esses logs são cruciais para entender o comportamento do servidor, diagnosticar erros e monitorar o desempenho.
Conceitos -chave:
- Python
loggingMódulo:Nullcore aproveita o Python padrãologgingbiblioteca. Se você estiver familiarizado com o registro do Python, encontrará esta seção direta. (Para informações mais detalhadas, consulte oDocumentação de log de Python - Saída do console:Por padrão, os logs de back -end são enviados para o console (saída padrão), tornando -os visíveis nos logs de contêiner de terminal ou docker.
- Níveis de registro:Os níveis de registro controlam a verbosidade dos logs. Você pode configurar o Nullcore para mostrar informações mais ou menos detalhadas com base nesses níveis.
🚦 Níveis de registro explicados
O Python Logging usa uma hierarquia de níveis para categorizar mensagens de log por gravidade. Aqui está um colapso dos níveis, da maioria a menos severa:
| Nível | Valor numérico | Descrição | Caso de uso |
|---|---|---|---|
CRITICAL | 50 | Erros gravesIsso pode levar ao término do aplicativo. | Falhas catastróficas, corrupção de dados. |
ERROR | 40 | ErrosIsso indica problemas, mas o aplicativo ainda pode funcionar. | Erros recuperáveis, operações com falha. |
WARNING | 30 | Questões potenciaisou situações inesperadas que devem ser investigadas. | Avisos de depreciação, restrições de recursos. |
INFO | 20 | Mensagens informativas geraissobre operação de aplicação. | Mensagens de inicialização, eventos -chave, fluxo de operação normal. |
DEBUG | 10 | Informações detalhadas de depuraçãopara desenvolvedores. | Chamadas de função, valores variáveis, etapas detalhadas de execução. |
NOTSET | 0 | Todas as mensagens são registradas.(Geralmente padroniza paraWARNINGse não estiver definido). | Útil para capturar absolutamente tudo, normalmente para depuração muito específica. |
Nível padrão:O nível de registro padrão do Webui éINFO
🌍 Nível de registro global (GLOBAL_LOG_LEVEL
Você pode mudar oglobalnível de registro para todo o back -end do webui aberto usando oGLOBAL_LOG_LEVELvariável de ambiente. Esta é a maneira mais direta de controlar a verbosidade geral do log.
Como funciona:
ContextoGLOBAL_LOG_LEVELConfigura o madeireiro de raiz em Python, afetando todos os madeireiros em webui aberto e potencialmente algumas bibliotecas de terceiros que usamBasicConfig. Ele usalogging.basicConfig(force=True), o que significa que ele substituirá qualquer configuração de logger de raiz existente.
Exemplo: Configuração paraDEBUG
-
Parâmetro Docker:
--env global_log_level = "Debug" -
Docker Compose (
docker-compose.ymlambiente
Global_log_level = Debug
Impacto:ContextoGLOBAL_LOG_LEVELparaDEBUGproduzirá os logs mais detalhados, incluindo informações detalhadas que são úteis para o desenvolvimento e a solução de problemas. Para ambientes de produção,INFOouWARNINGPode ser mais apropriado para reduzir o volume de log.
⚙️ Níveis de registro específicos do aplicativo/back -end
Para um controle mais granular, o Nullcore fornece variáveis de ambiente para definir níveis de log para componentes de back -end específicos. O registro é um trabalho em andamento em andamento, mas algum nível de controle é disponibilizado usando essas variáveis de ambiente. Essas variáveis permitem que você ajuste o registro para diferentes partes do aplicativo.
Variáveis de ambiente disponíveis:
| Variável de ambiente | Componente/módulo | Descrição |
|---|---|---|
AUDIO_LOG_LEVEL | Processamento de áudio | Registro relacionado à transcrição de áudio (mais rápido), text-to-fala (TTS) e manuseio de áudio. |
COMFYUI_LOG_LEVEL | Integração Comfyui | Registro para interações com a Comfyui, se você estiver usando essa integração. |
CONFIG_LOG_LEVEL | Gerenciamento de configuração | Registro relacionado ao carregamento e processamento de arquivos de configuração do WebUI. |
DB_LOG_LEVEL | Operações de banco de dados (Peewee) | Registro para interações de banco de dados usando o Peewee ORM (Mapper Relacional de Objetos). |
IMAGES_LOG_LEVEL | Geração de imagens (Automatic1111/Difusão estável) | Registro para tarefas de geração de imagens, especialmente ao usar a integração de difusão estável do Automatic1111. |
MAIN_LOG_LEVEL | Execução do aplicativo principal (Raiz Logger) | Log do ponto de entrada principal do aplicativo e logger de root. |
MODELS_LOG_LEVEL | Gerenciamento de modelos | Registro relacionado ao carregamento, gerenciamento e interação com modelos de idiomas (LLMS), incluindo autenticação. |
OLLAMA_LOG_LEVEL | Integração de back -end de Ollama | Registro para comunicação e interação com o back -end do ollama. |
OPENAI_LOG_LEVEL | Integração da API OpenAI | Registro para interações com a API OpenAI (por exemplo, para modelos como GPT). |
RAG_LOG_LEVEL | Geração de recuperação usededed (RAG) | Registro para o pipeline RAG, incluindo o banco de dados do Chroma Vector e os transformadores de sentenças. |
WEBHOOK_LOG_LEVEL | Webhook de autenticação | Loging estendido para funcionalidade de Webhook de autenticação. |
Como usar:
Você pode definir essas variáveis de ambiente da mesma maneira queGLOBAL_LOG_LEVEL(Parâmetros do Docker, Docker Composeenvironmentseção). Por exemplo, para obter um registro mais detalhado para as interações ollama, você pode definir:
ambiente
Ollama_log_level = Debug
Nota importante:DiferenteGLOBAL_LOG_LEVEL, essas variáveis específicas do aplicativo podem não afetar o registro detodosMódulos de terceiros. Eles controlam principalmente o registro na base de código do Nullcore.
Ao entender e utilizar esses mecanismos de registro, você pode monitorar, depurar e obter informações efetivamente sobre sua instância aberta da Webui.