Skip to content

Commit

Permalink
[pt] Add translations for /pt/docs/concepts/signals (#5120)
Browse files Browse the repository at this point in the history
Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com>
Co-authored-by: Ezzio Moreira <enzziom@gmail.com>
Co-authored-by: Fabrizio Ferri-Benedetti <fferribenedetti@splunk.com>
  • Loading branch information
4 people authored Sep 8, 2024
1 parent d5252ad commit a8e0c2e
Show file tree
Hide file tree
Showing 2 changed files with 153 additions and 0 deletions.
25 changes: 25 additions & 0 deletions content/pt/docs/concepts/signals/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Sinais
description:
Aprenda sobre as categorias de telemetria suportadas pelo OpenTelemetry
weight: 11
default_lang_commit: 08e13eb62f2869300301670675969be705db59ae
---

O propósito do OpenTelemetry é coletar, processar e exportar **[sinais][]**.
Sinais são dados emitidos que descrevem a atividade subjacente do sistema
operacional e das aplicações que estão sendo executadas em uma plataforma. Um
sinal pode ser algo que você deseja medir em um momento específico, como a
temperatura ou o uso de memória, ou um evento que passa pelos componentes do seu
sistema distribuído e que você gostaria de rastrear. Você pode agrupar
diferentes sinais para observar o funcionamento interno de uma mesma tecnologia
sob diferentes ângulos.

O OpenTelemetry atualmente suporta [rastros](/docs/concepts/signals/traces),
[métricas](/docs/concepts/signals/metrics), [logs](/docs/concepts/signals/logs)
e [bagagem](/docs/concepts/signals/baggage). Eventos são um tipo específico de
log, e o
[perfilamento está sendo trabalhado](https://github.com/open-telemetry/oteps/blob/main/text/profiles/0212-profiling-vision.md)
pelo Grupo de Trabalho de Perfilamento _(Profiling Working Group)_.

[sinais]: /docs/specs/otel/glossary/#signals
128 changes: 128 additions & 0 deletions content/pt/docs/concepts/signals/metrics.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,128 @@
---
title: Métricas
weight: 2
description: Uma medição capturada em tempo de execução.
default_lang_commit: 3446c7ce49a17975b012c302bdd1c89d4902267c
---

Uma métrica é uma medição de um serviço capturada em tempo de execução. O
momento de captura dessas medições é conhecido como evento de métrica, que
consiste não apenas na medição em si, mas também no momento em que ela foi
capturada e os metadados associados.

Métricas de aplicação e de requisição são indicadores importantes de
disponibilidade e desempenho. Métricas personalizadas podem fornecer insights
sobre como os indicadores de disponibilidade impactam a experiência do usuário
ou o negócio. Os dados coletados podem ser usados para alertar sobre uma
interrupção ou desencadear decisões de escalonamento para aumentar
automaticamente uma implantação em caso de alta demanda.

Para entender como as métricas no OpenTelemetry funcionam, vamos analisar uma
lista de componentes que farão parte da instrumentação do nosso código.

## Meter Provider

Um Meter Provider (às vezes chamado de `MeterProvider`) é uma fábrica de
`medidores`. Na maioria das aplicações, um meter provider é inicializado uma vez
e seu ciclo de vida corresponde ao ciclo de vida da aplicação. A inicialização
do meter provider também inclui a inicialização do resource e do exporter. Esse
é tipicamente o primeiro passo para metrificar com o OpenTelemetry. Em alguns
SDKs, um meter provider global já é inicializado para sua aplicação.

## Medidor {#meter}

Um medidor cria [instrumentos de métrica](#metric-instruments), que serão
responsáveis por capturar dados e medir um serviço em tempo de execução.
Métricas são criadas a partir de Meter Providers (Medidores).

## Metric Exporter

Metric Exporters enviam dados de métricas para um consumidor. Esse consumidor
pode ser a saída padrão para depuração durante o desenvolvimento, uma instância
do OpenTelemetry Collector ou qualquer outro backend, seja de código aberto ou
um fornecedor de sua escolha.

## Metric Instruments

Com o OpenTelemetry, as medições são capturadas através de **instrumentos de
métrica**. Um instrumento de métrica é definido por:

- Nome
- Tipo
- Unidade <em>(opcional)</em>
- Descrição <em>(opcional)</em>

O nome, unidade e descrição podem ser escolhidos pelo desenvolvedor ou definidos
através da [convenção semântica](/docs/specs/semconv/general/metrics/) no caso
de métricas comuns, como por exemplo métricas de requisições e processos.

O tipo de instrumento deve ser um dos seguintes:

- **Counter**: Um valor que acumula com o tempo -- você pode imaginar isso como
um odômetro de um carro; é um valor que só cresce.
- **Asynchronous Counter**: Assim como o **Counter**, porém é coletado uma vez a
cada exportação. Pode ser usado em casos onde você não tenha acesso aos
incrementos contínuos, mas apenas ao valor agregado.
- **UpDownCounter**: Um valor que acumula com o tempo, mas também pode cair. Um
exemplo seria o tamanho de uma fila, este valor irá aumentar e diminuir de
acordo com o número de itens que estão entrando ou saindo desta fila.
- **Asynchronous UpDownCounter**: Assim como o **UpDownCounter**, porém é
coletado uma vez a cada exportação. Pode ser usado em casos onde você não
tenha acesso às mudanças contínuas, mas apenas ao valor agregado (ex., atual
tamanho da fila).
- **Gauge**: Mede o valor atual no momento da leitura. Um exemplo seria um
medidor de tanque de combustível de um veículo. Gauges são assíncronos.
- **Histogram**: Uma agregação de valores, tal como latências de requisições. Um
histograma é uma boa escolha se você está interessado em valores de
estatísticas. Por exemplo: Quantas requisições estão levando menos de 1s?

Para visualizar mais instrumentos síncronos, assíncronos, e entender qual dos
tipos melhor se encaixa no seu caso de uso, veja
[Diretrizes Suplementares](/docs/specs/otel/metrics/supplementary-guidelines/).

## Agregação {#aggregation}

Além dos instrumentos de métrica, também é importante entendermos o conceito de
**agregações**. Uma agregação é uma técnica pela qual um grande número de
medições é combinado em estatísticas exatas ou estimadas sobre eventos de
métricas que ocorreram durante uma janela de tempo. O protocolo OTLP transporta
essas métricas agregadas. A API do OpenTelemetry fornece uma agregação padrão
para cada instrumento de medição, que podem ser sobrescritas com o uso de
_Views_. Por padrão, o projeto OpenTelemetry visa fornecer agregações que sejam
suportadas por diferentes visualizadores e backends de telemetria.

Ao contrário dos [rastros](/docs/concepts/signals/traces/), que são destinados a
capturar os ciclos de vida das requisições e fornecer o contexto para as partes
individuais de uma requisição, as métricas são destinadas a fornecer informações
estatísticas em forma de dados agregados. Alguns exemplos de caso de uso para as
métricas incluem:

- Reportar o número total de _bytes_ lidos por um serviço, por tipo de
protocolo.
- Reportar o número total de _bytes_ lidos e os _bytes_ por requisição.
- Reportar a duração de uma chamada de sistema.
- Reportar tamanhos de requisições para determinar uma tendência.
- Reportar o uso de CPU ou memória de um processo.
- Reportar valores médios de saldo de uma conta.
- Reportar o número atual de requisições ativas sendo processadas.

## Views

Uma _view_ oferece aos usuários a flexibilidade de personalizar a emissão das
métricas fornecidas pelo SDK. Você pode personalizar quais instrumentos de
métrica devem ser processados ou ignorados. Você também pode customizar a
agregação e quais atributos deseja reportar em suas métricas.

## Suporte de linguagens de programação {#language-support}

As métricas são sinais
[estáveis](/docs/specs/otel/versioning-and-stability/#stable) nas especificações
do OpenTelemetry. Para uma implementação individual ou específica das Métricas
através do SDK ou API, os status são os seguintes:

{{% signal-support-table "metrics" %}}

## Especificação {#specification}

Para aprender mais sobre as métricas no OpenTelemetry, veja as
[especificações de métricas](/docs/specs/otel/overview/#metric-signal).

0 comments on commit a8e0c2e

Please sign in to comment.