Glossário

Esse glossário define termos e conceitos que são novos no projeto do OpenTelemetry e esclarece os usos de termos específicos do OpenTelemetry, comuns no universo de observabilidade.

Também comentamos sobre ortografia e capitalização, quando útil. Por exemplo, consulte OpenTelemetry e OTel.

Termos

Agregação

O processo de combinar múltiplas medições em estatísticas exatas ou estimadas sobre as medições que aconteceram durante um intervalo de tempo, durante a execução do programa. Utilizado pela Fonte de Dados de uma Métrica.

Amostragem

Um mecanismo para controlar a quantidade de dados exportados. Usado mais comumente com a Fonte de Dados de Rastros. Consulte mais informações.

API

Interface de Programação de Aplicações (Application Programming Interface). No projeto OpenTelemetry, é utilizada para definir como os dados de telemetria são gerados pela Fonte de Dados.

Aplicação

Um ou mais Serviços destinados a usuários finais ou outras aplicações.

Aplicação lado do cliente

Um componente de uma Aplicação que não está sendo executado dentro de uma infraestrutura privada e é normalmente usado diretamente por usuários finais. Exemplos de aplicações client-side incluem aplicativos de navegador, aplicativos móveis e aplicativos executados em dispositivos IoT.

APM

O Monitoramento de Desempenho de Aplicações (Application Performance Monitoring) envolve monitorar aplicações de software, sua performance (velocidade, confiabilidade, disponibilidade, etc.) para detectar problemas, alertar e fornecer ferramentas que permitam encontrar a causa raiz.

Atributo

Termo do OpenTelemetry para Metadados. Adiciona informações chave-valor à entidade que está produzindo telemetria. Usado em Sinais e Recursos. Consulte a especificação de atributos.

Bagagem

Um mecanismo para propagar Metadados para ajudar a estabelecer uma relação casual entre eventos e serviços. Consulte as especificações de Bagagem.

Biblioteca

Uma coleção específica da linguagem com comportamento invocado por uma interface.

Biblioteca de cliente

Consulte a seção Biblioteca instrumentada.

Biblioteca de instrumentação

Indica a Biblioteca que fornece a instrumentação para uma determinada Biblioteca instrumentada. A Biblioteca instrumentada e a Biblioteca de instrumentação podem ser a mesma Biblioteca caso esta possua instrumentação OpenTelemetry incorporada. Consulte a especificação da biblioteca.

Biblioteca instrumentada

Indica a Biblioteca para a qual os sinais telemétricos (Rastros, Métricas, Logs) são coletados. Consulte mais informações.

Campo

Um termo utilizado especificamente por Registros de Log. Metadados podem ser adicionados por meio de campos definidos, incluindo Atributos e Recursos. Outros campos também podem ser considerados Metadados, incluindo severidade e informações de rastreamento. Consulte a especificação de campos.

Collector

O OpenTelemetry Collector, ou simplesmente Collector, é uma implementação neutra em relação a fornecedores sobre como receber, processar e exportar dados de telemetria. Um único binário que pode ser implementado como um agente ou gateway.

Ortografia: Ao referir-se ao OpenTelemetry Collector, sempre capitalize a palavra “Collector”. Utilize apenas o termo “Collector” caso esteja utilizando Collector como um adjetivo — por exemplo, “Configuração do Collector”.

Contrib

Diversas Bibliotecas Instrumentadas e o Collector oferecem um conjunto de funcionalidades principais, assim como um repositório contrib dedicado para funcionalidades não essenciais, incluindo Exporters de fornecedores.

Convenções semânticas

Define nomes e valores padrão de Metadados para fornecer dados telemétricos neutros em relação a fornecedores.

DAG

Grafos acíclicos dirigidos.

Dimensão

Termo utilizado especialmente por Métricas. Consulte Atributo.

Distribuição

Uma distribuição é um encapsulamento em torno de um repositório upstream do OpenTelemetry com algumas personalizações. Consulte mais detalhes.

Especificação

Descreve os requisitos e expectativas para implementações em todas as linguagens. Consulte mais informações.

Evento

Algo que aconteceu cuja representação depende da Fonte de dados. Por exemplo, Trecho.

Exporter

Fornece funcionalidades para emitir dados telemétricos aos consumidores. Exporters podem ser push-based ou pull-based.

Fonte de dados

Veja Sinal

gRPC

Um framework RPC de alta performance e open source. Mais sobre gRPC aqui.

HTTP

Abreviação para Hypertext Transfer Protocol.

Instrumentação automática

Refere-se a métodos de coleta de telemetria que não exigem que o usuário final modifique o código-fonte da aplicação. Os métodos variam conforme a linguagem de programação e os exemplos incluem injeção de bytecode ou monkey patching.

JSON

Abreviação para JavaScript Object Notation.

Linguagem

Linguagem de programação.

Log

