# Glossário

> Definições e convenções para termos de telemetria conforme usados no OpenTelemetry.

---

LLMS index: [llms.txt](/llms.txt)

---

Esse glossário define termos e [conceitos](/docs/concepts/) 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](#opentelemetry) e [OTel](#otel).

## Termos {#terms}

### Agregação {#aggregation}

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](#data-source) de uma
[Métrica](#metric).

### Amostragem {#sampling}

Um mecanismo para controlar a quantidade de dados exportados. Usado mais
comumente com a [Fonte de Dados](#data-source) de [Rastros](#trace). Consulte
[Amostragem][sampling].

### 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](#data-source).

### Aplicação {#application}

Um ou mais [Serviços](#service) destinados a usuários finais ou outras
aplicações.

### Aplicação lado do cliente {#client-side-app}

Um componente de uma [Aplicação](#application) 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 {#attribute}

Termo do OpenTelemetry para [Metadados](#metadata). Adiciona informações
chave-valor à entidade que está produzindo telemetria. Usado em
[Sinais](#signal) e [Recursos](#resource). Consulte a [especificação de
atributos][attribute].

### Backend de observabilidade {#observability-backend}

O componente de uma plataforma de observabilidade que é responsável por receber,
processar, armazenar e disponibilizar dados de telemetria. Exemplos incluem
ferramentas de código aberto como [Jaeger][] e [Prometheus][], bem como ofertas
comerciais. O OpenTelemetry não é um backend de observabilidade.

### Bagagem {#baggage}

Um mecanismo para propagar [Metadados](#metadata) para ajudar a estabelecer uma
relação casual entre eventos e serviços. Consulte as [especificações de
Bagagem][baggage].

### Biblioteca {#library}

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

### Biblioteca de cliente {#client-library}

Consulte a seção [Biblioteca instrumentada](#instrumented-library).

### Biblioteca de instrumentação {#instrumentation-library}

Indica a [Biblioteca](#library) que fornece a instrumentação para uma
determinada [Biblioteca instrumentada](#instrumented-library). A
[Biblioteca instrumentada](#instrumented-library) e a
[Biblioteca de instrumentação](#instrumentation-library) podem ser a mesma
[Biblioteca](#library) caso esta possua instrumentação OpenTelemetry
incorporada. Consulte [a especificação da biblioteca][spec-instrumentation-lib].

### Biblioteca instrumentada {#instrumented-library}

Indica a [Biblioteca](#library) para a qual os sinais telemétricos
([Rastros](#trace), [Métricas](#metric), [Logs](#log)) são coletados. Consulte
[Biblioteca instrumentada][instrumented library].

### Campo {#field}

Um termo utilizado especificamente por [Registros de Log](#log-record).
[Metadados](#metadata) podem ser adicionados por meio de campos definidos,
incluindo [Atributos](#attribute) e [Recursos](#resource). Outros campos também
podem ser considerados `Metadados`, incluindo severidade e informações de
rastreamento. Consulte a [especificação de campos][field].

### Cardinalidade {#cardinality}

O número de valores únicos para um determinado [Atributo](#attribute) ou
conjunto de atributos. Alta cardinalidade significa muitos valores únicos, o que
pode impactar o desempenho e os requisitos de armazenamento dos _backends_ de
telemetria. Por exemplo, um atributo `user_id` teria alta cardinalidade,
enquanto um atributo `status_code` com valores como "200", "404", "500" teria
baixa cardinalidade.

### 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".

[OpenTelemetry Collector]: /docs/collector/

### Contrib

Diversas [Bibliotecas Instrumentadas](#instrumentation-library) e o
[Collector](#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 {#semantic-conventions}

Define nomes e valores padrão de [Metadados](#metadata) para fornecer dados
telemétricos neutros em relação a fornecedores.

### DAG

[Grafos acíclicos dirigidos][dag].

### Dimensão {#dimension}

Termo utilizado especialmente por [Métricas](#metric). Consulte
[Atributo](#attribute).

### Distribuição {#distribution}

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

### Entidade {#entity}

Uma coleção de [atributos](#attribute) que identificam e descrevem um objeto
físico ou lógico. Entidades estão, normalmente, associadas à telemetria. Por
exemplo, uma entidade de CPU descreve uma CPU física, enquanto uma entidade de
serviço descreve um agrupamento lógico de processos que compõem um serviço HTTP
ou outro serviço.

### Especificação {#specification}

Descreve os requisitos e expectativas para implementações em todas as
linguagens. Consulte [Especificação][specification].

### Evento {#event}

Um Evento é um [Registro de Log](#log-record) com um nome de evento e uma
estrutura bem conhecida. Por exemplo, eventos de navegador no OpenTelemetry
seguem uma convenção de nomenclatura particular e carregam dados específicos em
uma estrutura comum.

### Exporter

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

### **Fonte de dados** {#data-source}

Veja [Sinal](#signal)

### Frontend de observabilidade {#observability-frontend}

O componente de uma plataforma de observabilidade que fornece interfaces de
usuário para visualizar e analisar dados de telemetria. Pode ser frequentemente
uma parte do _backend_ de observabilidade, especialmente ao considerar ofertas
comerciais.

### gRPC

Um framework [RPC](#rpc) de alta performance e open source. Consulte
[gRPC](https://grpc.io).

### HTTP

Abreviação para [Hypertext Transfer Protocol][http].

### Instrumentação automática {#automatic-instrumentation}

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][json].

### Linguagem

Linguagem de programação.

### Log

Às vezes usado para se referir a uma coleção de [Registros de Log](#log-record).
Pode ser ambíguo, uma vez que as pessoas também costumam usar [Log](#log) para
se referir a um único [Registro de Log](#log-record). Quando a ambiguidade é
possível, utilize qualificadores adicionais, por exemplo, `Registro de Log`.
Consulte [Log][].

### Metadados {#metadata}

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](#attribute). Além disso, as [Métricas](#metric) têm
[Dimensões](#dimension) e [Rótulos](#label), enquanto os [Logs](#log) têm
[Campos](#field).

### Métrica {#metric}

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

### OC

Abreviação para [OpenCensus](#opencensus).

### OpAMP

Abreviação para o
[Protocolo de Gerenciamento de Agentes Abertos _(Open Agent Management Protocol)_](/docs/collector/management/#opamp).

> **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](/docs/what-is-opentelemetry/#history).

### OpenTelemetry

Formado por meio de uma [fusão][] dos projetos [OpenTracing](#opentracing) e
[OpenCensus](#opencensus), o OpenTelemetry — o tema deste site — é
uma coleção de [APIs](#api), [SDKs](#sdk) e ferramentas que você pode utilizar
para [instrumentar](/docs/concepts/instrumentation/), gerar,
[coletar](/docs/concepts/components/#collector) e
[exportar](/docs/concepts/components/#exporters)
[dados de telemetria](/docs/concepts/signals/), como [métricas](#metric),
[logs](#log) e [rastros](#trace).

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

[fusão]: /docs/what-is-opentelemetry/#history

### OpenTracing

Precursor do OpenTelemetry. Para mais detalhes, consulte
[História](/docs/what-is-opentelemetry/#history).

### OT

Abreviação para [OpenTracing](#opentracing).

### **OTel**

Abreviação para [OpenTelemetry](/docs/what-is-opentelemetry/).

> **Ortografia**: Escreva OTel, e não `OTEL`.

### OTelCol

Abreviação para [OpenTelemetry Collector](#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.

[Proposta de Melhoria do OpenTelemetry _(OpenTelemetry Enhancement Proposal)_]:
  https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/README.md

### OTLP

Abreviação para [OpenTelemetry Protocol](/docs/specs/otlp/).

### Propagação de Contexto {#context-propagation}

Permite que todas as [Fontes de dados](#data-source) compartilhem um mecanismo
subjacente de contexto para armazenar um estado e acessar dados ao longo do
ciclo de vida de uma [Transação](#transaction). Consulte a [especificação de
propagação de contexto][context propagation].

### Propagators

Usado para serializar e desserializar partes específicas de dados telemétricos,
como contexto de span e [bagagem](#baggage) em [Spans](#span). Consulte
[Propagators][].

### Proto

Tipos de interface independentes de linguagem. Consulte [opentelemetry-proto][].

### Rastro {#trace}

Um [DAG](#dag) de [Trechos](#span), onde os limites entre os [Trechos](#span)
são definidos como uma relação de pai-filho. Consulte [Rastro][traces].

### Rastro distribuído {#distributed-tracing}

Acompanha a progressão de uma única [Requisição](#request), chamada de
[Rastro](#trace), conforme é processada pelos [Serviços](#service) que compõem
uma [Aplicação](#application). Um [Rastro distribuído](#distributed-tracing)
atravessa limites de processo, rede e segurança.

Consulte [Rastreamento distribuído][distributed tracing].

### Receiver

Termo utilizado pelo [Collector](/docs/collector/configuration/#receivers) para
definir como os dados telemétricos são recebidos. Receivers podem ser push-based
ou pull-based. Consulte [Receiver][].

### Recurso {#resource}

Uma coleção de [entidades](#entity) ou [atributos](#attribute) que identificam
ou descrevem um objeto físico ou lógico que produz telemetria.

### Registro de log {#log-record}

Uma gravação de dados com o carimbo de data/hora e uma severidade. Também pode
possuir um [ID de Rastro](#trace) e um [ID de Trecho](#span), quando
correlacionado com um rastro. Consulte [Registro de log][log record].

### REST

Abreviação para [Representational State Transfer][rest].

### Requisição {#request}

Veja [Rastro distribuído](#distributed-tracing).

### Rótulo {#label}

Um termo utilizado especificamente por [Métricas](#metric). Veja
[Metadados](#metadata).

### RPC

Abreviação para [Remote Procedure Call][rpc].

### SDK

Abreviação para Software Development Kit. Refere-se a um SDK de telemetria que
indica uma [Biblioteca](#library) que implementa a [API](#api) do OpenTelemetry.

### Serviço {#service}

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

### Sinal {#signal}

Um dos [Rastros](#trace), [Métricas](#metric) ou [Logs](#log). Consulte
[Sinais][signals].

### Span link

Um span link é uma conexão entre spans relacionados casualmente. Para detalhes,
consulte [Links entre spans](/docs/specs/otel/overview#links-between-spans) e
[Especificando Links](/docs/specs/otel/trace/api#specifying-links).

### Status

O resultado de uma operação. Normalmente usado para indicar se ocorreu um erro.
Consulte [Status][].

### Tag

Consulte [Metadados](#metadata).

### Tracer {#tracer}

Responsável pela criação de [Trecho](#span). Consulte [Tracer][].

### Transação {#transaction}

Consulte [Rastro distribuído](#distributed-tracing).

### Trecho {#span}

Representa uma única operação dentro de um [Rastro](#trace). Consulte
[Trecho][span].

### 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 [zPages][].

[attribute]: /docs/specs/otel/common/#attributes
[baggage]: /docs/specs/otel/baggage/api/
[context propagation]: /docs/specs/otel/overview#context-propagation
[dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph
[distributed tracing]: ../signals/traces/
[distributions]: ../distributions/
[field]: /docs/specs/otel/logs/data-model#field-kinds
[http]: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
[instrumented library]: /docs/specs/otel/glossary/#instrumented-library
[Jaeger]: https://www.jaegertracing.io/
[json]: https://en.wikipedia.org/wiki/JSON
[log]: /docs/specs/otel/glossary#log
[log record]: /docs/specs/otel/glossary#log-record
[metric]: ../signals/metrics/
[opentelemetry-proto]: https://github.com/open-telemetry/opentelemetry-proto
[propagators]: /docs/languages/go/instrumentation/#propagators-and-context
[Prometheus]: https://prometheus.io/
[receiver]: /docs/collector/configuration/#receivers
[rest]: https://en.wikipedia.org/wiki/Representational_state_transfer
[rpc]: https://en.wikipedia.org/wiki/Remote_procedure_call
[sampling]: /docs/specs/otel/trace/sdk#sampling
[signals]: ../signals/
[span]: /docs/specs/otel/trace/api#span
[spec-instrumentation-lib]: /docs/specs/otel/glossary/#instrumentation-library
[specification]: ../components/#specification
[status]: /docs/specs/otel/trace/api#set-status
[tracer]: /docs/specs/otel/trace/api#tracer
[traces]: /docs/specs/otel/overview#traces
[zpages]:
  https://github.com/open-telemetry/opentelemetry-specification/blob/main/development/trace/zpages.md