[pt] Translate concepts/instrumentation-scope

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 um identificador como um escopo que seja
+exclusivo para aquela biblioteca ou _framework_, como seus respectivos nomes ou
+versões. Caso a própria biblioteca 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 uma versão específica de uma biblioteca, 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.
+
+![This image illustrates a trace with multiple instrumentation scopes](spans-with-instrumentation-scope.svg)