Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[pt] Add translations for /pt/docs/concepts/glossary #5183

Merged
merged 31 commits into from
Oct 10, 2024
Merged
Show file tree
Hide file tree
Changes from 30 commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
a1600fa
(wip) pt - glossary
vitorvasc Sep 11, 2024
4bdb084
Update content/pt/docs/concepts/glossary.md
vitorvasc Sep 11, 2024
fbab9b8
Update content/pt/docs/concepts/glossary.md
vitorvasc Sep 11, 2024
511af36
Update content/pt/docs/concepts/glossary.md
vitorvasc Sep 11, 2024
6b73b97
Update content/pt/docs/concepts/glossary.md
vitorvasc Sep 11, 2024
0d7444a
Merge branch 'main' into ptbr_translate_glossary
vitorvasc Sep 27, 2024
4af07a9
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 2, 2024
bfe12aa
feat: add complete translations for the glossary
vitorvasc Oct 2, 2024
78c78ef
style: run linter
vitorvasc Oct 2, 2024
6445567
Merge branch 'main' into ptbr_translate_glossary
vitorvasc Oct 2, 2024
8fc7a79
chore: order headings alphabetically
vitorvasc Oct 2, 2024
1ddefee
style: fix typo for baggage
vitorvasc Oct 2, 2024
759785d
style: fix typo
vitorvasc Oct 2, 2024
c015f3b
chore: add word to spell check
vitorvasc Oct 2, 2024
093ce78
fix: broken link references
vitorvasc Oct 2, 2024
f29775c
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
a49faf9
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
da1c50e
fix: change used term for 'denota'
vitorvasc Oct 3, 2024
8d122dd
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
3afe092
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
db823f9
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
ce84c81
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
a2e1cd6
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
ac41b77
Update content/pt/docs/concepts/glossary.md
vitorvasc Oct 3, 2024
17c8e23
Merge branch 'main' into ptbr_translate_glossary
vitorvasc Oct 3, 2024
d9e6f13
fix: broken link references
vitorvasc Oct 3, 2024
9b8e318
style: run linter
vitorvasc Oct 3, 2024
f7b4f21
Merge branch 'main' into ptbr_translate_glossary
vitorvasc Oct 3, 2024
997cbb3
Merge branch 'main' into ptbr_translate_glossary
emdneto Oct 9, 2024
7ffd062
Merge branch 'main' into ptbr_translate_glossary
vitorvasc Oct 10, 2024
3632b5d
docs: Update DAG translation, using portuguese wording
vitorvasc Oct 10, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.
vitorvasc marked this conversation as resolved.
Show resolved Hide resolved

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

[Directed Acyclic Graph][dag].
maryliag marked this conversation as resolved.
Show resolved Hide resolved

### **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**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aqui é uma feature da api e sdk, deixaria sem tradução.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@EzzioMoreira Neste caso, você se refere a mantermos o termo Span link, certo?


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