Rastrear uma chamada de ferramenta de ponta a ponta
Acompanhe uma solicitação por toda a pilha.
Rastrear uma chamada de ferramenta de ponta a ponta é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Acompanhando uma chamada
Uma única chamada de ferramenta pode acessar seu servidor, um banco de dados e uma API. O rastreamento reúne essas etapas em uma única linha do tempo, para que você veja toda a jornada. 🧵
Rastreamentos e intervalos
Um rastreamento é a solicitação completa; um intervalo é uma etapa dentro dele. Cada intervalo registra um nome, um início e uma duração, e os intervalos se aninham como uma árvore.
O ID do rastreamento
Todos os intervalos de uma solicitação compartilham um único ID de rastreamento. É esse ID compartilhado que permite a uma ferramenta reconstruir exatamente quais etapas pertenciam umas às outras.
Intervalos pai e filho
Os intervalos se conectam por meio de um ID pai. A chamada da ferramenta é o pai; a consulta ao banco de dados e a chamada à API tornam-se seus filhos, formando a árvore da linha do tempo.
OpenTelemetry
O padrão para isso em Python é o OpenTelemetry. Ele define rastreamentos, intervalos e contexto, para que seus dados funcionem com vários sistemas de back-end, e não apenas com um.
Inicie um intervalo
Você envolve o trabalho em um intervalo usando um gerenciador de contexto. Tudo dentro dele é cronometrado e aninhado automaticamente no rastreamento atual.
from opentelemetry import trace
tracer = trace.get_tracer("mcp")
with tracer.start_as_current_span("search_tool"):
run_search()Adicione atributos
Enriqueça um intervalo com atributos: pequenos fatos no formato chave-valor, como o nome da ferramenta ou a quantidade de resultados. Eles tornam um rastreamento muito mais fácil de ler depois.
span = trace.get_current_span()
span.set_attribute("tool.name", "search")
span.set_attribute("result.count", 3)Os intervalos capturam erros
Quando uma etapa falhar, marque seu intervalo com o status de erro. Assim, o rastreamento mostra exatamente qual etapa interrompeu a solicitação, e não apenas que ela falhou.
Propagação de contexto
Para rastrear uma chamada pela rede, passe o contexto do rastreamento nos cabeçalhos. Essa propagação mantém a etapa remota no mesmo rastreamento.
Vincule registros a rastreamentos
Inclua também o ID do rastreamento nos seus registros estruturados. Agora, uma linha de registro e seu rastreamento completo apontam um para o outro, e a depuração fica muito mais rápida.
Exportando rastreamentos
Os intervalos são enviados a um sistema de back-end por meio de um exportador, geralmente usando o protocolo OTLP. Em seguida, o sistema de back-end desenha a linha do tempo que você pode explorar.
Verificação rápida
Vamos confirmar a estrutura do rastreamento.
Recapitulação
Agora você pode rastrear uma chamada de ponta a ponta com intervalos sob um único ID de rastreamento, enriquecidos com atributos, status de erro e registros que levam diretamente de volta ao rastreamento. 🗺️
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Rastrear uma chamada de ferramenta de ponta a ponta” é grátis?
Sim — o texto completo de “Rastrear uma chamada de ferramenta de ponta a ponta” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Rastrear uma chamada de ferramenta de ponta a ponta”?
Acompanhe uma solicitação por toda a pilha. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Rastrear uma chamada de ferramenta de ponta a ponta”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O que medir em um servidor
- Registros estruturados que você pode pesquisar
- Rastrear uma chamada de ferramenta de ponta a ponta
- Alertar sobre falhas e abusos