Conceitos de Mapeamentos do Open Telemetry

Mapeamentos de componentes

Um OtelComponentMapping descreve como um componente de topologia é criado (ou atualizado) a partir de dados do OpenTelemetry.

Exemplos típicos de componentes criados a partir do OpenTelemetry incluem (estes fazem parte do StackPack padrão do OpenTelemetry):

  • Serviços (derivados de service.name / service.namespace)

  • Instâncias de serviço (derivadas de service.instance.id)

  • Bancos de Dados

  • Hosts e recursos do Kubernetes (nós, namespaces, pods)

  • Funções e tarefas em ambientes serverless ou de batch

Mapeamentos de relações

Um OtelRelationMapping descreve como uma relação entre dois componentes é criada a partir de dados do OpenTelemetry.

Exemplos comuns de relações incluem (estes fazem parte do StackPack padrão do OpenTelemetry):

  • Chamadas de serviço síncronas (cliente → servidor)

  • Fluxos de mensagens assíncronas (produtor → consumidor, consumidor → par, produtor → par)

  • Conexões de serviço para banco de dados

  • Instância de serviço fornecida pelo serviço

  • Relações de execução (serviço ou função executa tarefa, host ou função)

Expressões e a Linguagem Comum de Expressão (CEL)

Mapeamentos de topologia dependem da Linguagem Comum de Expressão (CEL) para selecionar telemetria, extrair valores e construir campos de componente e relação.

Você não precisa de experiência prévia em CEL para começar - a maioria das expressões são verificações booleanas simples, buscas de atributos ou construções de strings. Expressões mais avançadas podem ser introduzidas gradualmente conforme necessário.

Para mais informações sobre como aproveitar o CEL nos mapeamentos de topologia, consulte a página schemas.