From 0cd508c4e19843efa62e742b49941b93d8826110 Mon Sep 17 00:00:00 2001 From: Vitor Vasconcellos Date: Mon, 9 Dec 2024 04:50:14 -0300 Subject: [PATCH] [pt] Translate concepts/instrumentation-scope (#5604) Co-authored-by: Marylia Gutierrez Co-authored-by: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Co-authored-by: Edson Ferreira --- .../concepts/instrumentation-scope/index.md | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 content/pt/docs/concepts/instrumentation-scope/index.md diff --git a/content/pt/docs/concepts/instrumentation-scope/index.md b/content/pt/docs/concepts/instrumentation-scope/index.md new file mode 100644 index 000000000000..127aafcfccb3 --- /dev/null +++ b/content/pt/docs/concepts/instrumentation-scope/index.md @@ -0,0 +1,46 @@ +--- +title: Escopo de instrumentação +weight: 80 +default_lang_commit: 2f34c456ab38b4d3502cd07bc36fa1455d4ef875 +--- + +O [escopo de instrumentação](/docs/specs/otel/glossary/#instrumentation-scope) +representa uma unidade lógica dentro do código da aplicação com a qual a +telemetria emitida pode ser associada. + +Os desenvolvedores podem decidir o que denota um escopo de instrumentação +razoável. Por exemplo, é possível selecionar um módulo, um pacote ou uma classe +como o escopo de instrumentação. No caso de uma biblioteca ou um _framework_, +uma abordagem comum é utilizar como escopo um identificador que seja exclusivo +para aquela biblioteca ou _framework_, como seu respectivo nome e versão. Caso a +biblioteca em si não possua instrumentação OpenTelemetry incorporada, e uma +biblioteca de instrumentação esteja sendo utilizada em seu lugar, utilize a +combinação do nome e a versão da biblioteca de instrumentação como o escopo de +instrumentação. + +O escopo de instrumentação é definido por uma combinação do par entre nome e +versão quando uma instância do _tracer_, _meter_ ou _logger_ são obtidos de um +_provider_. Cada registro de trecho, métrica ou log criados por esta instância +serão então associados ao escopo de instrumentação fornecido. + +No seu backend de observabilidade, a utilização de escopos permite que os dados +de telemetria sejam analisados de maneira agrupada, por exemplo, para ver quais +de seus usuários estão utilizando quais versões de uma biblioteca e qual a +performance destas versões, ou até mesmo para identificar um determinado +problema em um módulo específico da sua aplicação. + +O diagrama a seguir ilustra um rastro com múltiplos escopos de instrumentação. +Os diferentes escopos são representados por diferentes cores: + +- No topo, o trecho `/api/placeOrder` é criado através do _framework_ do + servidor HTTP. +- Os trechos em verde (`CheckoutService::placeOrder`, `prepareOrderItems` e + `checkout`) são códigos da aplicação, agrupados através da classe + `CheckoutService`. +- Os trechos em `CartService::getCart` e `ProductService::getProduct` também são + códigos da aplicação, agrupados através das classes `CartService` e + `ProductService`. +- Os trechos em laranja (`Cache::find`) e azul claro (`DB::query`) são códigos + de biblioteca, agrupados através dos respectivos nomes e versões de cada. + +![Esta imagem ilustra um rastro com múltiplos escopos de instrumentação](spans-with-instrumentation-scope.svg)