-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[pt] Translate concepts/instrumentation-scope (#5604)
Co-authored-by: Marylia Gutierrez <[email protected]> Co-authored-by: opentelemetrybot <[email protected]> Co-authored-by: Edson Ferreira <[email protected]>
- Loading branch information
1 parent
be892db
commit 0cd508c
Showing
1 changed file
with
46 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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) |