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

Pré-requisitos

MLflow 3

Esta página requer o seguinte pacote:

• mlflow[databricks]> =3.1: Funcionalidade principal do MLflow com recurso GenAI e conectividade Databricks.
• openai > =1.0.0 : (Opcional) Somente se seu código personalizado interagir com o OpenAI; substitua por outros SDKs, se necessário.

Instale os requisitos básicos:

Python

%pip install --upgrade "mlflow[databricks]>=3.1"
# %pip install --upgrade openai>=1.0.0 # Install if needed

MLflow 2.x

Este guia requer o seguinte pacote:

• mlflow [blocos de dados] > =2.15.0 ,\ < 3.0.0: Funcionalidade principal do MLflow com conectividade Databricks.
• openai > =1.0.0 : (Opcional) Somente se seu código personalizado interagir com o OpenAI.

nota

Versão MLflow

A Databricks recomenda fortemente a instalação do MLflow 3.1 ou mais recente se estiver usando mlflow[databricks].

Instale os requisitos básicos:

Python

%pip install --upgrade "mlflow[databricks]>=2.15.0,<3.0.0"
# pip install --upgrade openai>=1.0.0 # Install if needed

Qual API devo usar?

Escolha a abordagem de decalque manual mais adequada às suas necessidades:

Recurso	decoradores funcionais	Rastreamento de extensão	APIs de baixo nível
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