Skip to content

Commit

Permalink
[pt] Add translations for /pt/docs/concepts/glossary (#5183)
Browse files Browse the repository at this point in the history
Co-authored-by: Marylia Gutierrez <[email protected]>
Co-authored-by: Ezzio Moreira <[email protected]>
Co-authored-by: Emídio Neto <[email protected]>
  • Loading branch information
4 people authored Oct 10, 2024
1 parent 5e2a0b4 commit c5c1d02
Show file tree
Hide file tree
Showing 2 changed files with 389 additions and 1 deletion.
3 changes: 2 additions & 1 deletion .cspell/pt-palavras.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
desserializa
desserializar
autoinstrumentação
autoconsistentes
serialização
verbosidade
verbosidade
387 changes: 387 additions & 0 deletions content/pt/docs/concepts/glossary.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,387 @@
---
title: Glossário
description: >-
Terminologias utilizadas pelo projeto OpenTelemetry que você pode ou não estar
familiarizado.
weight: 200
default_lang_commit: 926e23631291ed0ba85563cdaf344a134d0edd8d
---

O projeto OpenTelemetry usa terminologias que você talvez não conheça. Além
disso, o projeto também define algumas terminologias de uma maneira diferente de
outros lugares. Esta página reúne as terminologias utilizadas no projeto e seus
respectivos significados.

## Terminologia Genérica {#generic-terminology}

### **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
[mais informações][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].

### **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
[mais informações][spec-instrumented-lib].

### **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].

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

Também conhecido como OpenTelemetry Collector. Mais detalhes sobre o Collector
podem ser encontrados [aqui][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 [mais
detalhes][distribution].

### **Especificação** {#specification}

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

### **Evento** {#event}

Algo que aconteceu cuja representação depende da [Fonte de dados](#data-source).
Por exemplo, [Trecho](#span).

### **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)

### **gRPC**

Um framework [RPC](#rpc) de alta performance e open source. Mais sobre gRPC
[aqui](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 [mais informações][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).

### **OpenCensus**

Um conjunto de bibliotecas para várias linguagens que permite coletar métricas
de aplicações e rastreamentos distribuídos, transferindo os dados para um
backend de sua preferência em tempo real.
[Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). Consulte
[mais informações][opencensus].

### **OpenTracing**

APIs e instrumentações neutras em relação a fornecedores de rastreamento
distribuído. [Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history).
Consulte [mais informações][opentracing].

### **OT**

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

### **OTel**

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

### **OTelCol**

Abreviação para [OpenTelemetry Collector](#collector).

### **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 [mais
informações][propagators].

### **Proto**

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

### **Rastreador** {#tracer}

Responsável pela criação de [Trecho](#span). Consulte [mais
informações][tracer].

### **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 [mais informações][trace].

### **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 [mais informações][receiver].

### **Recurso** {#resource}

Captura informações sobre a entidade que produz dados telemétricos como
[Atributos](#attribute). 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** {#log-record}

Uma gravação de um [Evento](#event). Normalmente, o registro inclui um carimbo
de data/hora indicando quando o [Evento](#event) ocorreu, além de outros dados
que descrevem o que aconteceu, onde aconteceu, e assim por diante. Consulte
[mais informações][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). Mais sobre Sinais
[aqui][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 [mais informações][status].

### **Tag**

Consulte [Metadados](#metadata).

### **Transação** {#transaction}

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

### **Trecho** {#span}

Representa uma única operação dentro de um [Rastro](#trace). Consulte mais
detalhes [aqui][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 [mais
informações][zpages].

[baggage]: /docs/specs/otel/baggage/api/
[attribute]: /docs/specs/otel/common/#attributes
[collector]: /docs/collector
[context propagation]: /docs/specs/otel/overview#context-propagation
[dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph
[distributed tracing]: /docs/concepts/signals/traces/
[distribution]: /docs/concepts/distributions/
[field]: /docs/specs/otel/logs/data-model#field-kinds
[http]: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
[json]: https://en.wikipedia.org/wiki/JSON
[log]: /docs/specs/otel/glossary#log
[log record]: /docs/specs/otel/glossary#log-record
[metric]: /docs/concepts/signals/metrics/
[opencensus]: https://opencensus.io
[opentracing]: https://opentracing.io
[propagators]: /docs/languages/go/instrumentation/#propagators-and-context
[proto]: https://github.com/open-telemetry/opentelemetry-proto
[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]: /docs/concepts/signals/
[span]: /docs/specs/otel/trace/api#span
[spec-instrumentation-lib]: /docs/specs/otel/glossary/#instrumentation-library
[spec-instrumented-lib]: /docs/specs/otel/glossary/#instrumented-library
[specification]: /docs/concepts/components/#specification
[status]: /docs/specs/otel/trace/api#set-status
[trace]: /docs/specs/otel/overview#traces
[tracer]: /docs/specs/otel/trace/api#tracer
[zpages]:
https://github.com/open-telemetry/opentelemetry-specification/blob/main/development/trace/zpages.md

0 comments on commit c5c1d02

Please sign in to comment.