Skip to content

Commit c5c1d02

Browse files
vitorvascmaryliagEzzioMoreiraemdneto
authored
[pt] Add translations for /pt/docs/concepts/glossary (#5183)
Co-authored-by: Marylia Gutierrez <[email protected]> Co-authored-by: Ezzio Moreira <[email protected]> Co-authored-by: Emídio Neto <[email protected]>
1 parent 5e2a0b4 commit c5c1d02

File tree

2 files changed

+389
-1
lines changed

2 files changed

+389
-1
lines changed

.cspell/pt-palavras.txt

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
desserializa
2+
desserializar
23
autoinstrumentação
34
autoconsistentes
45
serialização
5-
verbosidade
6+
verbosidade

content/pt/docs/concepts/glossary.md

+387
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,387 @@
1+
---
2+
title: Glossário
3+
description: >-
4+
Terminologias utilizadas pelo projeto OpenTelemetry que você pode ou não estar
5+
familiarizado.
6+
weight: 200
7+
default_lang_commit: 926e23631291ed0ba85563cdaf344a134d0edd8d
8+
---
9+
10+
O projeto OpenTelemetry usa terminologias que você talvez não conheça. Além
11+
disso, o projeto também define algumas terminologias de uma maneira diferente de
12+
outros lugares. Esta página reúne as terminologias utilizadas no projeto e seus
13+
respectivos significados.
14+
15+
## Terminologia Genérica {#generic-terminology}
16+
17+
### **Agregação** {#aggregation}
18+
19+
O processo de combinar múltiplas medições em estatísticas exatas ou estimadas
20+
sobre as medições que aconteceram durante um intervalo de tempo, durante a
21+
execução do programa. Utilizado pela [Fonte de Dados](#data-source) de uma
22+
[Métrica](#metric).
23+
24+
### **Amostragem** {#sampling}
25+
26+
Um mecanismo para controlar a quantidade de dados exportados. Usado mais
27+
comumente com a [Fonte de Dados](#data-source) de [Rastros](#trace). Consulte
28+
[mais informações][sampling].
29+
30+
### **API**
31+
32+
Interface de Programação de Aplicações (_Application Programming Interface_). No
33+
projeto OpenTelemetry, é utilizada para definir como os dados de telemetria são
34+
gerados pela [Fonte de Dados](#data-source).
35+
36+
### **Aplicação** {#application}
37+
38+
Um ou mais [Serviços](#service) destinados a usuários finais ou outras
39+
aplicações.
40+
41+
### **Aplicação lado do cliente** {#client-side-app}
42+
43+
Um componente de uma [Aplicação](#application) que não está sendo executado
44+
dentro de uma infraestrutura privada e é normalmente usado diretamente por
45+
usuários finais. Exemplos de aplicações client-side incluem aplicativos de
46+
navegador, aplicativos móveis e aplicativos executados em dispositivos IoT.
47+
48+
### **APM**
49+
50+
O Monitoramento de Desempenho de Aplicações (_Application Performance
51+
Monitoring_) envolve monitorar aplicações de software, sua performance
52+
(velocidade, confiabilidade, disponibilidade, etc.) para detectar problemas,
53+
alertar e fornecer ferramentas que permitam encontrar a causa raiz.
54+
55+
### **Atributo** {#attribute}
56+
57+
Termo do OpenTelemetry para [Metadados](#metadata). Adiciona informações
58+
chave-valor à entidade que está produzindo telemetria. Usado em
59+
[Sinais](#signal) e [Recursos](#resource). Consulte a [especificação de
60+
atributos][attribute].
61+
62+
### **Bagagem** {#baggage}
63+
64+
Um mecanismo para propagar [Metadados](#metadata) para ajudar a estabelecer uma
65+
relação casual entre eventos e serviços. Consulte as [especificações de
66+
Bagagem][baggage].
67+
68+
### **Biblioteca** {#library}
69+
70+
Uma coleção específica da linguagem com comportamento invocado por uma
71+
interface.
72+
73+
### **Biblioteca de cliente** {#client-library}
74+
75+
Consulte a seção [Biblioteca instrumentada](#instrumented-library).
76+
77+
### **Biblioteca de instrumentação** {#instrumentation-library}
78+
79+
Indica a [Biblioteca](#library) que fornece a instrumentação para uma
80+
determinada [Biblioteca instrumentada](#instrumented-library). A
81+
[Biblioteca instrumentada](#instrumented-library) e a
82+
[Biblioteca de instrumentação](#instrumentation-library) podem ser a mesma
83+
[Biblioteca](#library) caso esta possua instrumentação OpenTelemetry
84+
incorporada. Consulte [a especificação da biblioteca][spec-instrumentation-lib].
85+
86+
### **Biblioteca instrumentada** {#instrumented-library}
87+
88+
Indica a [Biblioteca](#library) para a qual os sinais telemétricos
89+
([Rastros](#trace), [Métricas](#metric), [Logs](#log)) são coletados. Consulte
90+
[mais informações][spec-instrumented-lib].
91+
92+
### **Campo** {#field}
93+
94+
Um termo utilizado especificamente por [Registros de Log](#log-record).
95+
[Metadados](#metadata) podem ser adicionados por meio de campos definidos,
96+
incluindo [Atributos](#attribute) e [Recursos](#resource). Outros campos também
97+
podem ser considerados `Metadados`, incluindo severidade e informações de
98+
rastreamento. Consulte a [especificação de campos][field].
99+
100+
### **Collector**
101+
102+
Uma implementação neutra em relação a fornecedores sobre como receber, processar
103+
e exportar dados de telemetria. Um único binário que pode ser implementado como
104+
um agente ou gateway.
105+
106+
Também conhecido como OpenTelemetry Collector. Mais detalhes sobre o Collector
107+
podem ser encontrados [aqui][collector].
108+
109+
### **Contrib**
110+
111+
Diversas [Bibliotecas Instrumentadas](#instrumentation-library) e o
112+
[Collector](#collector) oferecem um conjunto de funcionalidades principais,
113+
assim como um repositório contrib dedicado para funcionalidades não essenciais,
114+
incluindo `Exporters` de fornecedores.
115+
116+
### **Convenções semânticas** {#semantic-conventions}
117+
118+
Define nomes e valores padrão de [Metadados](#metadata) para fornecer dados
119+
telemétricos neutros em relação a fornecedores.
120+
121+
### **DAG**
122+
123+
[Grafos acíclicos dirigidos][dag].
124+
125+
### **Dimensão** {#dimension}
126+
127+
Termo utilizado especialmente por [Métricas](#metric). Consulte
128+
[Atributo](#attribute).
129+
130+
### **Distribuição** {#distribution}
131+
132+
Uma distribuição é um encapsulamento em torno de um repositório upstream do
133+
OpenTelemetry com algumas personalizações. Consulte [mais
134+
detalhes][distribution].
135+
136+
### **Especificação** {#specification}
137+
138+
Descreve os requisitos e expectativas para implementações em todas as
139+
linguagens. Consulte [mais informações][specification].
140+
141+
### **Evento** {#event}
142+
143+
Algo que aconteceu cuja representação depende da [Fonte de dados](#data-source).
144+
Por exemplo, [Trecho](#span).
145+
146+
### **Exporter**
147+
148+
Fornece funcionalidades para emitir dados telemétricos aos consumidores.
149+
Exporters podem ser push-based ou pull-based.
150+
151+
### **Fonte de dados** {#data-source}
152+
153+
Veja [Sinal](#signal)
154+
155+
### **gRPC**
156+
157+
Um framework [RPC](#rpc) de alta performance e open source. Mais sobre gRPC
158+
[aqui](https://grpc.io).
159+
160+
### **HTTP**
161+
162+
Abreviação para [Hypertext Transfer Protocol][http].
163+
164+
### **Instrumentação automática** {#automatic-instrumentation}
165+
166+
Refere-se a métodos de coleta de telemetria que não exigem que o usuário final
167+
modifique o código-fonte da aplicação. Os métodos variam conforme a linguagem de
168+
programação e os exemplos incluem injeção de _bytecode_ ou _monkey patching_.
169+
170+
### **JSON**
171+
172+
Abreviação para [JavaScript Object Notation][json].
173+
174+
### **Linguagem**
175+
176+
Linguagem de programação.
177+
178+
### **Log**
179+
180+
Às vezes usado para se referir a uma coleção de [Registros de Log](#log-record).
181+
Pode ser ambíguo, uma vez que as pessoas também costumam usar [Log](#log) para
182+
se referir a um único [Registro de Log](#log-record). Quando a ambiguidade é
183+
possível, utilize qualificadores adicionais, por exemplo, `Registro de Log`.
184+
Consulte [mais informações][log].
185+
186+
### **Metadados** {#metadata}
187+
188+
Um par de chave-valor, por exemplo, `foo="bar"`, adicionado a uma entidade que
189+
produz dados telemétricos. O OpenTelemetry chama esses pares de
190+
[Atributos](#attribute). Além disso, as [Métricas](#metric) têm
191+
[Dimensões](#dimension) e [Rótulos](#label), enquanto os [Logs](#log) têm
192+
[Campos](#field).
193+
194+
### **Métrica** {#metric}
195+
196+
Registra um ponto de dados, seja medições brutas ou agregações pré-definidas,
197+
como séries temporais com [Metadados](#metadata). Consulte [mais
198+
informações][metric].
199+
200+
### **OC**
201+
202+
Abreviação para [OpenCensus](#opencensus).
203+
204+
### **OpenCensus**
205+
206+
Um conjunto de bibliotecas para várias linguagens que permite coletar métricas
207+
de aplicações e rastreamentos distribuídos, transferindo os dados para um
208+
backend de sua preferência em tempo real.
209+
[Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). Consulte
210+
[mais informações][opencensus].
211+
212+
### **OpenTracing**
213+
214+
APIs e instrumentações neutras em relação a fornecedores de rastreamento
215+
distribuído. [Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history).
216+
Consulte [mais informações][opentracing].
217+
218+
### **OT**
219+
220+
Abreviação para [OpenTracing](#opentracing).
221+
222+
### **OTel**
223+
224+
Abreviação para [OpenTelemetry](/docs/what-is-opentelemetry/).
225+
226+
### **OTelCol**
227+
228+
Abreviação para [OpenTelemetry Collector](#collector).
229+
230+
### **OTLP**
231+
232+
Abreviação para [OpenTelemetry Protocol](/docs/specs/otlp/).
233+
234+
### **Propagação de Contexto** {#context-propagation}
235+
236+
Permite que todas as [Fontes de dados](#data-source) compartilhem um mecanismo
237+
subjacente de contexto para armazenar um estado e acessar dados ao longo do
238+
ciclo de vida de uma [Transação](#transaction). Consulte a [especificação de
239+
propagação de contexto][context propagation].
240+
241+
### **Propagators**
242+
243+
Usado para serializar e desserializar partes específicas de dados telemétricos,
244+
como contexto de span e [bagagem](#baggage) em [Spans](#span). Consulte [mais
245+
informações][propagators].
246+
247+
### **Proto**
248+
249+
Tipos de interface independentes de linguagem. Consulte [mais
250+
informações][proto].
251+
252+
### **Rastreador** {#tracer}
253+
254+
Responsável pela criação de [Trecho](#span). Consulte [mais
255+
informações][tracer].
256+
257+
### **Rastro** {#trace}
258+
259+
Um [DAG](#dag) de [Trechos](#span), onde os limites entre os [Trechos](#span)
260+
são definidos como uma relação de pai-filho. Consulte [mais informações][trace].
261+
262+
### **Rastro distribuído** {#distributed-tracing}
263+
264+
Acompanha a progressão de uma única [Requisição](#request), chamada de
265+
[Rastro](#trace), conforme é processada pelos [Serviços](#service) que compõem
266+
uma [Aplicação](#application). Um [Rastro distribuído](#distributed-tracing)
267+
atravessa limites de processo, rede e segurança.
268+
269+
Consulte [Rastreamento distribuído][distributed tracing].
270+
271+
### **Receiver**
272+
273+
Termo utilizado pelo [Collector](/docs/collector/configuration/#receivers) para
274+
definir como os dados telemétricos são recebidos. Receivers podem ser push-based
275+
ou pull-based. Consulte [mais informações][receiver].
276+
277+
### **Recurso** {#resource}
278+
279+
Captura informações sobre a entidade que produz dados telemétricos como
280+
[Atributos](#attribute). Por exemplo, um processo que gera telemetria e está
281+
sendo executado em um contêiner no Kubernetes possui um nome de processo, um
282+
nome de pod, um namespace e, possivelmente, um nome de deployment. Todos esses
283+
atributos podem ser incluídos no `Recurso`.
284+
285+
### **Registro de log** {#log-record}
286+
287+
Uma gravação de um [Evento](#event). Normalmente, o registro inclui um carimbo
288+
de data/hora indicando quando o [Evento](#event) ocorreu, além de outros dados
289+
que descrevem o que aconteceu, onde aconteceu, e assim por diante. Consulte
290+
[mais informações][log record].
291+
292+
### **REST**
293+
294+
Abreviação para [Representational State Transfer][rest].
295+
296+
### **Requisição** {#request}
297+
298+
Veja [Rastro distribuído](#distributed-tracing).
299+
300+
### **Rótulo** {#label}
301+
302+
Um termo utilizado especificamente por [Métricas](#metric). Veja
303+
[Metadados](#metadata).
304+
305+
### **RPC**
306+
307+
Abreviação para [Remote Procedure Call][rpc].
308+
309+
### **SDK**
310+
311+
Abreviação para Software Development Kit. Refere-se a um SDK de telemetria que
312+
indica uma [Biblioteca](#library) que implementa a [API](#api) do OpenTelemetry.
313+
314+
### **Serviço** {#service}
315+
316+
Um componente de uma [Aplicação](#application). Múltiplas instâncias de um
317+
[Serviço](#service) são tipicamente implantadas para que tenham alta
318+
disponibilidade e escalabilidade. Um [Serviço](#service) pode ser implantado em
319+
múltiplas localizações.
320+
321+
### **Sinal** {#signal}
322+
323+
Um dos [Rastros](#trace), [Métricas](#metric) ou [Logs](#log). Mais sobre Sinais
324+
[aqui][signals].
325+
326+
### **Span link**
327+
328+
Um span link é uma conexão entre spans relacionados casualmente. Para detalhes,
329+
consulte [Links entre spans](/docs/specs/otel/overview#links-between-spans) e
330+
[Especificando Links](/docs/specs/otel/trace/api#specifying-links).
331+
332+
### **Status**
333+
334+
O resultado de uma operação. Normalmente usado para indicar se ocorreu um erro.
335+
Consulte [mais informações][status].
336+
337+
### **Tag**
338+
339+
Consulte [Metadados](#metadata).
340+
341+
### **Transação** {#transaction}
342+
343+
Consulte [Rastro distribuído](#distributed-tracing).
344+
345+
### **Trecho** {#span}
346+
347+
Representa uma única operação dentro de um [Rastro](#trace). Consulte mais
348+
detalhes [aqui][span].
349+
350+
### **zPages**
351+
352+
Uma alternativa interna aos exportadores externos. Quando incluídos, eles
353+
coletam e agregam informações de rastros e métricas em segundo plano; estes
354+
dados são exibidos em páginas da web quando solicitados. Consulte [mais
355+
informações][zpages].
356+
357+
[baggage]: /docs/specs/otel/baggage/api/
358+
[attribute]: /docs/specs/otel/common/#attributes
359+
[collector]: /docs/collector
360+
[context propagation]: /docs/specs/otel/overview#context-propagation
361+
[dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph
362+
[distributed tracing]: /docs/concepts/signals/traces/
363+
[distribution]: /docs/concepts/distributions/
364+
[field]: /docs/specs/otel/logs/data-model#field-kinds
365+
[http]: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
366+
[json]: https://en.wikipedia.org/wiki/JSON
367+
[log]: /docs/specs/otel/glossary#log
368+
[log record]: /docs/specs/otel/glossary#log-record
369+
[metric]: /docs/concepts/signals/metrics/
370+
[opencensus]: https://opencensus.io
371+
[opentracing]: https://opentracing.io
372+
[propagators]: /docs/languages/go/instrumentation/#propagators-and-context
373+
[proto]: https://github.com/open-telemetry/opentelemetry-proto
374+
[receiver]: /docs/collector/configuration/#receivers
375+
[rest]: https://en.wikipedia.org/wiki/Representational_state_transfer
376+
[rpc]: https://en.wikipedia.org/wiki/Remote_procedure_call
377+
[sampling]: /docs/specs/otel/trace/sdk#sampling
378+
[signals]: /docs/concepts/signals/
379+
[span]: /docs/specs/otel/trace/api#span
380+
[spec-instrumentation-lib]: /docs/specs/otel/glossary/#instrumentation-library
381+
[spec-instrumented-lib]: /docs/specs/otel/glossary/#instrumented-library
382+
[specification]: /docs/concepts/components/#specification
383+
[status]: /docs/specs/otel/trace/api#set-status
384+
[trace]: /docs/specs/otel/overview#traces
385+
[tracer]: /docs/specs/otel/trace/api#tracer
386+
[zpages]:
387+
https://github.com/open-telemetry/opentelemetry-specification/blob/main/development/trace/zpages.md

0 commit comments

Comments
 (0)