From c5c1d02cdcc9985bac7031d8bf256a67ec20e1b0 Mon Sep 17 00:00:00 2001 From: Vitor Vasconcellos Date: Thu, 10 Oct 2024 11:17:57 -0300 Subject: [PATCH 1/2] [pt] Add translations for /pt/docs/concepts/glossary (#5183) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Marylia Gutierrez Co-authored-by: Ezzio Moreira Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com> --- .cspell/pt-palavras.txt | 3 +- content/pt/docs/concepts/glossary.md | 387 +++++++++++++++++++++++++++ 2 files changed, 389 insertions(+), 1 deletion(-) create mode 100644 content/pt/docs/concepts/glossary.md diff --git a/.cspell/pt-palavras.txt b/.cspell/pt-palavras.txt index 9d49db969e23..cf5f99edc85c 100644 --- a/.cspell/pt-palavras.txt +++ b/.cspell/pt-palavras.txt @@ -1,5 +1,6 @@ desserializa +desserializar autoinstrumentação autoconsistentes serialização -verbosidade +verbosidade \ No newline at end of file diff --git a/content/pt/docs/concepts/glossary.md b/content/pt/docs/concepts/glossary.md new file mode 100644 index 000000000000..b9348316ba47 --- /dev/null +++ b/content/pt/docs/concepts/glossary.md @@ -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 From 70941081ce29d75426e3ef4b387ade372b8805cc Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Thu, 10 Oct 2024 09:41:37 -0500 Subject: [PATCH 2/2] Update opentelemetry-specification version to v1.38.0 (#5375) --- .gitmodules | 2 +- content-modules/opentelemetry-specification | 2 +- scripts/content-modules/adjust-pages.pl | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.gitmodules b/.gitmodules index 7b09698090c3..b3e0735ae018 100644 --- a/.gitmodules +++ b/.gitmodules @@ -7,7 +7,7 @@ [submodule "content-modules/opentelemetry-specification"] path = content-modules/opentelemetry-specification url = https://github.com/open-telemetry/opentelemetry-specification.git - spec-pin = v1.37.0 + spec-pin = v1.38.0 [submodule "content-modules/community"] path = content-modules/community url = https://github.com/open-telemetry/community diff --git a/content-modules/opentelemetry-specification b/content-modules/opentelemetry-specification index 45dea75ad8d1..0a78571045ca 160000 --- a/content-modules/opentelemetry-specification +++ b/content-modules/opentelemetry-specification @@ -1 +1 @@ -Subproject commit 45dea75ad8d16f9a0ed8a752d968a4e810e64d64 +Subproject commit 0a78571045ca1dca48621c9648ec3c832c3c541c diff --git a/scripts/content-modules/adjust-pages.pl b/scripts/content-modules/adjust-pages.pl index 2a14de131375..c0d7fc219dc5 100755 --- a/scripts/content-modules/adjust-pages.pl +++ b/scripts/content-modules/adjust-pages.pl @@ -18,7 +18,7 @@ my $semConvRef = "$otelSpecRepoUrl/blob/main/semantic_conventions/README.md"; my $specBasePath = '/docs/specs'; my %versions = qw( - spec: 1.37.0 + spec: 1.38.0 otlp: 1.3.2 semconv: 1.28.0 );