Skip to content

Commit cf8dfc4

Browse files
vitorvascchalin
authored andcommitted
docs: pt location for concepts/instrumentation-scope
1 parent 34d97ae commit cf8dfc4

File tree

2 files changed

+49
-0
lines changed

2 files changed

+49
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: Escopo de instrumentação
3+
weight: 80
4+
default_lang_commit: 2f34c456ab38b4d3502cd07bc36fa1455d4ef875
5+
---
6+
7+
O [Escopo de instrumentação](/docs/specs/otel/glossary/#instrumentation-scope)
8+
representa uma unidade lógica dentro do código da aplicação com a qual a
9+
telemetria emitida pode ser associada.
10+
11+
Os desenvolvedores podem decidir o que denota um escopo de instrumentação
12+
razoável. Por exemplo, é possível selecionar um módulo, um pacote ou uma classe
13+
como o escopo de instrumentação. No caso de uma biblioteca ou um _framework_,
14+
uma abordagem comum é utilizar um identificador como um escopo que seja
15+
exclusivo para aquela biblioteca ou _framework_, como seus respectivos nomes ou
16+
versões. Caso a própria biblioteca não possua instrumentação OpenTelemetry
17+
incorporada, e uma biblioteca de instrumentação esteja sendo utilizada em seu
18+
lugar, utilize a combinação do nome e a versão da biblioteca de instrumentação
19+
como o escopo de instrumentação.
20+
21+
O escopo de instrumentação é definido por uma combinação do par entre nome e
22+
versão quando uma instância do _Tracer_, _Meter_ ou _Logger_ são obtidos de um
23+
_Provider_. Cada registro de Trecho, Métrica ou Log criados por esta instância
24+
serão então associados ao escopo de instrumentação fornecido.
25+
26+
No seu backend de observabilidade, a utilização de escopos permite que os dados
27+
de telemetria sejam analisados de maneira agrupada, por exemplo, para ver quais
28+
de seus usuários estão utilizando uma versão específica de uma biblioteca, ou
29+
até mesmo para identificar um determinado problema em um módulo específico da
30+
sua aplicação.
31+
32+
O diagrama a seguir ilustra um Rastro com múltiplos escopos de instrumentação.
33+
Os diferentes escopos são representados por diferentes cores:
34+
35+
- No topo, o trecho `/api/placeOrder` é criado através do _framework_ do
36+
servidor HTTP.
37+
- Os trechos em verde (`CheckoutService::placeOrder`, `prepareOrderItems` e
38+
`checkout`) são códigos da aplicação, agrupados através da classe
39+
`CheckoutService`.
40+
- Os trechos em `CartService::getCart` e `ProductService::getProduct` também são
41+
códigos da aplicação, agrupados através das classes `CartService` e
42+
`ProductService`.
43+
- Os trechos em laranja (`Cache::find`) e azul claro (`DB::query`) são códigos
44+
de biblioteca, agrupados através dos respectivos nomes e versões de cada.
45+
46+
![This image illustrates a trace with multiple instrumentation scopes](spans-with-instrumentation-scope.svg)

content/pt/docs/concepts/instrumentation-scope/spans-with-instrumentation-scope.svg

+3
Loading

0 commit comments

Comments
 (0)