Às vezes usado para se referir a uma coleção de Registros de Log. Pode ser ambíguo, uma vez que as pessoas também costumam usar Log para se referir a um único Registro de Log. Quando a ambiguidade é possível, utilize qualificadores adicionais, por exemplo, Registro de Log. Consulte mais informações.

Metadados

Um par de chave-valor, por exemplo, foo="bar", adicionado a uma entidade que produz dados telemétricos. O OpenTelemetry chama esses pares de Atributos. Além disso, as Métricas têm Dimensões e Rótulos, enquanto os Logs têm Campos.

Métrica

Registra um ponto de dados, seja medições brutas ou agregações pré-definidas, como séries temporais com Metadados. Consulte mais informações.

OC

Abreviação para OpenCensus.

OpAMP

Abreviação para o Protocolo de Gerenciamento de Agentes Abertos (Open Agent Management Protocol).

Ortografia: Escreva OpAMP, e não OPAMP ou opamp em descrições ou instruções.

OpenCensus

Precursor do OpenTelemetry. Para mais detalhes, consulte História.

OpenTelemetry

Formado por meio de uma fusão dos projetos OpenTracing e OpenCensus, o OpenTelemetry — o tema deste site — é uma coleção de APIs, SDKs e ferramentas que você pode utilizar para instrumentar, gerar, coletar e exportar dados de telemetria, como métricas, logs e rastros.

Ortografia: OpenTelemetry deve ser sempre uma única palavra, sem hífen, e capitalizada como mostrado.

OpenTracing

Precursor do OpenTelemetry. Para mais detalhes, consulte História.

OT

Abreviação para OpenTracing.

OTel

Abreviação para OpenTelemetry.

Ortografia: Escreva OTel, e não OTEL.

OTelCol

Abreviação para OpenTelemetry Collector.

OTEP

Um acrônimo para Proposta de Melhoria do OpenTelemetry (OpenTelemetry Enhancement Proposal).

Spelling: Escreva “OTEPs” como um plural. Não escreva OTep ou otep em descrições.

OTLP

Abreviação para OpenTelemetry Protocol.

Propagação de Contexto

Permite que todas as Fontes de dados compartilhem um mecanismo subjacente de contexto para armazenar um estado e acessar dados ao longo do ciclo de vida de uma Transação. Consulte a especificação de propagação de contexto.

Propagators

Usado para serializar e desserializar partes específicas de dados telemétricos, como contexto de span e bagagem em Spans. Consulte mais informações.

Proto

Tipos de interface independentes de linguagem. Consulte mais informações.

Rastreador

Responsável pela criação de Trecho. Consulte mais informações.

Rastro

Um DAG de Trechos, onde os limites entre os Trechos são definidos como uma relação de pai-filho. Consulte mais informações.

Rastro distribuído

Acompanha a progressão de uma única Requisição, chamada de Rastro, conforme é processada pelos Serviços que compõem uma Aplicação. Um Rastro distribuído atravessa limites de processo, rede e segurança.

Consulte Rastreamento distribuído.

Receiver

Termo utilizado pelo Collector para definir como os dados telemétricos são recebidos. Receivers podem ser push-based ou pull-based. Consulte mais informações.

Recurso

Captura informações sobre a entidade que produz dados telemétricos como Atributos. Por exemplo, um processo que gera telemetria e está sendo executado em um contêiner no Kubernetes possui um nome de processo, um nome de pod, um namespace e, possivelmente, um nome de deployment. Todos esses atributos podem ser incluídos no Recurso.

Registro de log

Uma gravação de um Evento. Normalmente, o registro inclui um carimbo de data/hora indicando quando o Evento ocorreu, além de outros dados que descrevem o que aconteceu, onde aconteceu, e assim por diante. Consulte mais informações.

REST

Abreviação para Representational State Transfer.

Requisição

Veja Rastro distribuído.

Rótulo

Um termo utilizado especificamente por Métricas. Veja Metadados.

RPC

Abreviação para Remote Procedure Call.

SDK

Abreviação para Software Development Kit. Refere-se a um SDK de telemetria que indica uma Biblioteca que implementa a API do OpenTelemetry.

Serviço

Um componente de uma Aplicação. Múltiplas instâncias de um Serviço são tipicamente implantadas para que tenham alta disponibilidade e escalabilidade. Um Serviço pode ser implantado em múltiplas localizações.

Sinal

Um dos Rastros, Métricas ou Logs. Mais sobre Sinais aqui.

Span link

Um span link é uma conexão entre spans relacionados casualmente. Para detalhes, consulte Links entre spans e Especificando Links.

Status

O resultado de uma operação. Normalmente usado para indicar se ocorreu um erro. Consulte mais informações.

Tag

Consulte Metadados.

Transação

Consulte Rastro distribuído.

Trecho

Representa uma única operação dentro de um Rastro. Consulte mais detalhes aqui.

zPages

Uma alternativa interna aos exportadores externos. Quando incluídos, eles coletam e agregam informações de rastros e métricas em segundo plano; estes dados são exibidos em páginas da web quando solicitados. Consulte mais informações.