Digite para filtrar os verbetes do Glossário.

    DevOps e infraestrutura · Formação DevOps

    Trace distribuído

    Trace distribuído é o registro do percurso de uma operação entre componentes, organizado em spans com duração e relação.

    Também chamado de: distributed trace, rastreamento distribuído

    Definição

    Trace distribuído é o registro do percurso de uma operação entre componentes, geralmente organizado em spans. Cada span representa uma parte do trabalho, com duração e relação com as demais.

    Spans e relação

    O trace mostra como uma operação atravessa componentes, como uma API, uma consulta ao banco e uma chamada externa. Os spans registram a duração de cada parte e a sequência entre elas, e a relação entre os spans indica qual parte chamou a próxima.

    O trace acompanha o percurso de uma operaçãoA operação parte de um componente, atravessa o contrato e chega a outro componente, com spans registrando cada trecho.Sistema AContrato da APISistema B
    A operação parte de um componente, atravessa o contrato e chega a outro componente, com spans registrando cada trecho.

    Trace e log

    Trace não é apenas uma lista de logs, pois ele mostra relações e tempos de uma operação instrumentada. Logs registram eventos avulsos, enquanto o trace reconstrói o percurso completo da operação.

    Falha provável e verificação

    A falha mais comum é o trace sem a referência da operação. Quando cada componente registra o próprio span sem compartilhar o identificador do percurso, você não consegue montar a linha do tempo e volta à busca manual. Para verificar, você instrumenta a operação, segue o identificador compartilhado entre os componentes e confere se os spans aparecem encadeados com as durações esperadas. A verificação termina quando um percurso completo pode ser lido de ponta a ponta.

    Veja a definição de observabilidade

    Dúvidas frequentes

    Perguntas frequentes sobre Trace distribuído

    Trace é uma lista de logs?
    Não. O trace mostra relações e tempos de uma operação instrumentada, enquanto o log registra eventos avulsos.
    O que é um span?
    Um span é uma parte do trabalho de uma operação, com duração e relação com outros spans, como a chamada a uma API ou a uma consulta ao banco.
    Como o trace ajuda numa lentidão?
    O percurso mostra qual componente demorou, por quanto tempo e como as partes se relacionam dentro da operação.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Formação DevOps

    Na Formação DevOps, o trace distribuído acompanha o percurso de uma operação pelos componentes.

    Conhecer a formação
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva.

    R$ 2.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva (segunda a sexta)
    • War Rooms às segundas, quartas e sextas
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano