Traçado manual
Embora o rastreamento automático do MLflow ofereça observabilidade instantânea para as estruturas compatíveis, o rastreamento manual oferece controle total sobre como os aplicativos GenAI são instrumentados. Essa flexibilidade é essencial para a criação de aplicativos prontos para produção que exigem recursos detalhados de monitoramento e depuração.
Quando usar o rastreamento manual
O rastreamento manual é a escolha certa quando você precisa:
Controle preciso sobre a estrutura dos traços
- Defina exatamente quais partes do seu código devem ser rastreadas
- Crie hierarquias personalizadas de extensões
- O controle abrange limites e relacionamentos
Instrumentação de estrutura personalizada
- Estruturas proprietárias ou internas do instrumento
- Adicionar rastreamento aos wrappers LLM personalizados
- Suporte à nova biblioteca antes da integração oficial
Cenários de fluxo de trabalho avançados
- Operações multi-threaded ou assíncronas
- transmissão de respostas com agregação personalizada
- Operações aninhadas complexas
- Metadados e atributos de rastreamento personalizados
Qual API devo usar?
Escolha a abordagem de decalque manual mais adequada às suas necessidades:
Recurso | |||
|---|---|---|---|
Caso de uso | Trace funções inteiras com um decorador de uma linha. São necessárias alterações mínimas no código. | Rastreie blocos de código arbitrários dentro de funções para um controle preciso. | Controle direto sobre o ciclo de vida do rastreamento em cenários complexos. |
Pai-filho automático | Sim | Sim | Não - gerenciamento manual |
Tratamento de exceções | Automático | Automático | Manual |
Funciona com rastreamento automático | Sim | Sim | Não |
Segurança da rosca | Automático | Automático | Manual |
IDs de rastreamento personalizados | Não | Não | Sim |